Claude Code - 千问云

安装 Claude Code

macOS/Linux
Windows

安装或更新 Node.js（v18.0 或更高版本）。
在终端中执行下列命令，安装 Claude Code。

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

运行以下命令验证安装。若有版本号输出，则表示安装成功。

claude --version

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

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

详情可参考 Claude Code 官方文档的 Windows 安装教程。

配置 Token Plan 团队版

在 Claude Code 中接入 Token Plan 团队版，需要配置以下信息：

ANTHROPIC_BASE_URL：设置为 https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic。
ANTHROPIC_AUTH_TOKEN：设置为 Token Plan 团队版专属 API Key。
ANTHROPIC_MODEL：设置为 Token Plan 团队版支持的模型。

macOS/Linux
Windows

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

~ 代表当前系统账户的主目录。如果 .claude 目录不存在，需要先行创建。可在终端执行 mkdir -p ~/.claude 来创建。

nano ~/.claude/settings.json

编辑配置文件。将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。

{
    "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"
    }
}

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

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

{
  "hasCompletedOnboarding": true
}

hasCompletedOnboarding 作为顶层字段，请勿嵌套于其他字段。该步骤可避免启动 Claude Code 时报错：Unable to connect to Anthropic services。

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

CMD
PowerShell

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

创建并打开文件

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

编辑配置文件。将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。

{
    "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"
    }
}

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

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

{
  "hasCompletedOnboarding": true
}

配置按量计费

将 YOUR_API_KEY 替换为千问云 API Key。可用模型请参考支持的模型。

配置项	说明
Base URL	`https://dashscope.aliyuncs.com/apps/anthropic`
API Key	千问云 API Key（格式为 `sk-xxxxx`）
可用模型	支持的模型

创建或编辑 ~/.claude/settings.json（Windows 路径：C:\Users\<用户名>\.claude\settings.json），写入以下配置：

{
  "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 "你好"。若模型正常返回响应，配置成功。如需进一步确认，在 Claude Code 中执行 /status，检查 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否正确指向千问云地址。

使用 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/anthropic`
按量计费	供应商名称：千问云-按量计费 API Key：控制台获取请求地址：`https://dashscope.aliyuncs.com/apps/anthropic`

展开高级选项配置模型映射，将主模型与 Haiku、Sonnet、Opus 默认模型填为对应方案支持的模型。具体映射关系按需选择，例如：
- 主模型：qwen3.6-plus
- Haiku 默认模型：qwen3.6-flash
- Sonnet 默认模型：qwen3.6-plus
- Opus 默认模型：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

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

cd path/to/your_project
claude

启动后，需要授权 Claude Code 执行文件。
输入 /status 确认模型、Base URL、API Key 是否配置正确。
在 Claude Code 中对话。

切换模型

启动 Claude Code 时切换：在终端执行 claude --model <模型名称> 指定模型并启动 Claude Code，例如 claude --model qwen3.6-plus。
会话期间：在对话框输入 /model <模型名称> 命令切换模型，例如 /model qwen3.6-plus。

接入图像生成模型

通过 Claude Code 的斜杠命令（Slash Command），可以调用 Token Plan 团队版的图像生成模型（qwen-image-2.0、wan2.7-image 等）。

步骤一：创建斜杠命令

在项目根目录创建 .claude/commands/text-to-image.md，写入以下内容：

调用 Token Plan 文生图 API，根据描述生成图像。

用户需求：$ARGUMENTS

## 执行步骤

1. 从用户需求中提取 prompt（图像描述）、model（默认 qwen-image-2.0）、size（默认 1024*1024）。

2. 调用 API 生成图像（使用 Bash 工具执行 curl）：

```
curl -s -X POST "https://token-plan.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型>",
    "input": {
      "messages": [{"role":"user","content":[{"text":"<prompt>"}]}]
    },
    "parameters": {"size":"<尺寸>"}
  }'
```

3. 从返回 JSON 的 output.choices[*].message.content[*].image 提取图像 URL。

4. 用 curl -s -o "generated_$(date +%Y%m%d_%H%M%S).png" "<URL>" 下载到当前目录。

5. 向用户展示生成的图片文件路径。

## 可用模型

- qwen-image-2.0（默认）— 通用，擅长中文文本渲染
- qwen-image-2.0-pro — 质量更高
- wan2.7-image — 多风格，默认出 4 张
- wan2.7-image-pro — 支持 4K

## 可用尺寸

1024*1024、720*1280、1280*720。wan2.7-image-pro 额外支持 2048*2048。

步骤二：使用

在 Claude Code 中输入 /text-to-image 画一只猫 即可生成图片。

常见命令

命令	说明	示例
`/init`	在项目根目录生成 CLAUDE.md 文件，用于定义项目级指令和上下文。	`/init`
`/status`	查看当前模型、API Key、Base URL 等配置状态。	`/status`
`/model <模型名称>`	切换模型。	`/model qwen3.6-plus`
`/clear`	清除对话历史，开始全新对话。	`/clear`
`/plan`	进入规划模式，仅分析和讨论方案，不修改代码。	`/plan`
`/compact`	压缩对话历史，释放上下文窗口空间。	`/compact`
`/config`	打开配置菜单，可设置语言、主题等。	`/config`

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

使用 IDE 插件

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

VS Code
JetBrains

请先完成配置 Token Plan 团队版，Windows 还需要安装 WSL 或 Git for Windows。
打开 VS Code，在扩展市场中搜索 Claude Code for VS Code 并安装。
安装完成后，重启 VS Code。点击右上角图标进入 Claude Code 开始对话。若在对话时弹出 Anthropic 登录界面，说明尚未完成配置 Token Plan 团队版，请先完成配置。
切换模型：参考切换模型完成配置后，在 IDE 插件中新建对话即可生效。

请先完成安装 Claude Code 和配置 Token Plan 团队版。
打开 JetBrains（如 IntelliJ IDEA、PyCharm 等），在扩展市场中搜索 Claude Code 并安装。
安装后重启 IDE，点击右上角图标即可使用，可通过 /model <模型名称> 命令切换模型。若在对话时出现 Not logged in. Please run /login 报错，说明尚未完成配置 Token Plan 团队版，请先完成配置。

常见问题

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

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

等待几分钟后重试。
检查网络连接是否正常。
如果使用了代理或 VPN，请关闭后重试。
将 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 团队版服务端，通常是因为环境变量未正确配置或未生效。请按以下步骤排查：

检查配置文件：确认 ~/.claude/settings.json 中已正确配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。

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

确认配置内容如下（请替换为实际 API Key）：

{
    "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"
    }
}

