在编程的艺术世界里代码和灵感需要寻找到最佳的交融点才能打造出令人为之惊叹的作品。而在这座秋知叶i博客的殿堂里我们将共同追寻这种完美结合为未来的世界留下属于我们的独特印记。【Agent】Claude Code CLI 接入阿里 Token Plan 保姆级教程摘要开发环境一、核心原理 用「助理-翻译-专家」讲懂三者关系1.1 Claude Code CLIAI 智能代理 Agent1.2 CC SwitchAI 编程统一配置管理工具1.3 阿里 Token Plan底层大模型推理服务1.4 整体流程总结1.5 架构图二、环境准备 Windows 下必装的 3 样东西缺一不可2.1 必备工具 Claude Code CLI2.2 必备工具 CC Switch v3.19.12.3 API密钥三、实操步骤 ️小白直接照抄3.1 启动 CC Switch3.2 如果没有看到 Claude Code 选项3.3 添加新供应商3.4 选择自定义配置3.5 填写供应商名称3.6 配置 API Key3.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.28.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 11Claude Code2.1.220CC Switchv3.19.1一、核心原理 用「助理-翻译-专家」讲懂三者关系在动手配置前先把角色定位捋清楚不然配置永远只懂照抄、出问题不会排错。1.1 Claude Code CLIAI 智能代理 Agent定位全能代码智能助理角色类比你的专属私人技术助理能自主理解需求、写代码、查 Bug、分析工程、编排多智能体并行任务核心特性原生遵循 Anthropic Messages API 规范可通过本地代理方式经 CC Switch 协议转换后对接阿里 Token Plan 接口。1.2 CC SwitchAI 编程统一配置管理工具定位跨平台 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 架构图Anthropic Messages格式请求携带密钥转发格式转换Chat Completions结果返回转回Anthropic格式回传支撑运行接口授权Claude Code CLIAI智能代理AgentCC Switch配置管理器/内置代理阿里 Token Plan云端大模型服务Windows系统端口/运行环境阿里 Token Plan API密钥统一鉴权二、环境准备 Windows 下必装的 3 样东西缺一不可在实操前先把环境准备好避免中途卡壳。所有工具都选 Windows 版本。2.1 必备工具 Claude Code CLIClaude Code CLI【Claude Code】Windows11 国内 一键安装保姆级教程WinGet官方纯享版2.2 必备工具 CC Switch v3.19.1CC Switch v3.19.12.3 API密钥阿里 Token Plan API 密钥在阿里百炼平台申请三、实操步骤 ️小白直接照抄3.1 启动 CC Switch双击打开 CC Switch。在顶部工具栏切换到Claude Code配置面板。3.2 如果没有看到 Claude Code 选项如果没有看到 Claude Code 选项进入 设置 → 通用。勾选上Claude Code以启用支持。这里要注意 不是Claude Desktop3.3 添加新供应商点击右上角的号。3.4 选择自定义配置选择自定义配置。3.5 填写供应商名称找到「供应商名称」栏填写百炼-Token Plan3.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图片生成HappyHorsehappyhorse-1.1-i2v视频生成HappyHorsehappyhorse-1.1-t2v视频生成HappyHorsehappyhorse-1.1-r2v视频生成DeepSeekdeepseek-v4-pro文本生成、推理模型DeepSeekdeepseek-v4-flash-0731文本生成、推理模型DeepSeekdeepseek-v4-flash文本生成、推理模型DeepSeekdeepseek-v3.2文本生成、推理模型智谱AIglm-5.2文本生成、推理模型智谱AIglm-5.1文本生成、推理模型智谱AIglm-5文本生成、推理模型月之暗面kimi-k2.7-code文本生成、推理模型、视觉理解月之暗面kimi-k2.6文本生成、推理模型、视觉理解月之暗面kimi-k2.5文本生成、推理模型、视觉理解MiniMaxMiniMax-M2.5文本生成、推理模型3.11 配置大模型3.11.1 模型角色说明角色在 Claude Code 里的用途能力等级Sonnet默认主力模型/model 菜单的默认别名90% 的日常对话、编码任务都走它平衡能力与成本3Opus高端旗舰档复杂重构、疑难 bug 排查、架构设计等高难度任务时手动切换使用2Fable比 Opus 更高一档的公开旗舰Mythos 级目前公开可用的最强 Claude面向超大型、长周期的复杂项目1Haiku轻量快速档简单问答、代码搜索、格式化、小任务成本最低4Subagent子代理Task 工具派生出的独立执行单元可指定不同模型轻量子代理普遍选用 Haiku兼顾工具调用稳定性与低成本-非独立模型能力随底层分配的模型浮动3.11.2 模型配置参考以下为推荐配置方案供参考执行模型名称填写建议从前文列出的阿里官方支持模型列表中直接复制模型名称避免手动输入造成名称多字、漏字确保配置准确。显示名称规则将复制的模型名称填入「实际请求模型」字段后系统将自动填充显示名称该字段无需手动配置。1M 配置项1M 对应的所有选项请全部勾选。3.11.3 默认兜底模型我直接选glm-5.21M 勾上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 对接大模型的核心不在于堆砌工具而在于理清协议、中转、鉴权三者的底层逻辑懂原理才不会只会无脑抄配置。