阿里云百炼 - Claude Code 配置指南

Claude Code 是 Anthropic 推出的命令行 AI 编程助手可以通过按量计费、Coding Plan 或 Token Plan 团队版接入阿里云百炼。安装 Claude Code安装macOSWindows在 Windows 上使用 Claude Code需要安装 WSL 或 Git for Windows然后在 WSL 或 Git Bash 中执行以下命令。npm install -g anthropic-ai/claude-code详情可以参考Claude Code官方文档的 Windows安装教程。跳过登录验证编辑或新增~/.claude.jsonWindows 路径C:\Users\用户名\.claude.json将hasCompletedOnboarding设置为true跳过 Anthropic 官方登录验证。{ hasCompletedOnboarding: true }配置接入凭证创建~/.claude/settings.jsonWindows 路径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 SwitchCC Switch 是社区开源的桌面 GUI可在多个 API Key 或计费方案之间一键切换免去手动改settings.json。安装macOSbrew tap farion1231/ccswitch brew install --cask cc-switch或从 Releases 下载.dmg。Windows从 Releases 下载.msi安装包或便携版.zip。LinuxArch 用paru -S cc-switch-bin其他发行版从 Releases 下载.deb/.rpm/.AppImage。添加供应商在 CC Switch 主界面顶部图标栏选中 Claude Code 橙色星形图标点击右上角进入添加新供应商按下表填入配置后点击添加。计费方案配置信息Token Plan 团队版供应商名称百炼-Token PlanAPI Key控制台获取请求地址https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropicCoding Plan供应商名称百炼-Coding PlanAPI 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 InferenceConnection选Gateway按下表填写后点击Apply locally字段填写Gateway base URLCC Switch 路由监听地址默认http://127.0.0.1:15721如已修改则与下一步保持一致。Gateway API key百炼 API KeyGateway auth schemebearerModel listModel 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 PlanCoding 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模型指定其他模型不会生效。如需调用其他模型请按本文配置迁移至新版接口。