Claude Code 上手教程

一、Claude Code 有两种用法

Claude Code 是 Anthropic 推出的 AI 编程助手：你把一个文件夹交给它，它能读文件、改文件、运行命令，并把改动摆给你检查，而不是只给你一段代码让你自己复制。现在你可以用两种方式使用它：

两种方式可以对同一个项目文件夹交替使用。不知道选哪个：没用过终端就选桌面版；想接国内模型、已经会用命令行就选命令行版。

读完这篇，你能做到：

1. 装好桌面版或命令行版，登录，完成第一个任务；

2. 看懂它每次弹出的确认和权限模式，学会检查改动、撤回改动；

3. 在没有 Claude 账号时，用 CC Switch 把 Claude Code 接到国内厂商的模型上；

4. 遇到最常见的几个问题时，知道从哪里查起。

需要准备：

二、桌面版：从安装到完成第一个任务

2.1 下载与登录

1. 到官方文档页点「Download for macOS」或「Download for Windows」，下载地址的域名是 claude.ai；Windows ARM 设备选 ARM64 安装包。只从官方页面下载，不要从网盘、群文件或第三方站点获取安装包；

2. 运行安装包，从「应用程序」（macOS）或开始菜单（Windows）打开 Claude，用你的 Anthropic 账号登录；

3. 点窗口顶部的 Code 页签。如果点了弹出升级提示，说明当前账号的套餐不含 Claude Code；如果提示在线登录，完成登录后重启应用。

桌面应用里已经自带 Claude Code，不需要另外装 Node.js 或命令行工具。

桌面应用有几个页签：聊天（Chat）用来普通对话，没有文件访问权限；Code 是围着一个项目文件夹干活的工作台，它在你选的文件夹里读文件、改文件，每一处改动你都看得到，改错了还能撤回。本文只讲 Code。

2.2 认识 Code 界面

选好项目文件夹之后，Code 页面分成四块：

• 左边栏：管理所有任务。「New session」新开一个任务（每个 session 有自己的聊天记录和上下文，可以同时开好几个，做完会弹系统通知）；「Customize」里统一管理插件、Skills、连接器；

• 中间对话区：它读了哪些文件、改了什么、跑了什么命令，都实时显示在这里。它干活的时候你也能插话：输入修改意见按回车，它做完手上这一步就会照着改；想让它马上停下，点停止按钮；

• 输入栏：开工前要设好的东西都在这一圈（见下）；

• 右侧面板：从工具栏的 Views 菜单打开，可以摆放「改动对比」「浏览器」（预览它做出来的网页、图片、PDF）「终端」「文件」几个面板。

输入栏上要认识的几样：

在输入框里打 / 会弹出斜杠命令列表，打 @ 加文件名可以把某个文件单独点名给它看。快捷键常用的有两个：Ctrl+N 新开一个 session，Ctrl+; 在旁边开一个小对话问问题（macOS 把 Ctrl 换成 Cmd）。

权限模式：新手最需要理解的一件事。 按官方文档，桌面版有四种：

设置里还有一个「允许跳过权限」（Bypass permissions）的开关，默认是关的，新手保持关闭。

2.3 第一个任务：整理一个练习文件夹

第 1 步：准备练习文件夹。 新建一个叫「练手」的文件夹，从你电脑里复制几张图片和几份文档放进去（复制一份，不要放原件）。

第 2 步：选好三样东西。

• 环境选 Local；

• 点 Select folder，选中「练手」文件夹；

• 权限模式选 Manual。

第 3 步：发第一句话。 把下面这句话复制进输入栏，按回车：

看一下这个文件夹里有哪些文件，按类型分到不同的子文件夹里，文件名统一改成「日期-内容」的格式。最后生成一个「目录.md」，列出每个文件是干嘛的。

第 4 步：它问你的时候怎么点。 因为选了 Manual，它每改一处都会停下来，告诉你它准备改什么，下面有接受（Accept）和拒绝（Reject）两个按钮：看一眼没问题就点接受；觉得不对点拒绝，它会问你想怎么改。你点接受之前，文件不会被动。

第 5 步：看它改了什么。 改完之后会出现一个类似 +12 -0 的数字，意思是加了 12 行、删了 0 行，点开就是改动对比：左边列出改过的文件，右边能看到具体是哪几行，绿色是新加的。某一行不满意，可以在那一行写上意见发给它，它会照着你的批注再改一版。整体不满意也不用新开 session，在当前对话里接着说，比如「目录里每个文件再加一句用途说明」。

回到「练手」文件夹看一眼，文件真的被分好了。

第 6 步：让它自己检查一遍。 它有时做完就停了，漏掉的地方自己不知道。再发一句：