检查环境变量是否冲突：如果同时通过环境变量和配置文件设置了 ANTHROPIC_BASE_URL，请确保两者指向相同的 Token Plan 团队版地址，避免冲突。执行以下命令检查：

echo $ANTHROPIC_BASE_URL

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

确认 hasCompletedOnboarding：检查 ~/.claude.json 文件中 hasCompletedOnboarding 是否设置为 true，否则 Claude Code 启动时会尝试连接 Anthropic 官方服务进行登录验证。
重新打开终端：修改配置文件后，需要打开一个新的终端窗口，再执行 claude 命令以使配置生效。

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

如果之前使用旧版代理地址 https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy 接入，该地址仅支持 qwen3-coder-plus，修改 ANTHROPIC_MODEL 不会切换模型。请迁移到新版配置（Token Plan 团队版或按量计费），使用本文档中的 Base URL 和配置方式。

最佳实践

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 修改代码后，必须运行相关的测试用例（如 pytest 或 npm test）。
定义成功标准："修改完成后，请确保编译通过，并且运行 curl 命令验证 API 返回值为 200"。
视觉反馈：前端修改时，要求 Claude 截取浏览器截图来确认 UI 效果。

​安装 Claude Code

​配置 Token Plan 团队版

​配置按量计费

​使用 CC Switch

​安装

​添加供应商

​接入 Claude Code 桌面版

​使用 Claude Code

​切换模型

​接入图像生成模型

​步骤一：创建斜杠命令

​步骤二：使用

​常见命令

​使用 IDE 插件

​常见问题

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

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

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

​最佳实践

​1. 上下文管理

​2. 先计划，再执行

​3. 沉淀项目核心知识：编写 CLAUDE.md

​4. 扩展能力：MCP 与 Skills

​5. 自动化守护：Hooks

​6. 建立自检闭环

安装 Claude Code

配置 Token Plan 团队版

配置按量计费

使用 CC Switch

安装

添加供应商

接入 Claude Code 桌面版

使用 Claude Code

切换模型

接入图像生成模型

步骤一：创建斜杠命令

步骤二：使用

常见命令

使用 IDE 插件

常见问题

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

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

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

最佳实践

1. 上下文管理

2. 先计划，再执行

3. 沉淀项目核心知识：编写 CLAUDE.md

4. 扩展能力：MCP 与 Skills

5. 自动化守护：Hooks

6. 建立自检闭环