- 在编程的艺术世界里，代码和灵感需要寻找到最佳的交融点，才能打造出令人为之惊叹的作品。
- 而在这座秋知叶i博客的殿堂里，我们将共同追寻这种完美结合，为未来的世界留下属于我们的独特印记。
【Agent】Claude Code CLI 接入阿里 Token Plan 保姆级教程
- 摘要
- 开发环境
- 一、核心原理 🧠｜用「助理-翻译-专家」讲懂三者关系
- 1.1 Claude Code CLI（AI 智能代理 Agent）
- 1.2 CC Switch（AI 编程统一配置管理工具）
- 1.3 阿里 Token Plan（底层大模型推理服务）
- 1.4 整体流程总结
- 1.5 架构图
- 二、环境准备 📦｜Windows 下必装的 3 样东西（缺一不可）
- 2.1 必备工具 Claude Code CLI
- 2.2 必备工具 CC Switch v3.19.1
- 2.3 API密钥
- 三、实操步骤 🛠️｜小白直接照抄
- 3.1 启动 CC Switch
- 3.2 如果没有看到 Claude Code 选项
- 3.3 添加新供应商
- 3.4 选择自定义配置
- 3.5 填写供应商名称
- 3.6 配置 API Key
- 3.7 配置请求地址
- 3.8 高级选项-API格式
- 3.9 高级选项-认证字段
- 3.10 阿里支持的模型
- 3.11 配置大模型
- 3.11.1 模型角色说明
- 3.11.2 模型配置参考
- 3.11.3 默认兜底模型
- 3.12 完成供应商添加
- 五、开启全局路由功能
- 六、CC Switch 测试连接
- 6.1 开启 Claude Code 路由功能
- 6.2 测试API连接
- 七、CC Switch 将配置写入 Claude Code
- 八、Claude Code CLI 选择阿里 Token Plan 模型
- 8.1 查看可用模型
- 8.2 切换到 GLM-5.2
- 8.3 验证链路是否打通
- 九、常见问题与避坑指南
- 9.1 配置后 /model 不显示自定义模型
- 9.2 连接报错 401/鉴权失败
- 十、总结与进阶 🚀
- 十一、【💡 小课堂】Claude Code CLI 实用技巧
- 十二、【💻 编程冷笑话】
- 十三、【✨ 今日金句】
摘要
- Windows 环境下想用最新 Claude Code CLI 这款 AI 智能代理，通过 CC Switch 对接阿里 Token Plan 大模型，很多人都会卡在端口占用、配置错误、协议不兼容等问题上。
- 本文以秋知叶i实战视角，精准定位 Claude Code CLI、CC Switch、阿里 Token Plan 三者真实角色。
- 从原理科普、环境准备到一步步实操配置，搭配架构图和高频避坑方案，小白可直接照抄部署，老手也能快速理清 Agent 对接大模型的底层逻辑。
开发环境
- 开发系统：Windows 11
- Claude Code：2.1.220
- CC Switch：v3.19.1
一、核心原理 🧠｜用「助理-翻译-专家」讲懂三者关系
- 在动手配置前，先把角色定位捋清楚，不然配置永远只懂照抄、出问题不会排错。
1.1 Claude Code CLI（AI 智能代理 Agent）
- 定位：全能代码智能助理
- 角色类比：你的专属私人技术助理，能自主理解需求、写代码、查 Bug、分析工程、编排多智能体并行任务；
- 核心特性：原生遵循 Anthropic Messages API 规范，可通过本地代理方式，经 CC Switch 协议转换后对接阿里 Token Plan 接口。
1.2 CC Switch（AI 编程统一配置管理工具）
- 定位：跨平台 AI 编码助手一站式配置管理器
- 角色类比：专门接管所有 AI 编程工具配置文件的管家，不用再手动改 JSON/TOML/.env；
- 核心特性：内置本地 HTTP 代理，一键切换模型供应商，统一管理 Claude Code CLI 等工具的密钥与接口，并自动完成 Anthropic 与 Chat Completions 双向协议格式转换。
1.3 阿里 Token Plan（底层大模型推理服务）
- 定位：云端大模型 API 算力服务
- 角色类比：后台资深技术专家，只专注做模型推理、生成回答；
- 核心特性：对外提供标准 OpenAI Chat Completions 兼容接口，需要通过 API 密钥鉴权，支持高并发调用（阿里百炼 Token Plan）。
1.4 整体流程总结
- 真实链路：
- Claude Code CLI (AI Agent) → CC Switch (本地代理转发+协议转换) → 阿里 Token Plan (大模型服务)
- Agent 发 Anthropic 格式请求 → CC 代理转发并携带鉴权信息、完成格式适配 → 阿里 Token Plan 推理返回 → 原路回传给 Claude Code CLI。
1.5 架构图
二、环境准备 📦｜Windows 下必装的 3 样东西（缺一不可）
- 在实操前，先把环境准备好，避免中途卡壳。所有工具都选 Windows 版本。
2.1 必备工具 Claude Code CLI
- Claude Code CLI
- 【Claude Code】Windows11 国内 一键安装保姆级教程｜WinGet官方纯享版
2.2 必备工具 CC Switch v3.19.1
- CC Switch v3.19.1
2.3 API密钥
- 阿里 Token Plan API 密钥（在阿里百炼平台申请）
三、实操步骤 🛠️｜小白直接照抄
3.1 启动 CC Switch
- 双击打开 CC Switch。
- 在顶部工具栏切换到Claude Code配置面板。
3.2 如果没有看到 Claude Code 选项
- 如果没有看到 Claude Code 选项，进入 设置 → 通用。
- 勾选上Claude Code以启用支持。
- 这里要注意 不是
Claude Desktop
3.3 添加新供应商
- 点击右上角的
+号。
3.4 选择自定义配置
- 选择自定义配置。
3.5 填写供应商名称
- 找到「供应商名称」栏
- 填写
百炼-Token Plan
3.6 配置 API Key
- 往下滑找到API Key。
- 在这里填写你在阿里百炼平台申请的 API Key。
3.7 配置请求地址
- 往下滑找到请求地址。
- 填写百炼 Token Plan 的专属请求地址：
https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic💡注意：这个地址是阿里 Token Plan 的专属端点，不要和百炼普通的 OpenAI 兼容端点（
dashscope.aliyuncs.com）搞混了。
3.8 高级选项-API格式
- 往下滑找到高级选项-API格式。
- 默认选择Anthropic Messages (原生)
3.9 高级选项-认证字段
- 往下滑找到高级选项-认证字段。
- 默认选择ANTHROPIC_AUTH_TOKEN
- 几乎所有 OpenAI 兼容服务，都是 Bearer 鉴权
3.10 阿里支持的模型
- 截止时间：2026年8月6日
| 品牌 | 模型 | 模型能力 |
|---|---|---|
| 千问 | qwen3.8-max | 文本生成、推理模型、视觉理解 |
| 千问 | qwen3.7-plus | 文本生成、推理模型、视觉理解 |
| 千问 | qwen3.7-max | 文本生成、推理模型 |
| 千问 | qwen3.6-plus | 文本生成、推理模型、视觉理解 |
| 千问 | qwen3.6-flash | 文本生成、推理模型、视觉理解 |
| 千问 | qwen-audio-3.0-tts-plus | 实时语音合成 |
| 千问 | qwen-image-2.0 | 图片生成 |
| 千问 | qwen-image-2.0-pro | 图片生成 |
| 千问 | qwen-audio-3.0-realtime-plus | 实时语音对话 |
| 万相 | wan2.7-image | 图片生成 |
| 万相 | wan2.7-image-pro | 图片生成 |
| HappyHorse | happyhorse-1.1-i2v | 视频生成 |
| HappyHorse | happyhorse-1.1-t2v | 视频生成 |
| HappyHorse | happyhorse-1.1-r2v | 视频生成 |
| DeepSeek | deepseek-v4-pro | 文本生成、推理模型 |
| DeepSeek | deepseek-v4-flash-0731 | 文本生成、推理模型 |
| DeepSeek | deepseek-v4-flash | 文本生成、推理模型 |
| DeepSeek | deepseek-v3.2 | 文本生成、推理模型 |
| 智谱AI | glm-5.2 | 文本生成、推理模型 |
| 智谱AI | glm-5.1 | 文本生成、推理模型 |
| 智谱AI | glm-5 | 文本生成、推理模型 |
| 月之暗面 | kimi-k2.7-code | 文本生成、推理模型、视觉理解 |
| 月之暗面 | kimi-k2.6 | 文本生成、推理模型、视觉理解 |
| 月之暗面 | kimi-k2.5 | 文本生成、推理模型、视觉理解 |
| MiniMax | MiniMax-M2.5 | 文本生成、推理模型 |
3.11 配置大模型
3.11.1 模型角色说明
| 角色 | 在 Claude Code 里的用途 | 能力等级 |
|---|---|---|
| Sonnet | 默认主力模型，/model 菜单的默认别名，90% 的日常对话、编码任务都走它，平衡能力与成本 | 3 |
| Opus | 高端旗舰档，复杂重构、疑难 bug 排查、架构设计等高难度任务时手动切换使用 | 2 |
| Fable | 比 Opus 更高一档的公开旗舰（Mythos 级），目前公开可用的最强 Claude，面向超大型、长周期的复杂项目 | 1 |
| Haiku | 轻量快速档，简单问答、代码搜索、格式化、小任务，成本最低 | 4 |
| Subagent | 子代理（Task 工具派生出的独立执行单元），可指定不同模型；轻量子代理普遍选用 Haiku，兼顾工具调用稳定性与低成本 | -（非独立模型，能力随底层分配的模型浮动） |
3.11.2 模型配置参考
- 以下为推荐配置方案，供参考执行：
- 模型名称填写：建议从前文列出的阿里官方支持模型列表中直接复制模型名称，避免手动输入造成名称多字、漏字，确保配置准确。
- 显示名称规则：将复制的模型名称填入「实际请求模型」字段后，系统将自动填充显示名称，该字段无需手动配置。
- 1M 配置项：1M 对应的所有选项请全部勾选。
3.11.3 默认兜底模型
- 我直接选
glm-5.2 - 1M 勾上
3.12 完成供应商添加
- 以上所有配置确认无误后
- 直接点击右下角「添加」按钮完成配置。
五、开启全局路由功能
- 点击 设置 - 路由
- 把这两个勾选上
六、CC Switch 测试连接
6.1 开启 Claude Code 路由功能
- 回到 CC Switch 的Claude Code配置界面。
- 点击这个按钮 启用 。会变成绿色
6.2 测试API连接
- 回到 CC Switch 的Claude Code配置界面。
- 点击对应供应商的「测试」按钮。
- 显示「连通正常」且状态为绿色，代表接口配置无误。
七、CC Switch 将配置写入 Claude Code
- 我们要让 Claude Code CLI 识别到阿里 Token Plan 的配置。
- 在 CC Switch 的 Claude Code 面板底部，点击「启用」按钮
- 会自动将配置写入 Claude Code 的配置文件
- 添加成功后，按钮文字会从「启用」变成「使用中」。
八、Claude Code CLI 选择阿里 Token Plan 模型
- 重启终端，重新启动 Claude Code CLI，让配置生效。
- 若 CLI 正在运行，需完全退出后重新进入。
8.1 查看可用模型
- 在 Claude Code CLI 中输入
/model命令。 - 列表中会出现我们在 CC Switch 里配置的自定义大模型。
8.2 切换到 GLM-5.2
- 在
/model列表中键盘上下按键可以上下移动 - 选择
glm-5.2对应的条目，回车 - 切换为主力模型。
8.3 验证链路是否打通
- 发一句话测试：
你好，你是谁？ - 能正常收到回复、就说明阿里 Token Plan 的链路已经完全打通。
- 模型回复中自称 Claude 属于正常现象（代理层会保留原生交互体验），以实际接口调用成功为准。
九、常见问题与避坑指南
9.1 配置后 /model 不显示自定义模型
- 确认 CC Switch 中已点击「添加」写入配置
- 必须完全退出 Claude Code CLI 后重新启动，配置文件才会重新加载
9.2 连接报错 401/鉴权失败
- 检查 API Key 是否复制完整，有无多余空格
- 确认 Token Plan 服务已在阿里百炼控制台开通
- 核对请求地址是否为 Token Plan 专属端点，不要误用普通百炼接口
十、总结与进阶 🚀
- 整套部署核心逻辑：Claude Code CLI 通过 CC Switch 本地代理转发请求，由 CC Switch 统一托管 API 密钥并完成 Anthropic 与 Chat Completions 双向协议转换，快速完成阿里 Token Plan 大模型对接。
- 核心流程：配置 CC Switch 供应商 → 写入 Claude Code 配置文件 → 开启本地路由代理 → Claude Code 绑定自定义模型 → 连通测试。
十一、【💡 小课堂】Claude Code CLI 实用技巧
- Claude Code CLI 支持多会话并行，你可以同时开启多个终端会话，让它们分别处理前端、后端和测试任务，互不干扰。
- 最实用的上下文管理技巧：当对话过长时，可以手动开启新会话来重置上下文，大幅节省 Token 消耗。
- 配合阿里 Token Plan 服务，长上下文支持极佳，写大项目遇到复杂逻辑时，随时切换不同模型对比答案，全程不用中断工作流。
十二、【💻 编程冷笑话】
- 为什么 Claude Code AI Agent 不能直接找阿里 Token Plan 对接？
- 因为两者的协议方言不一样（Claude 原生 Messages API vs 百炼 Chat Completions 端点），还好有 CC Switch 当专业翻译官，不然根本聊不到一块去。
十三、【✨ 今日金句】
- AI Agent 对接大模型的核心不在于堆砌工具，而在于理清协议、中转、鉴权三者的底层逻辑，懂原理才不会只会无脑抄配置。
