跳到正文
VC API控制台
‹ 返回接入手册

Claude Code 接入

Claude Code 如何接入 VC API

先创建支持 Claude Code 的 API 密钥，再配置控制台提供的 Base URL 和认证变量。分组可能使用不同路径，请优先复制密钥“使用”弹窗里的配置。

VC API 编辑整理 / 更新于

开始前，先确认这三件事

  1. 已经按 Claude Code 官方安装说明安装客户端，可以运行 claude --version。
  2. 已注册 VC API，且所选分组有可用额度或有效套餐。
  3. 在 API 密钥页面创建密钥，点击“使用”，选择 Claude Code 和当前操作系统。

密钥属于敏感信息。不要将它粘贴进工单、截图或 Git 仓库。下面只展示占位示例。

配置当前终端

散户站的标准根地址为 https://sub.vcnovb.cn，请再核对密钥“使用”弹窗给出的实际地址。标准 Anthropic 接入通常使用根地址，不要照抄 Codex 的 /v1 后缀；特殊分组可能有额外路径。

macOS / Linux

export ANTHROPIC_BASE_URL="https://sub.vcnovb.cn"
export ANTHROPIC_AUTH_TOKEN="替换为你的 API Key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://sub.vcnovb.cn"
$env:ANTHROPIC_AUTH_TOKEN="替换为你的 API Key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude

这些命令只影响当前终端及其子进程。重新打开终端或从 IDE 启动时，需要重新设置，或按控制台指引配置客户端设置文件。

验证是否接入成功

  1. 进入一个可安全测试的项目目录，在刚才的终端启动 claude。
  2. 使用分组支持的模型，发送一条简短测试消息。测试调用可能计费。
  3. 在控制台查看同一时间的用量记录，确认模型、密钥和费用归属。

如果客户端仍走旧服务，检查 IDE、终端或设置文件中是否存在另一组环境变量。不要在未备份的情况下覆盖已有配置。

常见错误怎么排查

现象先检查
401 / 认证失败密钥是否完整、有效，变量是否设置在启动客户端的终端中。
404 / 模型不可用地址路径是否重复追加 /v1；模型 ID 和接口是否受该分组支持。
429 / 请求受限额度、并发和速率限制；等待后重试，避免持续高频重发。
超时 / 5xx网络与服务状态。保留时间、请求 ID 和脱敏错误，通过工单反馈。

参考与下一步

本教程依据 VC API 当前配置界面编写，未宣称通过所有客户端版本的实测。客户端升级后，请优先核对控制台生成配置与客户端文档。

打开 API 密钥页面了解费用