Claude code + vs code
在 VS Code 中配置 Claude Code 并连接 API 中转站
https://xh.v1api.cc本教程只包含 VS Code 和 Claude Code 的常规配置流程，不依赖第三方客户端或一键安装程序。中转站的可用模型、计费、请求限制和接口兼容性由中转站服务方决定。
一、准备信息
1.
2.
Authorization: Bearer，还是 x-api-key 请求头。3.
4.
https://xh.v1api.cc 作为 Base URL。若服务方要求带额外路径，请以其提供的接口文档为准；不要自行重复追加 /v1。二、安装 VS Code 扩展
1.
2.
Cmd+Shift+X（macOS）或 Ctrl+Shift+X（Windows/Linux）打开扩展面板。3.
4.
Cmd+Shift+P / Ctrl+Shift+P 打开命令面板，运行 Preferences: Open User Settings (JSON)。三、配置 Base URL 和 API 凭据
settings.json 中添加 claudeCode.environmentVariables。请把示例中的占位符替换为自己的中转站密钥。方式 A：中转站使用 Bearer Token
Authorization: Bearer <密钥> 请求头中，使用 ANTHROPIC_AUTH_TOKEN：{
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://xh.v1api.cc"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "替换为你的中转站API密钥"
}
]
}方式 B：中转站使用 x-api-key
x-api-key 请求头传递，使用 ANTHROPIC_API_KEY 替换上面的 ANTHROPIC_AUTH_TOKEN：{
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://xh.v1api.cc"
},
{
"name": "ANTHROPIC_API_KEY",
"value": "替换为你的中转站API密钥"
}
]
}两种鉴权方式只配置服务方要求的一种，不要同时配置。若服务方没有说明鉴权类型，可先按 Bearer Token（方式 A）尝试；若出现 401，向服务方确认请求头类型后再切换。
settings.json 已有其他配置，不要覆盖原有内容；把 claudeCode.environmentVariables 合并到现有 JSON 顶层，并确保逗号和括号符合 JSON 格式。例如：{
"editor.fontSize": 14,
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://xh.v1api.cc"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "替换为你的中转站API密钥"
}
]
}四、重载 VS Code 并测试
1.
settings.json。2.
Cmd+Shift+P / Ctrl+Shift+P 打开命令面板，运行 Developer: Reload Window。3.
4.
五、常见问题
1. 扩展仍然提示登录或没有走中转站
.vscode/settings.json。claudeCode.environmentVariables 是否为数组格式，数组项使用 name 和 value 字段。2. 返回 401 或鉴权失败
x-api-key。ANTHROPIC_AUTH_TOKEN；x-api-key 对应 ANTHROPIC_API_KEY。3. 返回 404、接口路径错误或请求地址错误
https://xh.v1api.cc，以及是否要求使用特定 API 路径。不同服务的网关路径约定可能不同，不要仅凭其他教程添加 /v1 或其他路径。4. 返回模型不存在或模型不可用
5. 返回超时、连接失败或额度错误
六、密钥安全
.vscode/settings.json、.claude/settings.json 或其他会提交到仓库的文件。参考文档
修改于 2026-09-29 04:12:55