当前位置：首页 > news >正文

【Agent】Claude Code CLI 接入阿里 Token Plan 保姆级教程

news 2026/8/7 7:53:48

在编程的艺术世界里，代码和灵感需要寻找到最佳的交融点，才能打造出令人为之惊叹的作品。
而在这座秋知叶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 绑定自定义模型 → 连通测试。