← 返回 Claude Code 教程卡片

Claude Code

Anthropic 推出的终端原生 AI 编程智能体，跑在命令行里。

需特殊网络环境 / 第三方中转。

采集于 2026-10-05 · 关键步骤请以官方最新文档为准

一句话简介： Anthropic 推出的终端原生 AI 编程智能体，跑在命令行里。

主流功能：终端结对编程、Git 感知提交、长上下文代码库推理

可用性：需特殊网络环境 / 第三方中转。

适用人群：开发者；习惯终端、想让 AI 直接在仓库里做重构、修 bug、写测试、审代码的人

前置条件：

Node.js 18+（推荐 LTS），node -v / npm -v 正常输出
二选一的鉴权方式
方式 A（官方）：Anthropic 账号 + 订阅（Pro $17/月起），终端 claude 后按提示浏览器 OAuth 登录——国内直连不可用，需特殊网络环境
方式 B（国内常用）：第三方中转服务的 API Key（注册即得令牌，多家提供体验额度），通过环境变量或 settings.json 接入

分步骤教程

第一步：安装 Node.js 与 Claude Code

安装 Node.js LTS（官网下载或 nvm），验证：
```
node -v
npm -v
```

国内用户先换 npm 淘宝镜像（全局一次）：

npm config set registry https://registry.npmmirror.com

全局安装 Claude Code：

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

安装慢时可单次指定源：

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

验证：
```
claude --version
```
输出版本号即成功。

第二步：配置鉴权（国内中转方案）

方案一：直接写配置文件（最常用）

找到配置目录：Windows C:\Users\你的用户名\.claude\，macOS/Linux ~/.claude/；没有 settings.json 就新建一个。

写入中转服务地址与 Key（把示例地址/Key 换成你实际购买的服务商）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://你的中转服务地址/",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

终端输入 claude 回车，能正常对话即配置成功。

方案二：claude-code-router（开源路由，可多模型切换）

安装并启动：

npm install -g @musistudio/claude-code-router
ccr ui

浏览器会自动打开 http://127.0.0.1:3456/ui/（没自动打开就手动访问）。
在网页里添加供应商：填中转服务的 Base URL 与 API Key，选择要用的模型（如 claude-sonnet 系列；复杂任务可配 opus，但贵）。
右上角保存并重启，然后用 ccr code 启动 Claude Code（走本地 3456 端口中转）。

方案三：官方订阅登录（需特殊网络）

终端输入 claude，按提示在浏览器完成 Anthropic 账号 OAuth 登录即可；也可在交互内输入 /login 重新登录。

第三步：项目初始化——让 AI 读懂你的仓库

进入项目根目录，启动：
```
cd 你的项目目录
claude
```
执行 /init，Claude Code 会自动分析项目并生成 CLAUDE.md——这是它的"项目说明书"，包含架构、常用命令（启动/构建/测试）、代码规范。建议检查一遍生成的内容再提交到 Git。
进阶：~/.claude/CLAUDE.md 放个人全局配置；CLAUDE.local.md 放本地敏感信息（不提交）。

第四步：常用工作流

工作流 1：通用开发（探索→计划→编码→提交）

探索："解释一下 app.py 里登录接口的逻辑"
计划："给登录接口加手机号校验，先列出实现步骤"（先审计划再动手）
编码：确认后让它写代码、跑测试
提交："提交代码，commit 信息用 feat: 登录增加手机号校验"

工作流 2：修 Bug

claude "复现并修复登录接口返回 500 的问题"

或把报错截图直接发给它（终端支持粘贴图片），它会定位、改代码、跑测试验证。

工作流 3：TDD（测试驱动）

"基于注册接口的输入输出写测试用例（先确保失败）"
"运行测试，确认失败，不要写实现"
"现在写接口实现，让测试通过，不要改测试"

工作流 4：代码审查

交互内输入 /review，或 "review 一下这次改动，重点看空指针和并发问题"。

高频斜杠命令速查：

命令	作用
`/help`	查看全部命令
`/init`	初始化项目生成 CLAUDE.md
`/clear`	清空当前会话（换任务时用）
`/compact`	压缩长会话上下文，省 token
`/cost`	查看本次 token 花费
`/permissions`	可视化管理工具权限
`/model`	切换模型
`/doctor`	诊断权限/网络问题
`/mcp`	查看 MCP 服务状态

上下文技巧：用 @ 直接引用文件（如 @src/app.py），不用复制粘贴大段代码；长会话变慢时先 /compact 再继续。

第五步：MCP 扩展（连接外部服务）

查看已装 MCP：claude mcp list

添加示例（GitHub）：

claude mcp add github -- env GITHUB_PERSONAL_ACCESS_TOKEN=你的token npx -y @modelcontextprotocol/server-github

（具体命令格式随版本变化，以 claude mcp --help 为准）

配好后可直接说："把这个分支的改动提一个 PR"，它会调用 GitHub MCP 完成，不用离开终端。

第六步：VS Code 插件（可选）

在 VS Code 扩展市场搜索 Claude Code 并安装官方插件，右上角会出现图标；走中转方案的用户需保证终端 claude 命令本身已能正常鉴权，插件调用的是同一套配置。

常见问题

npm 安装超时/特别慢？ 换淘宝镜像源（第一步第 2 条），或单次 --registry=https://registry.npmmirror.com。只是下载包走镜像。
提示 401 / 认证失败？ 检查 settings.json 的 JSON 格式是否合法（多一个逗号就会炸）、Key 是否复制完整、Base URL 结尾斜杠是否与服务商要求一致；用 /doctor 诊断。
中转服务怎么选？ 只看三点：是否明确支持 Claude Code（responses 接口）、是否按量计费且价格透明、有无体验额度先试。闲鱼"包次数"类多为坑（Claude Code 一次问答后台会请求很多次），优先选按 token 计费的。此处不推荐具体服务商，自行搜索最新口碑。
上下文满了、回答变慢怎么办？ 输入 /compact 压缩；或 /clear 开新会话；把长期有效的约定沉淀进 CLAUDE.md，减少重复输入。
官方订阅和走中转哪个划算？ 官方 Pro $17/月在支持地区最省心；国内用户用官方需解决网络与支付两道门槛。中转按量付费适合用量小的人，重度使用前先用 /cost 观察一周的真实花费再决定。

← 返回教程目录