【Claude Code 国内使用完整指南】CC-Switch + 智谱 GLM Coding Plan 全流程教程

文章目录Claude Code 国内使用完整指南CC-Switch 智谱 GLM Coding Plan 全流程教程一、整体方案架构说明二、第一步申请智谱 GLM Coding Plan2.1 注册智谱 AI 账号2.2 订阅 GLM Coding Plan2.3 获取 API Key三、第二步安装 CC-Switch3.1 什么是 CC-Switch3.2 下载 CC-Switch3.3 安装 CC-Switch四、第三步在 CC-Switch 中配置智谱4.1 认识 CC-Switch 主界面4.2 添加智谱供应商4.3 启用智谱供应商4.4 验证配置生效五、模型选择与使用建议5.1 智谱模型对应关系5.2 在 CC-Switch 中切换模型5.3 额度恢复机制六、CC-Switch 进阶功能6.1 用量统计6.2 MCP 服务器管理6.3 Skills 安装6.4 快速切换供应商热切换七、常见问题排查八、方案对比为什么选择智谱 CC-Switch九、总结Claude Code 国内使用完整指南CC-Switch 智谱 GLM Coding Plan 全流程教程亲爱的朋友们创作不容易若对您有帮助的话请点赞收藏加关注哦您的关注是我持续创作的动力谢谢大家有问题请私信或联系邮箱jasonai.fngmail.comClaude Code 是目前公认最强的 AI 编程助手但官方订阅需要信用卡支付、访问有地区限制、$20/月的 Claude Pro 性价比也有限。对于国内开发者CC-Switch 智谱 GLM Coding Plan是目前口碑最好的组合配置最简单、费用约为官方的 1/7、额度是 Claude Pro 的 3 倍且无需代理。本文将完整还原智谱 Coding Plan 申请 → API Key 获取 → CC-Switch 安装配置 → 验证上手的全过程每一步都有截图描述零基础可跟做。一、整体方案架构说明在动手之前先理解这套方案是怎么工作的有助于遇到问题时快速定位。┌─────────────────────────────────────────────────────────┐ │ 你的本机终端 │ │ │ │ claude 命令 │ │ ↓ │ │ CC-Switch读取配置注入 API Key Endpoint │ │ ↓ │ │ 智谱 Coding API Endpoint │ │ https://open.bigmodel.cn/api/coding/paas/v4 │ │ ↓ │ │ 智谱 GLM 模型GLM-5.1 / GLM-5-Turbo / GLM-4.7 │ │ │ │ ✅ 无需代理 ✅ 国内直连 ✅ 稳定不封号 │ └─────────────────────────────────────────────────────────┘组件作用CC-Switch桌面 GUI 工具管理 Claude Code 的 API 配置免去手动改配置文件智谱 GLM Coding Plan国内 AI 大模型平台提供 Claude Code 兼容的 OpenAI 格式 API 中转GLM 模型GLM-5.1对标 Claude Opus、GLM-5-Turbo对标 Claude Sonnet二、第一步申请智谱 GLM Coding Plan2.1 注册智谱 AI 账号Step 1 — 访问官网打开 https://open.bigmodel.cn点击右上角注册。Step 2 — 完成注册使用手机号注册填写验证码设置密码后登录Step 3 — 实名认证必须进入控制台后根据提示完成实名认证身份证认证后才能订阅套餐和生成 API Key。认证通常在几分钟内完成。2.2 订阅 GLM Coding PlanStep 1 — 进入套餐页面登录后访问 https://docs.bigmodel.cn/cn/coding-plan/overview或在控制台顶部导航点击“Coding Plan”/“套餐”。Step 2 — 了解套餐选项套餐月费适合人群每日额度特点Lite¥20/月轻度使用、学生、探索期基础额度5小时周期恢复Pro约 ¥60/月日常编程、中频使用额度约 Lite 的 3 倍Max约 ¥120/月重度编程、专业开发者最高额度高峰期优先新手推荐先购买Lite 月套餐¥20试用确认效果后再考虑升级或年付年付通常有 7 折优惠。优惠提示新用户首次购买季付套餐可享5 折优惠Lite 套餐低至¥48/季约 ¥16/月。Step 3 — 完成支付选择套餐 → 确认购买 → 支付宝/微信支付到账即时生效。2.3 获取 API KeyStep 1 — 进入 API Key 管理页在控制台左侧导航找到“API Keys”或“密钥管理”也可直接访问https://open.bigmodel.cn/usercenter/apikeysStep 2 — 创建新 Key点击“新建 API Key”→ 填写名称如claude-code-key→ 点击确认。Step 3 — 复制保存 KeyKey 格式类似a1b2c3d4e5f6...一长串字母数字组合⚠️Key 只会完整显示一次创建后立即复制并妥善保存遗失需重新创建。Step 4 — 记录 Coding 专用端点智谱为 Coding Plan 提供了专用 API 端点与通用端点不同Coding 专用端点Claude Code 使用这个 https://open.bigmodel.cn/api/coding/paas/v4 通用端点普通 API 调用 https://open.bigmodel.cn/api/paas/v4⚠️ 两个端点不可混用CC-Switch 配置智谱时填写 Coding 专用端点。三、第二步安装 CC-Switch3.1 什么是 CC-SwitchCC-Switch 是开源的跨平台桌面工具GitHub: farion1231/cc-switch专门用来管理 Claude Code 等 AI 编程工具的 API 配置。它解决了一个核心痛点不用手动改配置文件或设置环境变量在 GUI 界面里点一下就能切换 API 提供商。核心功能一览功能说明一键切换供应商在官方 Anthropic / 智谱 / DeepSeek / Kimi 等之间秒切API Key 管理集中管理多个 Key不用记在哪个文件里健康检查一键测试 API 连通性和延迟用量统计查看 Token 消耗、缓存命中率、按模型分类的费用MCP 管理可视化增删 MCP 服务器配置自动同步Skills 管理安装增强 Claude Code 能力的提示词插件多应用支持同时管理 Claude Code、Codex、Gemini CLI 等3.2 下载 CC-Switch前往 GitHub Release 页面下载https://github.com/farion1231/cc-switch/releases根据你的操作系统选择对应文件系统下载文件说明Windows 安装版CC-Setup-x.x.x.exe推荐自动创建快捷方式Windows 便携版CC-windows-x.x.x.zip解压即用无需安装macOSCC-Switch-vX.X.X-macOS.zip解压后拖入 ApplicationsLinuxCC-Switch-vX.X.X-linux.AppImage给予执行权限后运行下载页面在 Assets 折叠区如果看不到文件列表点击 “Assets” 展开。3.3 安装 CC-SwitchWindows安装版双击下载的.exe文件如果弹出Windows 已保护你的电脑提示点击更多信息 → “仍要运行”按照安装向导默认选项完成安装桌面或开始菜单找到 CC-Switch 图标双击启动macOS解压.zip文件得到CC-Switch.app将CC-Switch.app拖入/Applications文件夹首次打开时如果提示无法验证开发者进入系统设置 → 隐私与安全性点击仍要打开或在终端运行sudoxattr-rdcom.apple.quarantine /Applications/CC-Switch.app四、第三步在 CC-Switch 中配置智谱4.1 认识 CC-Switch 主界面首次启动 CC-Switch 后界面主要分为以下区域┌──────────────────────────────────────────────────┐ │ [Claude Code] [Codex] [Gemini CLI] ← 应用切换栏 │ ├──────────────────────────────────────────────────┤ │ 供应商列表 [ 添加供应商] │ │ ○ Anthropic 官方 [启用] [健康检查] │ │ ○ 智谱 GLM待配置 [启用] [健康检查] │ │ ... │ ├──────────────────────────────────────────────────┤ │ [供应商] [用量] [MCP] [Skills] [设置] ← 底部导航 │ └──────────────────────────────────────────────────┘4.2 添加智谱供应商Step 1 — 确认当前管理的是 Claude Code界面顶部应用切换栏确认选中的是Claude Code图标Claude 的 logo。Step 2 — 点击添加供应商点击右上角的“”按钮弹出添加供应商界面。Step 3 — 选择智谱预设或手动填写在内置预设列表中找到“智谱 AI”/“GLM”点击选中。如果预设列表中没有智谱选择自定义手动填写字段填写内容供应商名称智谱 GLM CodingAPI Base URLhttps://open.bigmodel.cn/api/coding/paas/v4API Key粘贴你从智谱控制台复制的 Key模型大模型/Opus 对应glm-5.1模型中等/Sonnet 对应glm-5-turbo模型小模型/Haiku 对应glm-4.7Step 4 — 保存配置点击保存或确认供应商出现在列表中。4.3 启用智谱供应商Step 1 — 在供应商列表中找到刚添加的智谱 GLMStep 2 — 点击健康检查CC-Switch 会发送一个测试请求验证API Key 是否有效Coding 端点是否可达响应延迟是多少健康检查通过后会显示绿色✅ 正常失败则显示具体错误信息。Step 3 — 点击启用点击启用按钮CC-Switch 会自动将配置写入 Claude Code 的配置文件不需要手动设置任何环境变量。当前激活的供应商会有高亮标识如橙色圆点或当前标签。4.4 验证配置生效打开终端Mac: Terminal / Windows: PowerShell 或 CMD运行claude用一句话介绍你自己如果返回 GLM 模型的回复内容中可能提到智谱或GLM说明配置成功。也可以运行claude doctor在输出中找到API Provider或Base URL字段确认显示的是智谱的 Coding 端点。五、模型选择与使用建议5.1 智谱模型对应关系智谱模型对标 Claude 模型适用场景额度消耗系数GLM-5.1Claude Opus复杂推理、架构设计、难题调试高峰期 3×非高峰期 2×GLM-5-TurboClaude Sonnet日常编程、代码补全、文档生成标准 1×GLM-4.7Claude Haiku简单问答、快速响应、轻量任务标准 1×GLM-4.5-Air—极速响应适合高频简单任务最低额度节省建议日常编程任务用 GLM-5-Turbo遇到真正复杂的架构问题再切换到 GLM-5.1。高峰期每天 14:00–18:00 UTC8GLM-5.1 消耗额度是平时的 1.5 倍建议避开高峰期处理重型任务。5.2 在 CC-Switch 中切换模型CC-Switch 支持 4 级模型配置对应 Claude Code 内部的 Haiku / Sonnet / Opus / 自定义在供应商配置页可以分别指定每个级别使用哪个 GLM 模型Claude Code 会根据任务复杂度自动选用不同级别。5.3 额度恢复机制当套餐额度耗尽时不会自动扣费账户余额而是等待下一个5 小时周期自动恢复。规划好使用节奏避免在关键时刻额度归零。六、CC-Switch 进阶功能6.1 用量统计点击底部导航的“用量”标签可以看到各供应商的 Token 消耗明细缓存命中率影响实际费用按模型分类的费用估算历史用量趋势6.2 MCP 服务器管理点击“MCP”标签可以可视化添加、编辑、删除 MCP 服务器配置自动同步到 Claude Code。智谱 Coding Plan 套餐本身也内置了若干 MCP 权益如联网搜索、网页读取、开源仓库 MCP。6.3 Skills 安装Skills 是增强 Claude Code 能力的提示词插件类似 Claude Code 的 Skill 系统。点击“Skills”→ 安装预设仓库中的 Skills或从 GitHub URL 安装自定义 Skills。6.4 快速切换供应商热切换CC-Switch 支持无需重启 Claude Code的热切换——在供应商列表中点击另一个供应商的启用配置立即生效正在运行的 Claude Code 会话自动使用新配置。七、常见问题排查问题现象原因解决方案健康检查失败“401 Unauthorized”API Key 错误或未激活套餐检查 Key 是否完整复制确认已购买 Coding Plan 套餐健康检查失败“404 Not Found”Endpoint 填写了通用端点改为 Coding 专用端点https://open.bigmodel.cn/api/coding/paas/v4claude命令仍然连接官方 API系统环境变量覆盖了 CC-Switch 配置检查是否设置了ANTHROPIC_API_KEY或ANTHROPIC_BASE_URL环境变量删除后重试CC-Switch 安装后 Mac 提示无法打开Gatekeeper 拦截系统设置 → 隐私与安全性 → 点击仍要打开或运行sudo xattr -rd com.apple.quarantine /Applications/CC-Switch.app额度消耗过快高峰期大量使用 GLM-5.1日常任务切换到 GLM-5-Turbo避开 14:00–18:00UTC8高峰期模型回复质量不如预期使用了较轻量的模型在 CC-Switch 供应商配置中将 Opus 级别改为glm-5.1响应速度慢网络抖动点击健康检查查看延迟智谱 API 国内直连通常延迟 300ms八、方案对比为什么选择智谱 CC-Switch维度官方 Claude Pro智谱 GLM Coding Plan月费$20约 ¥145¥20 起约 1/7额度有限制高频使用受限约官方 3 倍地区需代理有封号风险国内直连稳定支付方式信用卡Visa/Mastercard支付宝、微信模型Claude Opus 4 / Sonnet 4GLM-5.1 / GLM-5-Turbo配置难度简单CC-Switch 图形化同样简单多工具支持仅 Claude CodeClaude Code Codex Kilo Code 等 10九、总结步骤操作关键点① 注册智谱open.bigmodel.cn 注册并实名实名认证后才能订阅② 购买套餐选择 Lite¥20起步新用户季付可享 5 折③ 获取 Key控制台创建 API KeyKey 只显示一次立即保存④ 安装 CC-SwitchGitHub Release 下载对应系统包Mac 需解除 Gatekeeper 限制⑤ 配置供应商填入 Coding 端点 API Key端点必须用 Coding 专用 URL⑥ 启用验证健康检查绿灯后点击启用claude hello验证生效CC-Switch 智谱 GLM Coding Plan是目前国内使用 Claude Code 性价比最高、配置最简单的方案。¥20/月就能解锁 AI 编程助手的完整能力无需代理直接在终端里claude开始工作。参考资料CC-Switch GitHub 主仓库 — farion1231CC-Switch 中文说明文档智谱 AI GLM Coding Plan 套餐概览智谱 AI 开放平台菜鸟教程 — CC Switch 一键切换 API知乎 — 最强编程模型 Claude Code 国内使用指南