检查一遍你刚才做的：文件是不是都分好了、有没有漏掉的、目录.md 里写的和文件夹里实际的对不对得上。有问题直接改，改完告诉我改了什么。

以后做任何任务，最后都可以加这一句。

什么时候该先用 Plan？ 这次的任务很简单，可以直接做。如果你要做的事比较大，比如做一个小工具、改一整个文件夹的笔记，先切到 Plan 模式，或在输入框打 /plan，把想法一股脑说给它。它会先问你几个问题，再写一份方案；你确认方案没问题了，它才开始动手。做到一半才发现方向不对、只能推倒重来，是最费时间也最费额度的。

2.4 改坏了怎么办：三道保险

1. Manual 模式：你点接受之前文件不会被改；

2. 让它撤回：Claude Code 每次改文件之前，都会先给这个文件存一份快照。改完发现不对，直接说「把刚才的改动撤回」。注意快照只管它用编辑功能改的文件，它运行过的命令、发出去的邮件、调用过的外部服务是撤不回来的，所以这类操作最好在 Manual 模式下自己看一眼再同意；

3. 用 Git 存版本：重要项目让它帮你「提交一个存档」，想退回哪个都行。

2.5 几个容易搞混的概念：规矩、进度、资料、记忆

跑通之后，可以给正式的项目建文件夹了。它只在你选的这个文件夹里干活，你放进去的东西就是它的全部背景资料。

最容易踩的坑，是把进度也写进 CLAUDE.md。CLAUDE.md 每次开工都要整篇读一遍，所以只放不变的规矩；进度每天都在变，单独放进项目文档，再在 CLAUDE.md 里写一句「开工前先读项目文档」。不想自己写，可以让它代劳：在项目里输入 /init，它会扫描项目生成一份 CLAUDE.md。写得短而具体，比写得长更有用。

2.6 对话太长了怎么办

对话越聊越长，它的「工作记忆」会被占满，变慢、变不准。输入栏里的圆环显示当前对话用了多少上下文，也显示你的套餐用量和重置时间。

建议一个任务一个 session：做完一件事，新开一个 session 做下一件；任务进行到一半想压缩，输入 /compact。

三、命令行版：从安装到完成第一个任务

3.1 先认识终端

如果你从没用过终端，这一节请不要跳过。终端就是一个可以用文字下达命令的窗口，安装 Claude Code 的命令就是粘贴进这个窗口运行的。

Windows：

1. 点开始菜单，搜索 PowerShell，选择「Windows PowerShell」打开；

2. 窗口里会出现一行以 PS C:\Users\你的用户名> 开头的文字，这就是提示符，命令要输在它后面；

3. 把命令复制好，在窗口里点右键（或按 Ctrl+V）粘贴，再按回车。

【待补图 11｜Windows 开始菜单搜索 PowerShell，框出「Windows PowerShell」这一项】

macOS：

1. 按 ⌘ + 空格 打开 Spotlight，输入「终端」，回车；

2. 提示符通常以你的用户名和 % 结尾；

3. 粘贴命令用 ⌘ + V，再按回车。

【待补图 12｜macOS 终端窗口，已粘贴一行命令，框出提示符】

有一个容易搞混的地方：PowerShell 和 CMD 是两种不同的窗口。 官方文档的区分方法是看提示符：显示 PS C:\ 的是 PowerShell，只显示 C:\ 没有 PS 的是 CMD。后面的安装命令分别写了两种，用错了会报错（见 3.3 的失败对照表）。

3.2 安装

下面每个系统选一种方式执行即可，不需要全装一遍。官方推荐「原生安装」（Native Install）。

Windows

方式 A：PowerShell 官方脚本（推荐）。在 PowerShell 里执行，不需要管理员权限：

irm https://claude.ai/install.ps1 | iex

方式 B：WinGet。在 PowerShell 里执行：

winget install Anthropic.ClaudeCode

注意两点：命令里是 Anthropic.ClaudeCode，中间没有空格（网上有教程多打了空格，复制出来会失败）；WinGet 装的版本不会自动更新，要定期执行 winget upgrade Anthropic.ClaudeCode。

方式 C：CMD。如果你在 CMD 窗口里，执行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

关于 Git：Windows 上装 Git for Windows 是可选的。装了，Claude Code 会用 Git Bash 执行命令；没装，它改用 PowerShell。新手不装也能用。如果你用 WSL（Windows 里的 Linux 子系统），要在 WSL 的终端里安装和启动，新手没有特殊需要，直接用原生 Windows 方式更简单。

macOS

方式 A：官方脚本（推荐）：

curl -fsSL https://claude.ai/install.sh | bash

方式 B：Homebrew：

brew install --cask claude-code

