Claude Code 第三方 API 配置

要解决什么问题

Claude Code CLI 默认走 Anthropic 官方 API，并会在某些路径上校验模型名必须是官方列表里的型号。若你想把 CLI 接到自建网关、OpenRouter 或其它 Anthropic 兼容 端点，常见做法是改 baseUrl、换模型名、配 sk- 开头的 Key——但稍不注意就会看到 There's an issue with the selected model，或 Key 未生效时的 Not logged in。

本技能的任务是：一次性把 Claude Code 指到自定义 API，并按文档里验证过的顺序写配置，减少来回改环境。

技能如何工作

交互上按四步推进：

1. 收集信息：API 根地址（不带 /v1 后缀）、模型名（如 deepseek-v3）、API Key。
2. 写 ~/.claude/settings.json：写入 baseUrl 与 model；不在该文件里写 apiKey，Key 只走环境变量。
3. 追加 shell 配置：在 ~/.zshrc（或你实际用的 shell 配置）里设置 Key 相关环境变量，并 source 使当前会话生效。
4. 验证：运行 claude，发一句「你好」做连通性检查。

核心机制在于：通过 --model 或 ANTHROPIC_MODEL 指定模型时会触发官方模型名校验；而 settings.json 里的 "model" 字段不触发该校验。把模型名写进 settings，可让 CLI 接受任意兼容端点返回的模型标识。

适用边界与注意点

• 仅针对 Claude Code CLI 与 Anthropic 兼容 HTTP API 的配置流程，不包含其它客户端或代理软件的通用教程。
• ConnectionRefused 多半是 baseUrl 写错（多写了 /v1 或端口不对），应改成网关文档给的根地址。
• 若仍报模型错误，检查是否残留 --model / ANTHROPIC_MODEL，应删掉，只保留 settings 中的 model。
• API Key 变更后需确认环境变量已加载（新开终端或重新 source），否则会继续 Not logged in。