OneProvider

VS Code

在 VS Code 的 Claude Code 扩展中使用 OneProvider:把端点和密钥写入 settings.json,重启,跳过登录提示并测试。

VS Code 的 Claude Code 扩展会从用户主目录下的 settings.json 读取环境变量。填入 OneProvider 的端点和密钥,然后重启即可。

全部模型、功能与价格 面向 AI 智能体的文档索引: https://oneprovider.dev/docs/llms.txt 操作系统 开始之前:从个人中心获取密钥 打开您的个人中心:Telegram 机器人 @oneprovider_robot (“个人中心”)或 app.oneprovider.dev 。点击“签发密钥”,为它命名(例如此客户端的名称)并设置消费限额,然后复制密钥。充值也在同一个地方进行。详细了解个人中心与密钥 。

安装

在 VS Code Marketplace 中搜索“Claude Code”(发布者 anthropic.claude-code)并安装。该扩展自带运行时——在编辑器中使用无需另装 CLI。

配置

按下面对应操作系统的路径创建 settings.json。扩展在启动时读取此文件,并对每一个对外请求使用其中的 env 块。

路径:~/.claude/settings.json

json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}

如果文件不存在,请先创建,然后完全重启 VS Code,以便加载新的 env 块。

如果扩展要求您登录

扩展在启动前会检查凭据,如果您没有 Claude 账号,可能会显示登录界面。可靠的解决办法是在 VS Code 自己的用户设置中填写地址和密钥:打开 Command Palette(命令面板, ⌘⇧P / Ctrl+Shift+P )→ Preferences: Open User Settings (JSON)(首选项: 打开用户设置 (JSON)),然后添加以下内容(macOS、Linux 和 Windows 上做法相同):

json
{
"claudeCode.disableLoginPrompt": true,
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.oneprovider.dev" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-key-here" }
]
}

重启 VS Code。OneProvider 密钥既可以作为 ANTHROPIC_AUTH_TOKEN(Bearer)使用,也可以作为 ANTHROPIC_API_KEY 使用。

验证

打开 Claude Code 面板( ⌘⇧P / Ctrl+Shift+P → Claude Code: Focus),输入 ping 并发送。几秒内收到回复,说明端点覆盖已经生效。

CLI 与扩展 Claude Code CLI 和这个扩展共用同一个设置文件——配置其中一个,另一个也会读取。

如何选择模型

扩展运行的是同一个 Claude Code 引擎,所以选择模型的方式也一样。日常修改默认使用 claude-sonnet-5-5,大型重构切换到 claude-opus-5-5,低成本的快速提问使用 claude-haiku-5-5。在面板中用 /model 更换模型。ID 和费率见模型页面 和价格页面 ;为密钥设置消费限额,可以让账单保持可控。

常见错误与解决办法

扩展显示登录界面

扩展在启动前会检查凭据。请把上面章节中的 claudeCode.disableLoginPrompt 和 claudeCode.environmentVariables 块添加到 VS Code 的用户设置 (JSON) 中,然后完全重启 VS Code。

401 Invalid API key

值里混入了多余的引号或空格,或者来自其他服务的别家 ANTHROPIC_AUTH_TOKEN 覆盖了您的密钥。请只在一个地方设置完整的、不带引号的 OneProvider 密钥。

404,或端点不对

base URL 是 https://api.oneprovider.dev,不带 /v1。路径由扩展自己补上。

修改设置后没有任何变化

请完全退出 VS Code(仅重新加载窗口不够),以便加载新的 env 块。在 Remote-SSH、WSL 或开发容器窗口中,扩展通常在远程一侧读取设置,所以请把设置放在那里。

数据流被截断

请在运行扩展的机器上关闭 VPN 或 VLESS 代理:它们会缓冲 SSE 并破坏 HTTP/2。

我把这段内容粘贴进 settings.json 了,但没有任何变化

这是两个不同的文件。env 块要放进 ~/.claude/settings.json;VS Code 自己的用户设置(JSON)只接受上文的 claudeCode.disableLoginPrompt 和 claudeCode.environmentVariables 这两个键。请确认 ~/.claude/settings.json 最后一项后面没有逗号,然后彻底退出 VS Code。

常见问题

还需要安装 Claude Code CLI 吗?

不需要。扩展自带运行时。如果您同时使用 CLI,两者读取的是同一个 ~/.claude/settings.json,见 Claude Code 。

需要 Claude 订阅吗?

不需要,有 OneProvider 密钥就够了。

接受哪种密钥格式?

原始的 sk-… 密钥,可作为 ANTHROPIC_AUTH_TOKEN(Bearer)或 ANTHROPIC_API_KEY。

在哪里查看费用?

在该密钥的仪表板“用量”页面。签发密钥时请添加消费限额。

扩展里可以用 GPT 或目录中的其他 id 吗?

可以,使用目录 里的文本 id:我们的 Anthropic 端点同样能响应它们。在 ~/.claude/settings.json 中写入 "model": "gpt-6.1-terra";工具调用取决于模型。

可以改用 GitHub Copilot Chat 或 Continue 吗?

可以,两者都接受 OpenAI 风格的端点。Copilot Chat:命令面板 → Chat: Manage Language Models → Add Models → Custom Endpoint,然后在 chatLanguageModels.json 中设置 "apiType": "chat-completions"、id 为 gpt-6.1-terra、url 为 https://api.oneprovider.dev/v1/chat/completions 以及 "toolCalling": true(不支持工具调用的模型会被隐藏),再按目录中的对应行填写 maxInputTokens 和 maxOutputTokens。在 Copilot harness 会话中还需开启 chat.agentHost.byokModels.enabled。它只覆盖聊天和 Agent,不含行内补全。Continue:在 config.yaml 中添加一个模型,写入 provider: openai、apiBase: https://api.oneprovider.dev/v1、您的密钥和模型 id。

快速解答

该使用哪个 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 状态码和完整的错误信息。客服如何运作 。

最后更新: 2026-11-17 发现问题? @Oneproviderhelpbot