Claude Code CLI · 手动配置​

配置文件位置​

启动 claude 时：

• 没有该文件 → 触发 Anthropic 官方 OAuth 引导（需要 Anthropic 账号）
• 文件存在且 env 段配置正确 → 跳过 OAuth 流程，直接使用配置的 API Key
• 有文件但 env 段缺字段 → 拿不到 Key，报 401

结论：配好 settings.json 就不需要登录。

最小可用模板​

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://foropencode.com",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

保存后不用重启，下一次发请求即生效（Claude Code 支持热切换）。

完整环境变量字段​

env 段所有字段在进程启动时注入到环境变量。Anthropic 官方文档列出的：

认证与路由​

模型选择​

行为开关​

提示词缓存​

国内网络必做配置​

{
  "ENABLE_TOOL_SEARCH": true,
  "skipWebFetchPreflight": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://foropencode.com",
    "ANTHROPIC_API_KEY": "sk-xxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

详见 CC-017：WebFetch 预检失败。

系统环境变量（备用）​

不想改 settings.json，也可以在系统级注入环境变量。优先级高于 settings.json：

export ANTHROPIC_BASE_URL=https://foropencode.com
export ANTHROPIC_API_KEY=sk-xxx

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://foropencode.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxx", "User")

AWS 分组 400 的补充项​

如果使用 AWS 分组时出现 400，且报错与请求内容无关：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://foropencode.com",
    "ANTHROPIC_API_KEY": "sk-xxx",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

保存后重启所有终端，再启动 claude 生效。详见 CC-006。

验证 & 排查​

claude
/status

/status 里看到的 Base URL 应该是你刚配的。看到 api.anthropic.com = 配置没生效或被覆盖。