Claude Code 保姆级上手教程（2026 版）

这篇按 安装 → 登录配置 → 起项目 → 让 Claude 写代码 → 调试踩坑 → 进阶玩法 的顺序走一遍，跟着抄就能跑通。

0. 先搞清楚：Claude Code 是干嘛的

Claude Code（Anthropic 出的命令行 AI 编程工具）让你在终端里直接指挥 Claude：

读你的项目、改代码
写新功能、修 bug、做重构
帮你跑测试、定位报错
生成脚本、文档、配置

比起网页聊天，它更像一个"能直接动你仓库的 AI 同事"，做真实项目开发明显更顺手。

1. 前置条件（必须先装）

1.1 装 Node.js（必需）

Claude Code 跑在 Node 上，需要 Node 18+（建议直接上 20+ LTS）。

打开官网 https://nodejs.org
下 LTS 版（推荐 20.x LTS）
双击安装包，一路 Next（默认就行）
装完验证，打开 PowerShell（Win + X → Windows PowerShell）输入：

powershell 复制代码

node -v
npm -v

能打印出版本号就成功。

1.2 装 Git（强烈建议）

Claude Code 会用 Git 读项目历史、生成 diff、开 PR。

打开 https://git-scm.com/download/win
下载后一路 Next
验证：

powershell 复制代码

git --version

1.3 终端选哪个（建议 Windows Terminal）

PowerShell、VS Code 内置终端、Git Bash 都能用，但更推荐去 Microsoft Store 装一个 Windows Terminal，体验顺手不少。

2. 安装 Claude Code（Windows）

2.1 npm 全局安装

PowerShell 里执行：

powershell 复制代码

npm install -g @anthropic-ai/claude-code

公司电脑常见的权限报错，两种解法：用管理员身份重开 PowerShell 再装，或者改用 npx 临时跑（见 6.2）。

装好后验证：

powershell 复制代码

claude --version

2.2 npm 太慢就换镜像（可选）

powershell 复制代码

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

装完想换回官方源：

powershell 复制代码

npm config set registry https://registry.npmjs.org

3. 登录 / 配置 API Key

Claude Code 要连一个 Anthropic 接口才能调模型。手上没有合适 Key 的话，可以用 TeamoRouter（https://teamorouter.com）------它兼容 Anthropic 协议，一个 Key 就能调 Claude、GPT、Gemini，按量付费。

3.1 拿一个 API Key

打开 https://teamorouter.com，注册登录
进控制台 → API Keys
点新建，生成一个令牌
复制 Key（形如 sk-xxxxxxxxx）

3.2 在 Windows 设环境变量

PowerShell 里执行（把 Key 换成你自己的）：

powershell 复制代码

$env:ANTHROPIC_BASE_URL = "https://api.teamorouter.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的Key"

几点注意：

用 $env: 这样设，当前窗口立即生效，不必重启
Key 两边别多加空格或多套一层引号

验证一下设没设上：

powershell 复制代码

echo $env:ANTHROPIC_AUTH_TOKEN

能回显你的 Key 就 OK。

嫌每次开窗口都要重设？把这两个值写进 C:\Users\你的用户名\.claude\settings.json 的 env 块，以后启动自动加载：
json 复制代码
{ "env": { "ANTHROPIC_BASE_URL": "https://api.teamorouter.com", "ANTHROPIC_AUTH_TOKEN": "你的Key" } }

4. 第一次运行 Claude Code

先进到你想让它操作的目录，比如你的项目文件夹：

powershell 复制代码

cd D:\projects\my-app

然后启动：

powershell 复制代码

claude

第一次启动它会：

检测当前目录是不是 Git 仓库
问你要不要允许它读写文件
可能让你选一个默认模型

照提示选 yes 就行。

5. 在项目里手把手写代码（核心）

进入交互界面后，体验类似聊天，但需求要描述清楚。

5.1 先让它摸清项目

输入：

复制代码

先快速过一遍项目结构，告诉我技术栈、入口文件和主要模块。

它会自动列目录、读 package.json / README，给你一份结构总结。

5.2 让它写一个功能

需求尽量写明输入、输出、约束，例如：

复制代码

在 React 前端新增一个「用户列表」页面：
- 路由 /users
- 调后端 GET /api/users
- 表格展示 name / email / role
- 失败时弹出 toast
请直接改代码，并告诉我动了哪些文件。

它会读现有路由、组件、请求封装，改完给你 diff 和说明。

5.3 让它修 bug

把报错原样贴上：

复制代码

我运行 npm test 报错如下（贴完整日志），
请定位原因并修复。

它会读测试、找到失败点、改代码，再建议你重跑验证。

5.4 让它重构

例如：

复制代码

src/utils/date.ts 里重复逻辑很多，
帮我重构得更清晰可维护，前提是所有现有单测仍然通过。

6. 常用交互技巧

6.1 用 @ 引用文件 / 目录

复制代码

看一下 @src/app.tsx，帮我加一个 loading 状态。

也可以引用整个目录：

复制代码

扫一遍 @src/components 里的所有组件。

想看改动就说"给我展示 diff"。

6.2 不想全局安装时的临时跑法

powershell 复制代码

npx @anthropic-ai/claude-code

7. Windows 常见坑

7.1 提示 "claude 不是内部命令"

原因是 npm 全局 bin 没进 PATH。

powershell 复制代码

npm config get prefix

把该目录下的 node_modules\.bin 加进系统 PATH
重开终端再试

7.2 请求超时 / 连不上

先确认 ANTHROPIC_BASE_URL 填的就是 https://api.teamorouter.com，没填错
公司网络有时会拦截外部请求，换个网络环境或排查一下防火墙

7.3 读写文件权限不足

用管理员身份开 PowerShell
或者把项目挪到你有完整权限的位置（比如 D 盘的用户目录）

7.4 中文 / 带空格的路径异常

少数工具链对中文目录支持不好。建议把项目放在纯英文路径，例如 D:\projects\my-app。

8. 进阶玩法（真正提效）

8.1 让它先出计划再动手

复制代码

先给我一份分步骤计划，先别改代码。我确认后你再开始。

这样不容易跑偏。

8.2 配合 Git 出 PR

复制代码

按最佳实践新建一个 feature 分支，完成修改后总结变更，并给出 PR 描述。

它会建分支、给 commit 信息建议、输出 PR 模板。

8.3 让它顺手补测试

复制代码

这个功能需要单测覆盖，请补齐并保证通过。

8.4 多任务时列优先级

复制代码

按以下优先级逐项处理，每项先说原因再改代码：
1. 修复登录 bug
2. 重构 auth 模块
3. 补测试

9. 推荐的几个使用习惯

需求写清楚：输入、输出、约束、边界都交代到
先让它理解项目，再让它动手
每次改完自己跑一遍测试
用 Git 记录，方便回滚
大改动先要计划

10. 可以直接照抄的模板指令

模板 1：理解项目

复制代码

你现在在我的项目根目录。
请阅读 README、package.json 和关键入口文件，给出：
- 技术栈
- 目录结构说明
- 我该从哪个入口理解业务

模板 2：加功能

复制代码

需求：......
约束：......
先给实现计划（先别改代码），我确认后你再修改，并展示 diff。

模板 3：修 bug

复制代码

我遇到 bug：......
复现步骤：......
错误日志：......
请定位原因 → 给出修复 → 补测试 → 给出验证方式。

照着走下来，原本要花一两天的活，现在一小时就能收尾。赶紧拿自己的项目试一把。

教程里用到的接口和模型价格见 https://teamorouter.com