配置 Claude Code

通过环境变量设置 1A1API 地址、认证密钥和模型。Claude Code 使用 Anthropic 接口，不使用 Codex 的配置文件。

适用范围：Claude Code 环境变量接入 内容核对：2026-10-10 客户端实测：本轮未执行当前版本接入测试

打开 1A1API 控制台 Claude 模型说明查看错误码排查

结论

确认接口地址与认证方式

Claude Code 会读取环境变量并自动拼接 Messages 接口路径。Base URL 写 root：https://api.1a1api.top。

Base URLANTHROPIC_BASE_URL="https://api.1a1api.top"

API 密钥ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

模型 ID从当前 API 密钥可用的 Sonnet 模型中选择一个完成测试；具体 ID 以控制台模型列表为准。

不要这样做不要填 https://api.1a1api.top/v1，也不要照抄 Codex 的 ~/.codex/config.toml。

如果你同时用 Codex 和 Claude Code，请分别配置：Codex 看 Codex 专页，Claude Code 看本页。两个工具的 Base URL、模型 ID 和配置文件不是同一套。

macOS / Linux

macOS / Linux：设置环境变量

zsh / bash：在当前终端执行

export ANTHROPIC_BASE_URL="https://api.1a1api.top"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"

claude

先把密钥占位符和 YOUR_CLAUDE_MODEL_ID 换为本机使用的值，再在终端执行。这些变量只对当前终端及其启动的 Claude Code 生效；关闭终端后需要重新设置。不要把 source 或 claude 启动命令写进环境变量配置文件。

可选：测试成功后保存配置

需要持久配置时，可以在自己的 ~/.claude/settings.json 中合并 env 字段，或把上方三条 export 行加入所用 shell 的启动文件：zsh 用 ~/.zshrc，bash 根据实际启动方式使用 ~/.bashrc 或登录配置。保留已有设置，只保存环境变量行。

保存后打开新终端再启动 Claude Code。启动文件和设置文件可能保存明文凭据，请限制本机访问，不要同步到公开仓库、分享或截图。

Windows

Windows：设置当前会话变量

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.1a1api.top"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
$env:ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"

claude

先把 YOUR_CLAUDE_MODEL_ID 替换为控制台中当前可用的模型 ID。示例模型不代表所有分组均可用；当前会话测试成功后，再决定是否写入系统环境变量。

可选 · 减少非必要流量

可选：限制非必要网络请求

仅在设备或组织的网络策略要求时启用。此选项不是接入 1A1API 的必要条件。

macOS / Linux：可选变量

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows PowerShell：可选变量

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

按当前官方说明，该变量会限制自动更新、遥测、错误报告、/feedback、版本说明获取及部分功能的可用性检查；网关模型发现不受它影响。它不替代 Base URL、API 密钥和模型配置。任何非空值都会启用，包括 0；要关闭，请取消设置或清空，并重启 Claude Code。参见环境变量参考与设置文件说明。

macOS / Linux：关闭当前会话的可选限制

unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Windows PowerShell：关闭当前会话的可选限制

Remove-Item Env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC -ErrorAction SilentlyContinue

设置自定义 Base URL 与 ANTHROPIC_AUTH_TOKEN 后，请求会走当前网关；即使设备上保留 Claude.ai 登录，Remote Control、/schedule、Claude.ai MCP 连接器和通知偏好等依赖 Claude.ai 身份的功能也会被禁用。移除这些环境变量并重新启动 Claude Code 后，再使用原登录。参见 Claude Code 更新说明。

排错

配置失败时检查

写成 /v1 或 /v1/messagesClaude Code 会自动拼接接口路径。Base URL 只写 https://api.1a1api.top。

照抄 Codex config.tomlClaude Code 不按 Codex 的 ~/.codex/config.toml 读取配置。请用环境变量。

403 Forbidden检查当前 API 密钥所属分组是否支持 Claude 模型，以及订阅或余额是否可用。