全部产品
Search
文档中心

:Claude Code

更新时间:Jul 23, 2026

在 Claude Code 中配置与使用阿里云百炼 Token Plan 团队版。

安装与使用

手动安装

macOS/Linux

  1. 安装或更新 Node.js(v18.0 或更高版本)。

  2. 在终端中执行下列命令,安装 Claude Code。

    npm install -g @anthropic-ai/claude-code
  3. 运行以下命令验证安装。若有版本号输出,则表示安装成功。

    claude --version

Windows

在 Windows 上使用 Claude Code,需要安装 WSL 或 Git for Windows,然后在 WSL 或 Git Bash 中执行以下命令。

npm install -g @anthropic-ai/claude-code
详情可以参考Claude Code官方文档的Windows安装教程

Qwen Code 引导安装

Claude Code 安装依赖于 Node.js 环境,手动安装可能会遇到环境配置问题。可以使用 Qwen Code 来完成安装和验证。

  1. 安装并配置 Qwen Code

  2. 在终端输入以下命令启动 Qwen Code。

    qwen
  3. 在 Qwen Code 对话框中输入以下指令。

    macOS/Linux

    请帮我安装 Claude Code。1. 前置条件:需要先安装 Node.js(v18.0 或更高版本)。2. 若已安装 Node.js,执行命令:npm install -g @anthropic-ai/claude-code,安装完成后执行 claude --version 验证安装是否成功。

    Windows

    请帮我安装 Claude Code。1. 前置条件:需要先安装 Node.js(v18.0 或更高版本)和 Git for Windows,如果没有安装请帮我安装。2. 若已满足前置条件,执行命令:npm install -g @anthropic-ai/claude-code,安装完成后执行 claude --version 验证安装是否成功。
  4. 授权允许Qwen Code 执行命令,直至完成安装。

  5. 输入/exit退出Qwen Code。

    /exit

配置 Token Plan 团队版

在 Claude Code 中接入百炼 Token Plan 团队版,需要配置以下信息:

  1. ANTHROPIC_BASE_URL:设置为 https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

  2. ANTHROPIC_AUTH_TOKEN:设置为 Token Plan 团队版专属 API Key

  3. ANTHROPIC_MODEL 等模型环境变量:设置为 Token Plan 团队版支持的模型。Claude Code 内部使用多个模型槽位处理不同任务,需要将全部槽位配置为 Token Plan 团队版支持的模型,否则未配置的槽位会尝试调用 Anthropic 官方模型导致请求失败。

    说明

    DeepSeek V3.2 不支持 Anthropic 协议接口,无法通过 Claude Code 使用,可通过 OpenCode 等支持 OpenAI 兼容协议的工具接入。图像生成模型需通过扩展机制(Skill、Slash Command 或 Agent)接入,参见接入多模态生成模型

macOS/Linux

  1. 创建并打开配置文件~/.claude/settings.json

    ~ 代表当前系统账户的主目录。如果 .claude 目录不存在,需要先行创建。可在终端执行 mkdir -p ~/.claude 来创建。
    nano ~/.claude/settings.json
  2. 编辑配置文件。将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.6-plus",
            "ANTHROPIC_SMALL_FAST_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"
        }
    }

    保存配置文件,重新打开一个终端即可生效。

  3. 编辑或新增 ~/.claude.json 文件,将hasCompletedOnboarding 字段的值设置为 true并保存文件。

    {
      "hasCompletedOnboarding": true
    }
    hasCompletedOnboarding 作为顶层字段,请勿嵌套于其他字段。

    该步骤可避免启动Claude Code时报错:Unable to connect to Anthropic services