Homebrew 装的版本同样不会自动更新，要执行 brew upgrade claude-code。

安装后：一定要做的两步检查

第一步：关掉终端，重新打开一个。 安装命令执行时不会显示进度，看起来像卡住了，这是正常的；等回到提示符后，必须新开一个终端窗口，新窗口才能找到 claude 命令。

第二步：检查版本。

claude --version

装好了会输出版本号，后面跟着 (Claude Code)。版本号以你机器上显示的为准。

可选的第三步：执行 claude doctor 体检，它只做只读检查，会报告安装方式、版本、自动更新状态和发现的问题。看到「No installation issues found.」就可以继续了。

【待补图 18｜claude doctor 的输出，框出「No installation issues found.」】

3.3 安装失败了怎么办

不要用 sudo npm install -g 安装。npm 安装只是兼容方式，需要 Node.js 22 及以上：npm install -g @anthropic-ai/claude-code。能用原生安装就不用 npm。更新： 原生安装会在后台自动更新，也可以随时执行 claude update。

3.4 登录

先建一个只用来练习的空文件夹，再在里面启动：

mkdir $HOME\claude-practice
cd $HOME\claude-practice
claude

macOS 用 mkdir ~/claude-practice && cd ~/claude-practice，再输入 claude。

第一次启动，几个提示通常会按下面的顺序出现（不同版本顺序可能不同，按提示操作即可）：

1. 选择终端显示样式：只影响文字颜色，保持默认直接回车；

2. 阅读安全提示：看一遍，按回车继续；

3. 是否信任当前文件夹：这是你刚建的练习文件夹，选 Yes；启动在别的目录里、不确定就选 No 退出；

4. 登录：按提示在浏览器里完成。

【待补图 20｜首次启动时「是否信任当前文件夹」的提示，框出 Yes 选项】

登录时多数情况下浏览器会自动弹出授权页：登录你的 Claude 账号，点击授权，再回到终端；没有自动弹出时，按终端里的提示操作（通常是把终端显示的网址复制到浏览器里打开）。登录成功后，凭据会保存，以后不需要每次登录。

• 输入 /status 可以看到版本、模型和账号信息；想换账号或重新登录，输入 /login；

• 登录失败时按顺序查：浏览器有没有打开授权页 → 授权后终端有没有收到返回 → 账号是不是支持 Claude Code（免费 claude.ai 账号不含，这是新手最常见的原因） → 当前网络和所在地区是否在官方支持范围内 → 执行 claude doctor 看有没有阻塞项。不要一登录失败就去改模型、改配置，先把登录问题和模型问题分开。

3.5 最常用的操作

权限模式和桌面版是同一套：默认每次要修改文件或执行命令都会先问你；按 Shift+Tab 可以在默认、接受编辑（Accept Edits）、计划模式（Plan Mode）之间循环切换，Windows 上没反应可以试 Alt+M。第一次使用请保持默认模式。启动时加 --dangerously-skip-permissions 可以让它完全不问，名字里已写明是危险模式，新手不要使用。

3.6 第一个任务：做一张网页名片

1. 确认位置。 终端提示符所在的文件夹应该是 claude-practice，并且已经执行了 claude，看到输入界面；

2. 先问一个只读的问题。 输入「这个文件夹里现在有什么文件？」，它会读取当前目录并回答。练习文件夹是空的，它会说没有文件。这一步是确认它能正常回应，并且你清楚它在哪个目录工作；

3. 提出任务。 把下面这段话复制进去，按回车：

   text复制

   请在当前文件夹创建一个 hello.html：一张个人名片页面，包含姓名「小明」、一句自我介绍和三个兴趣标签；背景用浅蓝色，内容居中显示。只创建这一个文件，不需要安装任何东西。

4. 看清确认再点。 Claude 会先说明它准备做什么，并显示将要创建的文件，然后询问是否允许。常见的选项有「是」「本次会话内允许所有编辑」「否，并告诉 Claude 怎么改」（实际文字以你屏幕为准）。第一次请选「是」，只批准这一次；

   【待补图 21｜Claude Code 询问是否创建 hello.html 的确认界面，框出选项】

5. 验证结果。 打开练习文件夹，双击 hello.html，浏览器里会显示一张浅蓝色背景的名片；

   【待补图 22｜用浏览器打开 hello.html 的效果】

6. 追问修改。 回到 Claude Code，继续说：「把背景改成淡黄色，再加一个『联系我』按钮，点击后弹出一句问候。」批准后刷新浏览器就能看到变化。第一次结果不完美很正常，把你看到的问题直接说出来，它会据此继续调整；

