Claude Code 接入 VisionCoder 教程

Claude Code 使用 Anthropic 协议接入 VisionCoder 网关:配置网关地址、API 密钥和模型名,附可复制配置、验证命令和常见报错;当前 1 个公开模型可用,如 deepseek-v4-pro-0813。

首页 / 接入教程 / Claude Code

协议:Anthropic;核对于 2026-11-10;1 个模型可用

注意:Anthropic 官方文档写明:不支持通过任何网关把 Claude Code 路由到非 Claude 模型。下表列出的是本站声明了 Anthropic 协议的模型,用于非 Claude 模型时可能出现兼容问题,请自行评估。

说明:设置了网关凭据变量后,它优先于已保存的 claude.ai 登录(登录信息保留但不使用)。本站同时认 Authorization: Bearer(对应 ANTHROPIC_AUTH_TOKEN)和 x-api-key(对应 ANTHROPIC_API_KEY),任选其一。

适用条件

Claude Code 使用 Anthropic 协议(/v1/messages)。网关不做协议转换,只有声明了该协议的模型能用;用错协议会返回 400,并提示该用的接口路径。

准备:API 密钥与网关地址

登录后在「API密钥」页创建 Key 并查看网关地址,下文用占位符 <网关地址> 表示。个人空间 Key 以 sk-u- 开头,企业员工 Key 以 sk-e- 开头,企业 Token 以 sk-org- 开头,均可调用;管理 Key(sk-mgmt-)调用会被拒绝。

配置步骤

  1. 登录后在「API密钥」页创建 Key,并查看网关地址。
  2. 在终端设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。网关地址不带 /v1,Claude Code 会自己拼 /v1/messages。
  3. 先用下方验证命令发一条请求,确认网关和 Key 可用,再打开 Claude Code。
  4. 用 ANTHROPIC_MODEL 指定下表里的模型名(也可以用 claude --model <名称> 或会话里的 /model <名称>)。
  5. 在同一个终端运行 claude,输入 /status,确认 Anthropic base URL 一行显示的是你的网关地址。没有这一行,说明变量没有传进会话。
  6. 要长期生效,把变量写进 ~/.claude/settings.json 的 env 块;不要把 Key 写进项目里的 .claude/settings.json,它会被提交并共享给所有克隆仓库的人。

终端环境变量(Bash / Zsh)

export ANTHROPIC_BASE_URL=https://<网关地址>
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=<模型名>

写进 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<网关地址>",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "<模型名>"
  }
}

验证命令

把模型名换成下表里的任意一个;返回 JSON 即说明网关和 Key 可用。

curl https://<网关地址>/v1/messages \
  -H "x-api-key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"<模型名>","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

本站可用模型

只列出声明了 Anthropic 协议的公开模型;点击模型名查看完整价格。单位:元 / 百万 token。

模型名厂商区域上下文输入 / 输出
deepseek-v4-pro-0813DeepSeek国内1M¥5.85 / ¥17.55

常见报错

现象原因与处理依据
401,提示 Key 无效先确认 Key 在 VisionCoder 创建且未被停用。Authorization 不是 Bearer <Key> 格式,或 Authorization 与 x-api-key 两个头的值不一致,也会被拒绝。(错误号 401060)官方文档 + 网关
400,提示 Extra inputs are not permitted官方做法:设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1,去掉实验字段后再试。官方文档
启动后要求登录,但 curl 验证成功凭据变量要设在 Claude Code 启动前就能读到的地方:终端 export、~/.claude/settings.json 的 env 块。项目里的 .claude/settings.json 要等首次向导和信任确认之后才生效。官方文档
设置了 `ANTHROPIC_API_KEY` 却被忽略,也没有任何提示官方说明:交互模式下这个 Key 需要先批准一次,拒绝过的会被静默忽略。在 /config 里打开 Use custom API key 选项即可。官方文档
连接被拒绝或域名无法解析网关地址写错,或网络、防火墙挡住了到网关的路径。先运行下方验证命令,它会以同样的原因立刻失败。官方文档
400,该模型不支持当前接口模型没有声明 Anthropic 协议;响应里会列出它支持的接口路径。只选下表里的模型。(错误号 400159)网关
404,模型不存在模型名写错或不存在。模型名要和下表完全一致。(错误号 404042)网关
403,模型当前不可用模型存在,但你的 Key 所在空间不能调用它。(错误号 403060)网关
错误信息以 [402070] 或 [402072] 开头,提示额度不足或已用完账户没有可用额度,请先购买订阅套餐或加油包;企业成员请联系管理员。各工具对这类错误显示的 HTTP 状态码不同,以错误信息开头的错误号为准。(错误号 402070、402072)网关
错误信息以 [402073] 开头,提示订阅套餐已过期订阅套餐已过期,请购买订阅套餐或加油包;企业成员请联系管理员。(错误号 402073)网关
错误信息以 [402074] 开头,提示已达每月用量上限企业 Token 当月用量已达上限,请联系企业管理员。(错误号 402074)网关
429,触发限流请求过于频繁或同时进行的请求数已满,稍后重试,或等当前请求结束。(错误号 429000、429060、429062、429063)网关
错误信息以 [503060] 开头,提示当前没有可用的模型通道该模型暂时没有健康的通道,稍后重试。各工具对这类错误显示的 HTTP 状态码不同,以错误信息开头的错误号为准。(错误号 503060)网关

官方依据

核对于 2026-11-10。非官方教程:VisionCoder 与 Claude Code 的权利人无隶属或合作关系,Claude Code 的名称和商标归其权利人所有。配置方法依据其官方文档,工具更新后界面可能不同,以官方文档为准。

其他工具