Claude Code 配置

Anthropic 的命令行工具，接入 OneProvider 端点。只需设置两个环境变量，再做一次验证调用。

安装

curl -fsSL https://claude.ai/install.sh | bash
# or:
brew install --cask claude-code

方式 1：环境变量（仅当前会话）

最快的做法是只在当前终端中设置变量。它们不会跨会话保留——如果希望重启后仍然有效，请看底部的“设为长期生效”。

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

方式 2：长期设置

Claude Code 从 settings.json 读取用户设置。下面的默认模型和系列别名取自目录中当前可用的模型。

文件路径：~/.claude/settings.json

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

验证

claude -p "say hi in one sentence"

一两秒内应收到一句话的回复。如果看到 401，说明密钥有误；400 invalid_request_error 表示模型名称与标准列表不符（响应中会列出支持的 ID）。

常见问题

# validate the file
jq . ~/.claude/settings.json
# auto-replace smart quotes with ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

400 / 401 / 403 / 404 / 429 / 503 / 504 各种症状 → 原因 → 解决办法的完整列表，见故障排查页面 。

工具调用

Claude Code 使用 Anthropic 原生的工具 schema。API 接受所有工具名称（Read、Write、Edit、Bash、Grep、Glob、TodoWrite 等），配合 tool_choice: auto——这也是 CLI 默认发送的值。不需要 anthropic-beta 请求头。

如果您自己的编排程序设置了 tool_choice: {"type": "any"} 或 tool_choice: {"type": "tool", "name": "X"}，API 会把它们改写为 auto 加一条系统提示词引导。完整对照表见工具调用 。

设为长期生效

一切正常后，如果希望变量在不同终端会话之间保留，请把它们写入 shell 的 rc 文件（macOS / Linux）或用户环境变量注册表（Windows）。新开的终端会自动读取。

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

如何选择模型

Claude Code 使用 Anthropic 协议，因此最适合搭配 Claude 系列。日常默认使用 claude-sonnet-5-5：价格与质量均衡，适合修改代码、写测试和讲解。架构决策、大型重构和难以定位的 bug 请切换到 claude-opus-5-5；它每个 token 的费用更高。快速提问、写提交信息和更看重速度而非深度的后台任务，请使用 claude-haiku-5-5。会话中运行 /model 即可切换，也可以用 claude --model claude-opus-5-5 启动。上面的设置把 sonnet、opus、haiku 三个别名映射到了这些 ID。当前的 ID 见模型页面 ，费率见价格页面 。价格按每百万 token 计算，所以请为密钥设置消费限额，并在仪表板中关注“用量”。

常见错误与解决办法

安装后提示 claude: command not found

请先新开一个终端：安装程序会把可执行文件放到 ~/.local/bin。如果仍然找不到，请在 shell 的 rc 文件中加入 export PATH="$HOME/.local/bin:$PATH"。如果用的是 Homebrew，请确认 brew install --cask claude-code 已无报错地执行完毕。

关于模型的 400 invalid_request_error

该模型 ID 不在目录中，常见原因是用了 claude-3-5-sonnet 这类旧别名。请按上面的 settings.json 设置 ANTHROPIC_MODEL 和三个 ANTHROPIC_DEFAULT_*_MODEL 变量，或者用 curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY" 列出有效的 ID。

404，或提示“The requested API endpoint does not exist”

ANTHROPIC_BASE_URL 必须恰好是 https://api.oneprovider.dev：末尾不要带 /v1，也不要带 /v1/messages。路径由 Claude Code 自己补上。

429 “Insufficient balance on this API key”

个人中心余额或密钥的消费限额已用完。重试没有用：请在个人中心充值余额或提高限额，然后重新发送请求。

响应中途停止，或连接被重置

请关闭所有 VPN 或 VLESS 代理：它们会缓冲数据流并破坏 HTTP/2。OneProvider 不按地区屏蔽，也不缓冲数据流。请求必须在 6 分钟内开始返回响应，总时长上限为 10 分钟，详见错误码 。

我改了 settings.json，但没有任何变化

Claude Code 在启动时读取 env 块，所以请退出并重新运行 claude。变量请放在 ~/.claude/settings.json 或 shell 中：项目里的 .claude/settings.json 会在首次运行设置之后才被读取，可能已经来不及了。

常见问题

需要 Claude 账号或订阅吗？

不需要，有 OneProvider 密钥就够了。Claude Code 完全不必登录 claude.ai；如果它显示登录界面，请按上面的 Auth conflict 步骤处理。

能在 Claude Code 里使用 GPT 或其他模型吗？

Claude Code 发送的是 Anthropic Messages 请求，所以请在这里使用 Claude ID。GPT 模型请使用 Codex 、Cursor 或 Cline 。

怎样切回我的 Anthropic 登录？

从 settings.json 的 env 块和 shell 的 rc 文件中删除上面设置的 ANTHROPIC_* 变量，新开一个终端，然后运行 /login。

在哪里可以看到一次会话花了多少？

在该密钥的仪表板“用量”页面：每个请求都会显示其模型和 token 数。为每个密钥设置消费限额，可以拦住失控的智能体。

能在 Windows 上使用吗？

可以。请在顶部的操作系统切换器中选择 Windows：同样的两个变量用 PowerShell 设置，settings.json 位于用户目录下的 .claude 中。

Claude Code 的 VS Code 扩展是同一回事吗？

它共用同一个设置文件。见 VS Code 中的 Claude Code 。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。