Claude Code 专页

Claude Code 使用 1A1API 中转

Claude Code 推荐用环境变量接入第三方网关。不要把 Codex 的 config.toml 写法搬到 Claude Code 里。

适用版本：当前 Claude Code 环境变量接入方式 最后验证：2026-07-20

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

结论

本教程使用环境变量，不要照搬 Codex 的 ~/.codex/config.toml

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

写入 shell 配置

zsh：写入 ~/.zshrc 后执行

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

source ~/.zshrc
claude

bash：写入 ~/.bashrc 后执行

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

source ~/.bashrc
claude

Windows

PowerShell 当前会话测试

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"

按 Claude Code 当前环境变量参考，该变量会关闭自动更新、遥测、错误报告、/feedback、版本说明获取、网关模型发现刷新，以及 fast mode 等功能的可用性检查；官方插件市场的自动安装不受它影响。它不替代本页的 Base URL、API 密钥和模型配置。需要长期生效时，可以把环境变量写入 ~/.claude/settings.json 的 env 字段；最小接入不需要这一步。参见环境变量参考与设置文件说明。

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

排错

Claude Code 最常见的 3 个错法

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

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

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