Claude Code 的 VS Code 扩展可以通过环境变量指定 API 地址和不同档位对应的模型。对于提供 Anthropic 兼容接口的模型平台,可以直接修改 VS Code 的 settings.json,不必额外安装模型切换工具。
本文将介绍一种纯手动配置方案,只需修改 VSCode 的 settings.json,即可实现 Claude Code 对接国内大模型,无需任何第三方工具。
为什么选择手动配置?
手动配置的依赖更少,关键参数也更加透明,适合只使用一个模型平台或希望明确控制模型映射的场景。如果需要频繁切换多个平台,使用专门的配置管理工具会更方便。
核心原理:三个关键环境变量
Claude Code 插件通过以下三个环境变量控制模型选择:
| 环境变量 | 对应插件选项 | 用途 |
|---|---|---|
ANTHROPIC_DEFAULT_OPUS_MODEL |
Opus | 高性能档位 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Default/Sonnet | 默认档位 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Haiku | 轻量档位 |
当你在插件中切换模型时,它会读取对应的环境变量值作为实际调用的模型名。
配置步骤
第一步:获取模型平台 API Key
以通义千问为例:
- 访问 阿里云百炼平台
- 开通服务并创建 API Key
- 记录下 API Key 和模型名称
第二步:修改 VS Code settings.json
打开 VSCode 设置(Ctrl+, / Cmd+,),搜索「Claude Code: Environment Variables」,点击「Edit in settings.json」。
添加以下配置:
{
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://dashscope.aliyuncs.com/apps/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "YOUR_API_KEY"
},
{
"name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
"value": "qwen3.5-120b"
},
{
"name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
"value": "qwen3.5-72b"
},
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "qwen3.5-7b"
}
],
"claudeCode.disableLoginPrompt": true,
"claudeCode.selectedModel": "default"
}
第三步:验证配置是否生效
- 保存配置后重启 VS Code(或执行「Developer: Reload Window」)
- 打开 Claude Code 插件面板
- 点击「Switch Model」,选择不同档位测试

主流平台配置模板
通义千问(阿里云)
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://dashscope.aliyuncs.com/apps/anthropic" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "qwen3.5-120b" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "qwen3.5-72b" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "qwen3.5-7b" }
],
"claudeCode.disableLoginPrompt": true
}
其他平台的配置思路相同,但接口地址、认证字段和可用模型名称必须以对应平台的文档为准。
总结
通过手动配置 ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL 三个环境变量,我们可以:
- 无需第三方工具:直接在 VSCode 中完成配置
- 安全可靠:API Key 只保存在本地
- 灵活切换:三个档位可分别映射不同的国内模型
关键配置项速查:
ANTHROPIC_BASE_URL:国内模型的 Anthropic 兼容接口地址ANTHROPIC_AUTH_TOKEN:你的 API KeyANTHROPIC_DEFAULT_SONNET_MODEL:默认使用的模型(最常用)