AI API 中转站使用说明：Claude Code / Codex / OpenAI 兼容客户端配置、购买前须知与错误排查。

Claude Code 中转站手动配置教程

Claude Code 中转站手动配置说明：settings.json 路径、ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、配置优先级、/model 排查与常见错误处理。

Claude Code 中转站手动配置教程

如果你现在主要在 VS Code / Cursor 插件里使用 Claude Code，建议先看这篇更完整的入口文档：

当自动安装、扩展接管或 ccswitch 导入不可用时，再使用手动配置。手动配置的核心，是确认 Claude Code 实际读取了哪一层设置，并把 API Key、Base URL 和模型选择放到正确位置。

先备份，再修改。文件里已有内容时，不要整文件清空，只合并需要的字段。

适合谁看

  • 配了 ANTHROPIC_BASE_URL，Claude Code 还是要求登录或仍走默认线路。
  • 想确认 Claude Code 到底读取了哪个 Key、Base URL 和模型。
  • /model 看不到目标模型，或出现 model not found。
  • 想知道 settings.local.json、项目配置和用户配置谁优先。

你需要准备

信息从哪里拿示例
API Key控制台或账户页面sk-xxxxxxxxxxxxxxxx
Base URL业务侧确认后的 API 域名https://YOUR_API_DOMAIN/anthropic
模型名控制台模型列表控制台显示的模型名
压缩阈值自行决定78 或 80

本文继续使用 YOUR_API_DOMAIN 占位。不要把示例域名当成真实线路地址。

Claude Code 配置优先级

Claude Code 常见排错点不是“有没有填”，而是“填在哪一层”。官方文档的常见优先级可以先按下面理解：

优先级位置适合场景常见坑
Managed团队或受管配置团队统一策略个人改了本地配置但被上层覆盖
CLI 参数启动参数临时切模型或 provider关掉当前会话后失效
Local.claude/settings.local.json当前仓库临时调试只在当前项目生效
Project.claude/settings.json项目级共享约定容易和 Local 冲突
User~/.claude/settings.json用户默认值经常以为改了这里就能覆盖全部

如果你在项目目录、用户目录、插件环境里都改过，先判断到底是谁在最后生效，再继续排错。

找到 settings.json

Windows

%USERPROFILE%\.claude\settings.json

可以按 Win + R，输入 %USERPROFILE%\.claude 后回车。

macOS / Linux

~/.claude/settings.json

Finder 可按 Cmd + Shift + G，输入 ~/.claude。

如果没有 .claude 文件夹，可以先启动一次 Claude Code，或者手动创建文件夹和 settings.json。

写入最小配置

如果 settings.json 是空文件或不存在，可以先写最小可验证版本：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://YOUR_API_DOMAIN/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "控制台显示的模型名",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "78"
  }
}

如果文件里已有其他配置，只合并 env 字段，不要抹掉已有内容：

{
  "env": {
    "已有配置": "保留",
    "ANTHROPIC_BASE_URL": "https://YOUR_API_DOMAIN/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "控制台显示的模型名"
  }
}

ANTHROPIC_BASE_URL 配了但不生效怎么办？

优先按下面顺序查，而不是一上来就重装客户端。

检查项你要看什么常见问题
ANTHROPIC_BASE_URL是否写成 https://YOUR_API_DOMAIN/anthropic少了协议、路径写错、IDE 里没继承新变量
ANTHROPIC_AUTH_TOKEN是否与当前线路匹配Key 复制不完整、粘贴了旧 Key
ANTHROPIC_API_KEY是否也被设置过有时会和 ANTHROPIC_AUTH_TOKEN 形成混淆
shell profile.zshrc / .bashrc / PowerShell profile改了文件但没 reload
IDE 终端继承VS Code / Cursor 内置终端外部终端生效，IDE 内置终端没生效
项目级配置.claude/settings.local.json / .claude/settings.json项目内配置把用户级设置覆盖了

最小验证步骤

  1. 先关闭 Claude Code、IDE 和当前终端。
  2. 重新打开终端，确认环境变量已经重新加载。
  3. 启动 claude。
  4. 运行 /status，看当前 provider、Base URL、模型和认证方式是否符合预期。
  5. 发送一个最小 prompt，例如：
请只回复“配置已生效”。

如果 /status 仍显示旧线路或默认配置，优先排查配置层级，不要先怀疑模型本身。

/model 看不到模型怎么办？

Claude Code 中常见的问题不是“模型不存在”，而是“当前层级没选中正确模型”。

检查项说明
/model 当前显示先看会话里当前实际选择了什么
启动参数某些临时启动参数会覆盖默认设置
ANTHROPIC_MODEL环境变量里是否写了旧模型名
settings 中的 model项目级或用户级设置是否覆盖
provider allowlist线路本身是否只开放了部分模型

建议先把模型改成控制台里明确展示的那个，再发送短 prompt 验证。如果报 model not found，继续看：Model Not Found 排查。

保存并验证

  1. 保存 settings.json。
  2. 完全关闭 Claude Code 和当前终端。
  3. 重新打开终端。
  4. 执行 claude。
  5. 先用 /status 看当前配置，再发送测试消息。

能正常收到回复，就说明当前配置层级和认证已经生效。

排错清单

现象可能原因处理方式
仍然要求登录仍在走默认 provider，或项目级配置覆盖了用户级配置先看 /status，再逐层排查 Local / Project / User
Unauthorized / 401Key 错了或多了空格重新复制 API Key，必要时轮换新 Key
model not found模型名不对或当前线路没开放改用控制台展示的模型名，并检查权限
Connection Error / 连接失败Base URL 错或网络不可用确认地址仍是 https://YOUR_API_DOMAIN/anthropic
保存后没变化改错文件或旧终端仍在确认路径，彻底退出后重开
JSON 报错少逗号或多逗号用 JSON 校验工具检查格式

和上下文压缩的关系

CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 用来调整自动压缩触发阈值。推荐值 78 或 80，表示上下文占用到约 78%/80% 时提前压缩，避免撑到极限才处理。

压缩后可能出现：

  • 早期细节变模糊。
  • 缓存重新建立。
  • 下一次请求费用变化。
  • 需要重新补充关键背景。

长期项目规则建议写进 CLAUDE.md，不要只放在聊天里。

相关页面