Claude Code 国内使用教程

国内使用 Claude Code 的 3 个障碍

安装（npm 与国内源）

1. 1. 安装 Node.js 22 或更高版本

   运行 node -v 确认版本。

2. 2. （可选）切换国内 npm 源

   npm 下载慢时可以先换源。

   终端

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

3. 3. 安装 Claude Code

   全局安装后运行 claude --version 检查。

   终端

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

提示 command not found：多半是 npm 全局目录不在 PATH 里。运行 npm config get prefix，把输出目录下的 bin 加进 PATH 后重开终端。

接入国内可用 API

在 AICodeWith 控制台创建 Key，然后写进 ~/.claude/settings.json。重开终端运行 claude，输入 /status 确认接口地址是 api.aicodewith.ai。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

Claude Code 中转站说明获取 API Key

无法使用排查

1. 运行 /status，确认接口地址是 api.aicodewith.ai，而不是 Anthropic 默认地址。
2. 在新终端运行 echo $ANTHROPIC_API_KEY，如果有旧值，从 ~/.zshrc 或 ~/.bashrc 里删掉；ANTHROPIC_API_KEY 应该留空。
3. 首次运行卡在登录界面：在 ~/.claude.json 里加上 "hasCompletedOnboarding": true。
4. 请求超时：临时关闭本地代理或 VPN 再试，国内网络可以直连。
5. 报 401 / 429 / overloaded：见报错大全。

Claude Code 常见报错与解决支持地区

方案对比（官方订阅 vs 中转）

Claude Code 用量限制说明充值与套餐

FAQ