Claude Code

安装

npm install -g @anthropic-ai/claude-code

跳过登录验证

编辑或新建 ~/.claude.json（Windows 路径：C:\Users\<用户名>\.claude.json），将 hasCompletedOnboarding 设为 true，跳过 Anthropic 官方登录验证。

{
  "hasCompletedOnboarding": true
}

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.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

提示：上述配置将 CLAUDE_CODE_SUBAGENT_MODEL 设为 qwen3.7-max，子任务（如文件搜索、Plan 模式）将使用该模型。如需子任务也使用 qwen3.8-max，可将 CLAUDE_CODE_SUBAGENT_MODEL 改为 qwen3.8-max。

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.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

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.7-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
    }
}

按量计费

将 YOUR_API_KEY 替换为阿里云百炼API Key。可用模型参见Anthropic 兼容 API。

ANTHROPIC_BASE_URL 按地域设置，API Key 需与所选地域对应，并将WorkspaceId替换为真实的 Workspace ID：

• 华北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic

• 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
    }
}

配置上下文窗口大小

Claude Code 默认使用 200K 上下文窗口。如果需要处理大型代码仓库或长对话，可以将上下文窗口扩展到 1M（1,000,000 tokens），前提是所用模型支持该上下文长度。有两种配置方式：

方式一：通过环境变量设置

在 ~/.claude/settings.json 的 env 字段中添加 CLAUDE_CODE_MAX_CONTEXT_TOKENS：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}

方式二：通过模型名称后缀

在模型名称后添加 [1m] 后缀，适用于百炼支持 1M 上下文的模型：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}

修改配置后，需新开终端窗口重新启动 Claude Code 使配置生效。更多环境变量说明参见 Claude Code 官方环境变量文档。

安装

• 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。

添加供应商

1. 在 CC Switch 主界面顶部图标栏选中 Claude Code 橙色星形图标，点击右上角 + 进入添加新供应商，按下表填入配置后点击添加。

   计费方案	配置信息
   Token Plan 个人版	供应商名称：百炼-Token Plan 个人版 API Key：控制台获取 请求地址：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
   Token Plan 团队版	供应商名称：百炼-Token Plan 团队版 API Key：控制台获取 请求地址：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
   Coding Plan	供应商名称：百炼-Coding Plan API Key：控制台获取 请求地址：https://coding.dashscope.aliyuncs.com/apps/anthropic
   按量计费	供应商名称：百炼-按量计费 API Key：百炼API Key 请求地址：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic

2. 展开高级选项配置模型映射，将主模型与 Haiku、Sonnet、Opus 默认模型设置为对应套餐支持的模型。映射关系按需选择，示例如下：

   • 主模型：qwen3.7-max（Coding Plan 不支持）

   • Haiku 默认模型：qwen3.6-flash（Coding Plan 不支持）

   • Sonnet 默认模型：qwen3.7-max（Coding Plan 不支持）

   • Opus 默认模型：qwen3.7-max（Coding Plan 不支持）

3. 回到主界面，点击该供应商右侧启用按钮，然后新开一个 Claude Code 会话使配置生效。

接入 Claude Code 桌面版

Claude Code 桌面版（Claude Desktop）与 Claude Code CLI 是两个独立入口，在 CC Switch 中分别对应 Claude Code 与 Claude Desktop 面板。桌面版通过 CC Switch 本地网关访问百炼：网关地址与鉴权令牌均由 CC Switch 自动写入桌面版配置，无需在桌面版中手动填写百炼 API Key——百炼 API Key 只在 CC Switch 供应商配置中填写，由本地路由转发时自动注入。

1. 从 Claude 下载页安装 Claude Code 桌面版。

2. 在 CC Switch 左侧应用切换器切换到 Claude Desktop 面板。若未显示该入口，前往设置 → 通用 → 应用可见性确认 Claude Desktop 未被隐藏。

3. 添加百炼供应商：若已在 Claude Code 面板配置过百炼供应商，可点击将 Claude Code 中已有的供应商导入一键复用；也可点击右上角 + 新增。由于百炼模型 ID（如 qwen3.7-max）不是 Claude Desktop 识别的 claude-sonnet-* / claude-opus-* / claude-haiku-* 三档角色 ID，需开启需要模型映射，为 Sonnet、Opus、Haiku 三档分别填写实际请求的百炼模型（如 Sonnet → qwen3.7-max）。

4. 开启本地路由：前往设置 → 路由 → 本地路由，打开在主页面显示本地路由开关；回到 Claude Desktop 面板，打开 Claude Desktop 本地路由开关，监听地址默认 127.0.0.1:15721。

5. 在供应商卡片点击启用，CC Switch 会自动将第三方推理配置写入 Claude Code 桌面版。

6. 保持 CC Switch 运行，完全退出并重启 Claude Code 桌面版后生效，在模型菜单中选择已配置的模型即可使用。

VS Code

1. 在扩展市场搜索 Claude Code for VS Code 并安装。

2. 重启 VS Code，点击右上角图标进入 Claude Code。

3. 在对话框中输入 /，选择 General config，在 Selected Model 中设置模型。

JetBrains

1. 在扩展市场搜索 Claude Code 并安装。

2. 重启 IDE，点击右上角图标即可使用。

错误码

配置过程中遇到报错，参考对应套餐的常见问题文档：

• 按量计费：Anthropic API兼容 - 错误码

• Coding Plan：Coding Plan 常见问题

• Token Plan 个人版：Token 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 官方服务而非阿里云百炼。通常是环境变量未正确配置或未生效。按以下步骤排查：

1. 检查配置。启动 Claude Code 后执行 /status 命令，确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否正确指向百炼地址。输出为空或指向非百炼地址时，检查 settings.json 配置是否正确。

2. 确认 hasCompletedOnboarding。检查 ~/.claude.json 文件中 hasCompletedOnboarding 是否设置为 true。未设置时，Claude Code 启动后会尝试连接 Anthropic 官方服务进行登录验证。

3. 重新打开终端。修改配置文件后，需要新开一个终端窗口再执行 claude，配置才会生效。

4. 更新 Claude Code。若以上步骤均无效，可能是 Claude Code 版本过旧导致。执行 npm install -g @anthropic-ai/claude-code@latest 更新到最新版本后重试。

使用旧版接口，切换模型不生效

旧版兼容接口 https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy 仅支持 qwen3-coder-plus 模型，指定其他模型不会生效。如需调用其他模型，按本文配置迁移至新版接口。

使用 CC Switch 添加供应商时提示"未找到可用的模型列表端点，请检查 Base URL 或确认供应商是否开放端口"

该提示来自 CC Switch 保存供应商时的连通性检查——它会向配置的请求地址探测模型列表端点（如 /v1/models）。百炼的 Anthropic 兼容接入端点（以 /apps/anthropic 结尾）仅提供对话端点 /v1/messages，不提供模型列表端点，该探测因此返回 404，CC Switch 据此提示"未找到可用的模型列表端点"。

该提示不影响 Claude Code 正常使用，可忽略。Claude Code 通过 /v1/messages 发起对话，所用模型由 CC Switch 高级选项中的模型映射直接指定，不依赖模型列表端点的自动发现。请求地址与 API Key 配置正确时，直接点击启用并新开一个 Claude Code 会话即可正常对话。

若确实无法对话，请确认：请求地址以 /apps/anthropic 结尾、勿额外添加 /v1，并已在高级选项的模型映射中填入对应套餐支持的模型。