7. 不满意怎么撤回？ 输入 /rewind，选择回到某一步（输入框为空时连按两次 Esc 也会打开）。可以选择只回滚对话、同时回滚文件改动，或只回滚文件。回滚只能撤销它自己编辑的文件，运行过的命令（比如装了软件）撤不回来，所以重要项目一定要用 Git 管版本；

8. 结束。 输入 /exit 退出。第二天想接着做，在 claude-practice 里执行 claude -c。

四、没有 Claude 账号时：用 CC Switch 接入国内模型

Claude Code 是终端里的程序，「用哪个模型」是配置问题。国内的智谱、月之暗面（Kimi）、DeepSeek、MiniMax、阿里百炼等厂商，都提供了兼容 Claude Code 的接入方式。手动配置要改环境变量，容易出错；CC Switch 是一个开源的桌面小工具，把「选厂商、填 Key、一键切换」做成了图形界面。

先说清楚三件事：

• 这是模型厂商自己提供的兼容接法，不是 Anthropic 官方支持的用法。官方文档明确写了：Anthropic 不支持通过任何网关把 Claude Code 指向非 Claude 模型；

• 接入之后，实际干活的是你选的国内模型，不是 Claude；能力、速度、稳定性和费用，以所选厂商和套餐为准；

• 本文只讲模型厂商自己的官方平台。CC Switch 的预设里还有很多第三方「中转」服务，其中不少带推广，本文不介绍，也不建议你把 Key 交给来路不明的中转站。

4.1 第一步：拿到厂商的 API Key

1. 选一家厂商，到它的官方开放平台注册并实名（各家要求不同），在「API Key」页面新建一个 Key，复制下来；

2. 有的厂商卖「编程套餐」（Coding Plan），这类套餐的 Key 往往只能用在厂商指定的几个工具里，能不能用在 Claude Code 上，以厂商官方说明为准。本站「会员套餐」页标注了每个套餐的使用范围；

3. Key 相当于密码：不要发给别人、不要贴到截图里、不要写进会提交到代码仓库的文件。

4.2 第二步：安装 CC Switch

• 官方网站只有 ccswitch.io（项目说明里明确写了「唯一官方网站」），安装包在它的 GitHub 发布页下载，注意核对发布者是 farion1231；

• Windows：下载 CC-Switch-v版本号-Windows.msi 安装，或下载免安装的 Portable.zip（系统要求 Windows 10 及以上）；

• macOS：执行 brew install --cask cc-switch，或下载 .dmg（同时支持 Apple 芯片和 Intel，系统要求 macOS 12 及以上）；

• 当前最新版本是 v4.0.11（2026-10-13 发布）。

4.3 第三步：添加厂商并启用

1. 打开 CC Switch，在侧边栏选 Claude Code；

2. 点页面右上角的 「＋」（添加供应商），在「预设」里选你的厂商——可以直接搜中文名，比如 DeepSeek、智谱 GLM、Kimi、MiniMax、百炼；

3. 填写 API Key，「请求地址」选了预设后会自动填好，不要随意改；

4. 点「添加」；

5. 回到列表，在刚加的厂商那一行点 「启用」。

按 CC Switch 的说明，Claude Code 支持热切换，切换后不需要重启；保险起见，已经打开的 Claude Code 窗口可以关掉，重新开一个。

4.4 第四步：验证

在练习文件夹里启动 claude。欢迎界面会显示你当前使用的模型名；输入 /status 也能看到。随便问一个问题，能正常回答就说明通了。

4.5 想切回官方登录

在 CC Switch 的 Claude Code 列表里选内置的 Claude Official，点「启用」，重启 Claude Code，再按它自己的流程登录（输入 /login）。之后可以在官方和第三方之间随意切换。

五、接下来学什么

建议按这个顺序，每一步都在练习文件夹里试一遍：

1. 让它认识你的项目：输入 /init 生成 CLAUDE.md，写得短而具体；

2. 学会计划模式：改动大时先切到计划模式，让它出方案，确认再做；

3. 学会用 Git：直接对它说「帮我提交这些改动并写清楚说明」，出问题能回到上一个存档；

4. 再往后：插件与 Skills（把重复的做法存成手册）、外接工具（MCP）、子智能体，放到进阶教程里讲。如果你习惯用编辑器，也可以装 VS Code 里的 Claude Code 扩展。

六、常见问题

桌面版：点 Code 弹出升级提示

桌面版：提示登录或出现 403

桌面版：它改了我不想动的文件

命令行版：装完提示找不到 claude

命令行版：登录后提示没有权限

命令行版：一启动就让它改重要项目

命令行版：对话越聊越慢、越聊越乱

接入国内模型：启动后仍提示未登录

接入国内模型：切换后没有生效

接入国内模型：报模型不存在、鉴权失败或额度不足