1. 安装 CLI
准备 Node.js 18+，执行 npm install -g @anthropic-ai/claude-code，然后在项目目录运行 claude。首次启动会要求登录或配置 Token。
国内使用
Claude Code 国内使用指南
网络、账号、额度——卡住国内开发者的三件事，逐个解决。
由 Claude Agent 技术团队 维护 · 发布于 2026-07-14 · 更新于 2026-10-24
在国内用 Claude Code 需要解决的三件事
Claude Code 是 Anthropic 的命令行编码工具，安装本身没有任何门槛，真正卡住国内开发者的是三件事：网络能不能稳定连上、账号能不能长期存活、额度够不够用。下面按顺序给出可执行的路径。
2. 选择接入方式
用官方账号就配置官方登录态；用兼容网关则设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个环境变量，不需要额外挂全局代理。
3. 验证模型与额度
用 /model 查看当前模型，发一条短请求确认能返回；再查看额度窗口是否正常刷新，避免跑到一半才发现限流。
两种接入方式怎么选
| 维度 | 官方账号直连 | 兼容网关 / 独享实例 |
|---|---|---|
| 网络要求 | 需要稳定的海外出口，代理抖动会直接断流 | 国内直连域名，不依赖本地代理 |
| 账号风险 | 自建环境不当容易触发风控 | 平台侧固定 IP 与隔离环境，单账号单线路 |
| 额度 | 取决于你的官方订阅档位 | 独享实例按 5h / 7d 窗口，¥205 / 30 天 全包 |
| 计费 | 官方订阅费 + 代理成本 | 固定月租，专属 Key 调用不另扣 Token 余额 |
如果只是临时试用，官方账号 + 代理最直接；如果每天都要跑 agent，稳定性与可预期成本更重要，独享实例更省心。
常见坑
- Base URL 多写 /v1：Claude Code 的
ANTHROPIC_BASE_URL用站点根域名，不要自己拼/v1。 - 用 root 跑客户端：部分环境会因此触发额外的权限与安全校验，建议用普通用户独立目录运行。
- 频繁切换网络：一会儿公司网、一会儿家宽、一会儿手机热点，出口 IP 反复变化是最常见的风控诱因。
常见问题
Claude Code 需要全局代理吗？
用官方账号直连需要稳定海外出口；使用兼容网关时只需要两个环境变量，本地不需要额外代理。
ANTHROPIC_BASE_URL 要加 /v1 吗？
不要。Claude Code 使用站点根域名即可，多写 /v1 会导致 404。
为什么总是跑到一半断开？
常见原因是出口 IP 抖动或代理不稳，也可能是额度窗口打满返回 429，需要区分处理。