Claude Code

大约 4 分钟

Claude Code 常见问题

这页只解决 Claude Code 里最常见的 9 个坑。每个问题都给出可以直接照做的步骤。

90% 的人在这两件事上栽过

Base URL 不带 /v1：ANTHROPIC_BASE_URL = https://www.yuzhixiaolongxia.com，Claude Code 和 Codex 不一样，别加 /v1。
环境变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY。两个名字都常见但 Claude Code 认前者。

1. 装不上 / npm 报错

症状：npm install -g @anthropic-ai/claude-code 长时间不动、报网络错误、或装完后无任何反应。

怎么动手：

查 Node.js 版本：终端跑 node -v，要求 18 或更高。版本不够的，去 nodejs.org 装 LTS。

npm 网络不通就换国内镜像：

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

还是装不上？用一键安装包，避开 npm 网络问题。

2. `command not found: claude`

症状：装完了，但跑 claude 提示找不到命令。

原因：npm 全局 bin 目录没在 PATH 里。

怎么动手：

macOS / Linux：

echo "export PATH=$(npm config get prefix)/bin:\$PATH" >> ~/.zshrc
source ~/.zshrc
which claude    # 应该能看到路径

Windows：在 PowerShell 跑 npm config get prefix，把输出的路径加到系统环境变量 Path，然后重开终端。
验证：claude --version 能输出版本号就行。

3. 401 Unauthorized

症状：请求被拒绝，提示 401、unauthorized 或 invalid token。

3 个最常见原因（按顺序排查）：

环境变量名搞错：Claude Code 读的是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY。如果你只设了后者，Claude Code 看不到。
令牌没填或填错：到 /console/token 重新复制一遍，注意前后不要有空格、换行。
变量没生效：改完 ~/.zshrc / ~/.bashrc 之后没 source，或者没重开终端。

配置长这样（~/.claude/settings.json）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.yuzhixiaolongxia.com",
    "ANTHROPIC_AUTH_TOKEN": "你的令牌"
  }
}

4. 403 余额不足 / 分组不对

症状：报 403 或提示"余额不足 / 无权限调用此模型"，但你明明充过钱。

怎么动手：

看余额：/console/personal，确认大于 0。
看令牌分组：/console/token，对应令牌的"分组"列必须是 Claude 家族。
分组不对，最快的修法是重新创建一个 Claude 家族令牌替换掉旧的，比改老令牌靠谱。
如果分组对、余额也够，看令牌是不是设了单独额度上限（创建时填的，没填默认无上限）。

5. Base URL 末尾要不要带 /v1？

不要带

ANTHROPIC_BASE_URL = https://www.yuzhixiaolongxia.com

这是 Claude Code 和 Codex 最大的差异。Codex 要带 /v1，Claude Code 不要。

填错的症状：404 Not Found、connection error、或回复就是出不来。

怎么动手：

# macOS / Linux
export ANTHROPIC_BASE_URL="https://www.yuzhixiaolongxia.com"

# 或写进 ~/.claude/settings.json 的 env 字段

改完一定要重开终端。

6. 回复中途断了，钱白扣了吗？

没扣，放心重发

平台对 Claude 流式异常断线（客户端中断 / 超时 / scanner_error 等）自动跳过扣费。你看到的"扣了又退"或"没产生消费记录"都是正常的。

怎么动手：

直接重发请求，没成本。
频繁断线的话，看下一题（"回复很慢/卡顿"）的排查步骤。

7. 回复很慢 / 卡顿

怎么动手（按顺序试）：

先换小模型：试 claude-haiku-4-5，看是不是模型本身慢。
换网络：手机热点 / 切到另一个网络环境，看是不是本地链路问题。
拆任务：单次别塞太多上下文，长任务分阶段做。
错峰：上游负载高时（特别是工作日白天的某些时段）稍等几分钟。

8. 模型不存在 / `model not found`

怎么动手：

到 /pricing 复制最新模型 ID，不要凭记忆手敲。
当前常用的：
- claude-opus-4-7（最新旗舰）
- claude-opus-4-6
- claude-haiku-4-5（小快省）
改完配置后重开终端。
如果模型 ID 是对的还报 404，说明你令牌的分组里没这个模型，回看第 4 题。

9. 怎么在多个令牌 / 多套配置之间切换

怎么动手：用 CC-Switch 工具，一键切换不同令牌和 Base URL，不用每次手改环境变量。

详见 CC-Switch 使用指南。

附：和 VS Code / 其他插件一起用

如果你同时在 VS Code 里挂了 Claude 相关插件，插件侧也要填同样的 Base URL 和令牌，否则插件走默认地址会报错。插件配置位置一般在插件的 Settings 页，找 API Endpoint 和 API Key 两项填进去就行。

更多手动配置细节见 Claude Code 配置文档。

还没解决？

看监控状态页是否有平台公告
留意主站首页公告位
反馈时贴出：错误日志 + 你的 Base URL + 令牌分组 + 用的模型 ID，定位最快