国内安装使用 Claude Code 完整教程：安装、登录、中转配置

Claude Code 是 Anthropic 官方的命令行 AI 编程工具，和 Codex 定位类似，但很多人认为它在复杂重构、长任务上表现更强。国内使用它的门槛和 Codex 一样：网络、账号、支付。这篇给出三条可行路线，从零跑通。

第一步：安装

先装 Node.js 18+（方法见 Codex 教程第一步），然后：

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

• macOS / Linux / WSL2 直接可用；
• Windows 原生也支持（需要安装 Git for Windows），但新手仍推荐 WSL2，坑更少。

第二步：选一条登录路线

路线 A：官方订阅（Pro / Max）

claude

首次运行选「Subscription」登录，浏览器打开 claude.ai 授权。需要 Claude Pro（$20/月）或 Max（$100+/月）订阅——用量大选 Max。

国内障碍和 ChatGPT 一样：注册要海外手机号、付费要海外卡。对应解决：买Claude 成品号/代充，或先看懂账号类型区别（逻辑通用）再挑。

路线 B：官方 API Key

在 console.anthropic.com 创建 API Key，按 token 计费：

export ANTHROPIC_API_KEY="sk-ant-..."
claude

适合用量不规律的开发者，但同样需要海外支付方式充值。

路线 C：API 中转（国内最常用）

中转服务提供一个兼容 Anthropic 协议的国内可达接口（原理见API 中转教程）。买到中转额度后只需设置两个环境变量：

export ANTHROPIC_BASE_URL="https://你的中转地址"
export ANTHROPIC_AUTH_TOKEN="你的中转key"
claude

写进 ~/.bashrc 或 ~/.zshrc 就一劳永逸。这条路线不需要 Anthropic 账号、不需要海外卡，网络要求也最低，是国内起步最快的方式。选购时认准标明「支持 Claude Code」的中转额度商品。

第三步（可选）：Claude Code Router 多模型切换

想在 Claude Code 里同时接多家模型（官方 Claude、DeepSeek、Gemini、各家中转），用开源的 Claude Code Router 统一管理：

npm install -g @musistudio/claude-code-router
ccr code   # 代替 claude 启动

在 ~/.claude-code-router/config.json 里配置多个 provider 和路由规则，比如「后台任务走便宜模型、复杂推理走 Claude」，能显著省额度。它本质上就是跑在你本机的一个小中转站。

第四步：基本用法

cd my-project
claude "阅读这个仓库，总结架构，然后把 utils 里的重复代码抽成公共函数"

实用要点：

• 项目根目录放 CLAUDE.md，写清构建命令、代码规范，Claude Code 每次都会读；
• /init 让它自动生成 CLAUDE.md；
• /compact 压缩上下文继续长任务；
• 权限确认嫌烦可用 claude --dangerously-skip-permissions（仅限可信目录）。

常见报错排查

现象	解决
登录浏览器页打不开	走路线 C 中转，绕开对 claude.ai 的直连要求
Invalid API key	检查 BASE_URL 和 TOKEN 是否配对（中转 key 不能配官方地址）
回复到一半断流	网络抖动；中转路线选国内直连优化的服务商
Windows 下命令不存在	确认 npm 全局 bin 目录在 PATH 里，或改用 WSL2

下一步

想让 Claude Code 通过 skills（技能）长期自动化推进科研和项目开发，看：用 Claude Code / Codex 做科研自动化。