Windows

  1. 创建并打开配置文件C:\Users\<用户名>\.claude\settings.json

    CMD

    1. 创建目录

      if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
    2. 创建并打开文件

      notepad "%USERPROFILE%\.claude\settings.json"

    PowerShell

    1. 创建目录

      mkdir -Force $HOME\.claude
    2. 创建并打开文件

      notepad $HOME\.claude\settings.json
  2. 编辑配置文件。将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.6-plus",
            "ANTHROPIC_SMALL_FAST_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"
        }
    }

    保存配置文件,重新打开一个终端即可生效。

  3. 编辑或新增 C:\Users\<用户名>\.claude.json 文件,将hasCompletedOnboarding 字段的值设置为 true,并保存文件。

    {
      "hasCompletedOnboarding": true
    }

使用 Claude Code

  1. 打开终端,并进入项目所在的目录。运行以下命令启动 Claude Code:

    cd path/to/your_project
    claude
  2. 启动后,需要授权 Claude Code 执行文件。

    image

  3. 输入/status确认模型、Base URL、API Key 是否配置正确。

  4. 在 Claude Code 中对话。

切换模型

  1. 启动 Claude Code 时切换:在终端执行claude --model <模型名称>指定模型并启动 Claude Code,例如claude --model glm-5

  2. 会话期间:在对话框输入/model <模型名称>命令切换模型,例如/model MiniMax-M2.5

说明

通过 --model/model 切换的是主对话模型(ANTHROPIC_MODEL)。如需长期使用其他模型,建议在 settings.json 中将全部模型槽位同步修改。

常见命令

命令

说明

示例

/init

在项目根目录生成 CLAUDE.md 文件,用于定义项目级指令和上下文。

/init

/status

查看当前模型、API Key、Base URL 等配置状态。

/status

/model <模型名称>

切换模型。

/model glm-5

/clear

清除对话历史,开始全新对话。

/clear

/plan

进入规划模式,仅分析和讨论方案,不修改代码。

/plan

/compact

压缩对话历史,释放上下文窗口空间。

/compact

/config

打开配置菜单,可设置语言、主题等。

/config

更多命令与用法详情,请参考 Claude Code 官方文档

使用 Claude Code IDE 插件

Claude Code IDE 插件支持在 VS Code、VS Code 系列 IDE(如 Cursor、Trae 等)、JetBrains 系列 IDE(如 IntelliJ IDEA、PyCharm 等)中使用。

VS Code

  1. 请先配置 Token Plan 团队版,Windows 还需要安装 WSL 或 Git for Windows

  2. 打开 VS Code,在扩展市场中搜索 Claude Code for VS Code 并安装。

    image

  3. 安装完成后,重启 VS Code。点击右上角图标进入 Claude Code 开始对话。

    image

    若在对话时弹出 Anthropic 登录界面,说明尚未配置 Token Plan 团队版,请先完成配置。

    image

  4. 切换模型:在 Claude Code 中切换模型配置,然后在 IDE 插件中新建对话即可生效。

JetBrains

  1. 请先安装 Claude Code,并配置 Token Plan 团队版

  2. 打开 JetBrains(如 IntelliJ IDEA、PyCharm 等),在扩展市场中搜索 Claude Code 并安装。

    image

  3. 安装后重启 IDE,点击右上角图标即可使用,可通过 /model <模型名称> 命令切换模型。

    image

    若在对话时出现 Not logged in. Please run /login 报错,说明尚未配置 Token Plan 团队版,请先完成配置。

    image

错误码

请参考常见问题

常见问题

第三方工具(如 CC Switch)提示“检查被拒 / Bad request (400)”或“不支持国内模型”怎么办?

原因:部分第三方管理工具(如 CC Switch)在切换或保存供应商时会发起“健康检查/连接测试”探测请求,该探测请求的格式与 Claude Code 实际调用的请求格式不同,百炼网关可能因此返回 400 Bad request 并提示“检查被拒”。此提示仅代表健康检查探测未通过,并不代表订阅无效或百炼不支持,也不影响 Claude Code 的实际使用。

解决方案:建议参照上文配置接入凭证,直接在 ~/.claude/settings.json 中完成配置,无需依赖第三方工具的健康检查结果;配置完成后启动 Claude Code,若能正常进入对话界面即表示可正常使用。

