阿里云百炼 - Claude Code 配置指南
Claude Code 是 Anthropic 推出的命令行 AI 编程助手，可以通过按量计费、Coding Plan 或 Token Plan 团队版接入阿里云百炼。
安装 Claude Code
安装
macOS
Windows
在 Windows 上使用 Claude Code，需要安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行以下命令。
npm install -g @anthropic-ai/claude-code详情可以参考Claude Code官方文档的 Windows安装教程。
跳过登录验证
编辑或新增~/.claude.json（Windows 路径：C:\Users\<用户名>\.claude.json），将hasCompletedOnboarding设置为true，跳过 Anthropic 官方登录验证。
{ "hasCompletedOnboarding": true }配置接入凭证
创建~/.claude/settings.json（Windows 路径：C:\Users\<用户名>\.claude\settings.json），根据所选方案写入对应配置。阿里云百炼提供三种计费方案，根据需要选择：
Token Plan 团队版：按坐席订阅，按 token 消耗抵扣 Credits。
Coding Plan：固定月费订阅，按模型调用次数计量。
按量计费：按实际调用量后付费。
Token Plan 团队版
将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。可用模型请参考 Token Plan 团队版支持的模型。
{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_BASE_URL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus", "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus" } }Coding Plan
将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。可用模型请参考 Coding Plan 支持的模型。
{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus", "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus" } }按量计费
将 YOUR_API_KEY 替换为阿里云百炼 API Key。可用模型请参考Anthropic兼容-Messages。
ANTHROPIC_BASE_URL按地域设置，API Key 需与所选地域对应：
华北2（北京）：
https://dashscope.aliyuncs.com/apps/anthropic新加坡：
https://dashscope-intl.aliyuncs.com/apps/anthropic
{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic", "ANTHROPIC_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus", "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus", "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus" } }保存配置后新开终端运行claude "你好"，模型正常返回响应即配置成功。
使用 CC Switch
CC Switch 是社区开源的桌面 GUI，可在多个 API Key 或计费方案之间一键切换，免去手动改settings.json。
安装
macOS：
brew tap farion1231/ccswitch && brew install --cask cc-switch，或从 Releases 下载.dmg。Windows：从 Releases 下载
.msi安装包或便携版.zip。Linux：Arch 用
paru -S cc-switch-bin；其他发行版从 Releases 下载.deb/.rpm/.AppImage。
添加供应商
在 CC Switch 主界面顶部图标栏选中 Claude Code 橙色星形图标，点击右上角+进入添加新供应商，按下表填入配置后点击添加。
计费方案
配置信息
Token Plan 团队版
供应商名称：百炼-Token Plan
API Key：控制台获取
请求地址：
https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropicCoding Plan
供应商名称：百炼-Coding Plan
API Key：控制台获取
请求地址：
https://coding.dashscope.aliyuncs.com/apps/anthropic按量计费
供应商名称：百炼-按量计费
API Key：百炼 API Key
请求地址：
https://dashscope.aliyuncs.com/apps/anthropic展开高级选项配置模型映射，将主模型与 Haiku、Sonnet、Opus 默认模型填为对应方案支持的模型。具体映射关系按需选择，例如：
主模型：
qwen3.6-plusHaiku 默认模型：
qwen3.6-flashSonnet 默认模型：
qwen3.6-plusOpus 默认模型：
qwen3.6-plus
回到主界面，点击该供应商右侧启用按钮，然后新开一个 Claude Code 会话使配置生效。
接入 Claude Code 桌面版
从 Claude 下载页安装 Claude Code 桌面版。
顶部菜单Help→Troubleshooting→Enable Developer Mode，重启后顶部出现Developer菜单。
Developer→Configure Third-Party Inference，Connection选Gateway，按下表填写后点击Apply locally：
字段
填写
Gateway base URL
CC Switch 路由监听地址，默认
http://127.0.0.1:15721，如已修改则与下一步保持一致。Gateway API key
百炼 API Key
Gateway auth scheme
bearer
Model list
Model ID 须为 Anthropic 风格，如
claude-opus-4.7。实际调用模型由 CC Switch 路由决定，对应关系即供应商高级选项中的模型映射。Display name 仅影响下拉显示。CC Switch 左上角设置 →路由，开启路由总开关，监听地址默认
127.0.0.1:15721，如需修改请同步上一步。在桌面版模型下拉选择已配置的模型 ID 即可使用。
Claude Code IDE 插件
完成上述 CLI 配置后，可在 IDE 中安装 Claude Code 插件，直接复用settings.json中的配置。
VS Code
在扩展市场中搜索
Claude Code for VS Code并安装。重启 VS Code，点击右上角图标进入 Claude Code。
在对话框中输入
/，选择 General config，在 Selected Model 中设置模型。
JetBrains
在扩展市场中搜索
Claude Code并安装。重启 IDE，点击右上角图标即可使用。
常见问题
错误码
配置过程中遇到报错，请参考对应计费方案的常见问题文档：
按量付费：Anthropic API兼容 - 错误码
Coding Plan：Coding Plan 常见问题
Token Plan 团队版：Token Plan 团队版常见问题
启动 Claude Code 后，界面显示"Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"
该错误表示 Claude Code 尝试连接 Anthropic 官方服务而非阿里云百炼服务端，通常是因为环境变量未正确配置或未生效。请按以下步骤排查：
检查配置：启动 Claude Code 后，执行
/status命令，确认ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN的值是否正确指向百炼地址。如果输出为空或指向非百炼地址，请检查settings.json配置是否正确。确认 hasCompletedOnboarding：检查
~/.claude.json文件中hasCompletedOnboarding是否设置为true，否则 Claude Code 启动时会尝试连接 Anthropic 官方服务进行登录验证。重新打开终端：修改配置文件后，需要打开一个新的终端窗口，再执行
claude命令以使配置生效。
使用旧版接口，切换模型不生效
旧版兼容接口https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy仅支持qwen3-coder-plus模型，指定其他模型不会生效。如需调用其他模型，请按本文配置迁移至新版接口。