报错 API Error: Unable to connect to API (ECONNRESET)

该错误由 Claude Code 客户端的网络连接问题引起,与配置无关,通常会自行恢复。建议:

  1. 等待几分钟后重试。

  2. 检查网络连接是否正常。

  3. 如果使用了代理或 VPN,请关闭后重试。

  4. 将 Claude Code 升级到最新版本:npm install -g @anthropic-ai/claude-code@latest

报错 Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

该错误表示 Claude Code 尝试连接 Anthropic 官方服务而非 Token Plan 团队版服务端,通常是因为环境变量未正确配置或未生效。请按以下步骤排查:

  1. 检查配置文件:确认 ~/.claude/settings.json 中已正确配置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN

    # 查看当前配置
    cat ~/.claude/settings.json

    确认配置内容如下(请替换为实际 API Key):

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "qwen3.6-plus",
            "ANTHROPIC_SMALL_FAST_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"
        }
    }
  2. 检查环境变量是否冲突:如果同时通过环境变量和配置文件设置了 ANTHROPIC_BASE_URL,请确保两者指向相同的 Token Plan 团队版地址,避免冲突。执行以下命令检查:

    echo $ANTHROPIC_BASE_URL

    如果输出为空或指向非 Token Plan 团队版地址,请清除该环境变量或将其设置为正确的 Token Plan 团队版 Base URL。

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

  4. 重新打开终端:修改配置文件后,需要打开一个新的终端窗口,再执行 claude 命令以使配置生效。

更多常见问题请参考常见问题

最佳实践

1. 上下文管理
  • 及时清理: 使用 /clear 定期重置对话,防止旧的上下文干扰新任务并节省 Token。

  • 主动压缩:使用 /compact 命令让 Claude 总结关键决策和修改的文件,保留核心记忆。

  • 明确指定文件: 提问时使用 @ 引用文件(如 write a test for @auth.py),避免模型无效扫描整个项目。

  • 善用子代理(Sub-agents): 对于大规模任务,让 Claude 启动子代理执行。子代理完成任务后返回精炼结论,保护主对话的上下文空间。

2. 先计划,再执行
  • 启用 Plan 模式:复杂任务前,先分析方案,不实际修改文件。

    • 提示词约束:提示词明确要求"先输出详细实施计划,经我确认后再修改文件"。

  • 降低试错成本:确保逻辑闭环后再进行代码变更。

3. 沉淀项目核心知识:编写 CLAUDE.md
  • 包含关键信息:每次会话启动时自动加载CLAUDE.md,建议填入构建命令、代码规范及工作流等通用规则。

  • 动态维护:内容应简短易读,仅记录广泛适用的全局约定,并随项目演进持续补充新规则。

4. 扩展能力:MCP 与 Skills
  • MCP:安装成熟的 MCP Server,连接外部服务。

  • Skills:编写详细的 Skill 描述文案。Claude 决定是否调用该工具,取决于对该工具用途的定义。

  • Skills vs MCP:Skills 教会 Claude "怎么做"(工作流知识),MCP 给 Claude"做的工具"(外部接口)。两者互补,Skills 也可集成外部接口。

5. 自动化守护:Hooks
  • 使用Hooks:Hooks 是确定性规则。它在 Claude 工作流的特定生命周期节点(如 PreToolUse 工具执行前校验等)自动运行本地脚本,确保关键校验或操作 100% 执行。

  • 配置方式

    1. 运行 /hooks 进行交互式配置。

    2. 直接编辑 .claude/settings.json

    3. 让 Claude 帮你编写,如:"编写一个在每次文件编辑后运行 eslint 的 hook"。

6. 建立自检闭环
  • 强制验证: 要求 Claude 修改代码后,必须运行相关的测试用例(如 pytestnpm test)。

  • 定义成功标准: "修改完成后,请确保编译通过,并且运行 curl 命令验证 API 返回值为 200"。

  • 视觉反馈: 前端修改时,要求 Claude 截取浏览器截图来确认 UI 效果。