CC-Switch Claude Code Codex CLI 接入 GLM 模型从零到一的手把手实战教程本文目标让你在 30 分钟内从零搭建一套「Claude Code Codex CLI CC-Switch 智谱 GLM」的 AI 编程环境用国内模型的价格享受世界级的 AI 编程体验。**一个工具管理两个顶级 AI 编程助手** 目录一、先搞懂这些工具都是干嘛的二、完整工具链一览架构图三、你需要准备什么环境要求四、第一步安装 Node.js地基五、第二步安装 Claude CodeAnthropic 的 AI 编程助手六、第三步安装 Codex CLIOpenAI 的 AI 编程助手七、第四步注册智谱 GLM 并获取 API Key八、第五步安装 CC-Switch核心神器九、⭐ 第六步用 CC-Switch 配置 GLM 模型三种方式十、第七步验证配置是否成功十一、进阶玩法CC-Switch 的更多能力十二、Claude Code vs Codex CLI我该用哪个十三、常见问题排查FAQ十四、总结与参考链接一、先搞懂这些工具都是干嘛的如果你是第一次接触这些概念别慌让我用一个「餐厅」的比喻来帮你秒懂️ 餐厅比喻概念比喻实际是什么**Claude Code**餐厅的主厨 AAnthropic 推出的 AI 编程助手在终端里帮你写代码、改 bug、重构项目**Codex CLI**餐厅的主厨 BOpenAI 推出的 AI 编程助手同样在终端里帮你写代码、自动执行任务**GLM 模型**厨师用的食材菜、肉、调料智谱 AI 开发的大语言模型如 GLM-4.7、GLM-5是国内最强的 AI 模型之一**CC-Switch**餐厅的采购管家一个桌面工具帮你一键切换不同的「食材供应商」AI 模型管理各种配置简单来说**Claude Code** 和 **Codex CLI** 是两个超级厉害的 AI 程序员你跟它说需求它帮你写代码但它们默认用的是国外的「食材」Anthropic/OpenAI 的模型**在国内使用有网络限制而且价格不菲****GLM** 是国内的优质「食材」便宜、快速、无网络限制**CC-Switch** 就是那个帮你把「主厨」和「国产食材」连接起来的桥梁 为什么要同时用 Claude Code 和 Codex CLI就像为什么厨师有中餐厨师和西餐厨师一样**Claude Code**擅长长上下文理解、复杂项目重构、代码审查思考更深入**Codex CLI**擅长快速原型开发、自动化任务执行、多文件批量修改执行更高效**CC-Switch** 能一键管理两者的模型配置让你在两个工具之间无缝切换二、完整工具链一览架构图下面这张图展示了整个工具链的关系┌─────────────────────────────────────────────────────────────┐ │ 你的电脑 │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌──────────────────┐ │ │ │ Claude Code │ │ Codex CLI │ │ Gemini CLI 等 │ │ │ │ (终端AI) │ │ (终端AI) │ │ (其他终端AI) │ │ │ └──────┬──────┘ └──────┬──────┘ └────────┬─────────┘ │ │ │ │ │ │ │ └────────────────┼───────────────────┘ │ │ │ │ │ ┌───────────▼───────────┐ │ │ │ CC-Switch │ │ │ │ (统一配置管理中心) │ │ │ │ │ │ │ │ • 供应商预设(50) │ │ │ │ • 模型一键切换 │ │ │ │ • MCP 服务器管理 │ │ │ │ • 花费追踪统计 │ │ │ │ • 系统托盘操作 │ │ │ └───────────┬───────────┘ │ │ │ │ │ ┌───────────────┼───────────────┐ │ │ │ │ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │ │ │ 智谱 GLM │ │ DeepSeek │ │ 火山方舟 │ │ │ │ (国内模型) │ │ (国内模型) │ │ (国内模型) │ │ │ └───────────┘ └───────────┘ └───────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘ 各工具的角色工具角色说明**Claude Code**AI 编程助手 #1Anthropic 出品终端交互深度代码理解**Codex CLI**AI 编程助手 #2OpenAI 出品终端交互高效任务执行**CC-Switch**配置管理中心统一管理上面两个工具的模型、MCP、Skills**GLM API**AI 模型供应商智谱 AI 提供的大语言模型 API**Node.js**运行环境Claude Code 和 Codex CLI 的运行基础三、你需要准备什么环境要求 硬件要求一台 Windows / macOS / Linux 电脑稳定的网络连接注册和下载时需要 软件清单软件版本要求用途获取方式Node.js**v22**推荐 LTS 版本Claude Code 和 Codex CLI 的运行环境[nodejs.org](https://nodejs.org)Claude Code最新版AI 编程助手npm 安装Codex CLI最新版AI 编程助手npm 安装CC-Switch最新版配置管理工具GitHub 下载 账号清单账号用途注册地址智谱 AI 开放平台获取 GLM API Key[open.bigmodel.cn](https://open.bigmodel.cn)好消息智谱 AI 新用户注册即送 **2000 万 Tokens**足够你用很久了Claude Code 和 Codex CLI 本身不需要注册 Anthropic/OpenAI 账号因为我们用的是 GLM 模型。四、第一步安装 Node.js地基Node.js 就像是你电脑上的「电力系统」没有它Claude Code 和 Codex CLI 都跑不起来。Windows 用户1. 打开 nodejs.org2. 下载LTS长期支持版本确保版本号 ≥ 223. 双击安装包一路 Next保持默认选项即可4. 安装完成后打开命令提示符按WinR输入cmd验证node -v # 应该显示 v22.x.x 或更高版本 npm -v # 应该显示 10.x.x 或更高版本macOS 用户方式一官网安装包推荐新手1. 打开 nodejs.org2. 下载 macOS LTS 版本3. 双击.pkg文件安装方式二Homebrew推荐老手brew install node22Linux 用户Ubuntu/Debian# 使用 NodeSource 安装 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 验证 node -v # v22.x.x npm -v # 10.x.x⚠️常见问题如果 node -v 显示版本低于 22说明你之前装了旧版本。需要先卸载旧版本再重装。五、第二步安装 Claude CodeAnthropic 的 AI 编程助手Claude Code 是 Anthropic 公司推出的终端 AI 编程助手。你可以在终端里直接跟它对话让它帮你写代码、改 bug、重构项目。安装命令打开终端Windows 用 cmd/PowerShellmacOS/Linux 用 Terminal输入npm install -g anthropic-ai/claude-code国内用户加速如果下载慢可以使用淘宝镜像bashnpm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com验证安装claude --version # 显示版本号即安装成功首次运行# 进入你的项目目录 cd your-project # 启动 Claude Code claude⚠️此时先不要登录或配置等我们用 CC-Switch 来统一配置 GLM 模型后再使用。六、第三步安装 Codex CLIOpenAI 的 AI 编程助手Codex CLI 是 OpenAI 推出的终端 AI 编程助手。它不仅能帮你写代码还能直接执行命令自动化完成各种开发任务。 Codex CLI 的三种使用形态形态说明适合场景**CLI命令行**在终端中使用服务器、快速任务、CI/CD**Desktop桌面客户端**独立的桌面应用日常开发、可视化操作**VSCode 插件**集成在 VSCode 中边写代码边用 AI本文以CLI 形态为主这也是 CC-Switch 管理的方式。安装命令npm install -g openai/codex国内用户加速bashnpm install -g openai/codex --registryhttps://registry.npmmirror.com验证安装codex --version # 显示版本号即安装成功Codex CLI 的配置文件位置系统配置文件路径macOS / Linux~/.codex/config.tomlWindows%USERPROFILE%\.codex\config.toml⚠️此时同样先不配置等 CC-Switch 来统一管理。Codex CLI 的权限模式Codex 有三种执行权限你可以在使用时选择模式命令参数说明**Suggest**codex --suggest只建议不执行最安全**Auto Edit**codex --auto-edit自动编辑文件但不执行命令**Full Auto**codex --full-auto全自动可执行任何命令最高效但需谨慎七、第四步注册智谱 GLM 并获取 API KeyAPI Key 就像是你进入「食材仓库」的钥匙。有了它Claude Code 和 Codex CLI 才能使用 GLM 模型。注册步骤1.打开open.bigmodel.cn2.注册账号支持手机号注册3.实名认证根据提示完成国内平台都需要4.领取免费额度新用户注册即送2000 万 Tokens获取 API Key1. 登录后进入「API Keys」页面2. 点击「创建新的 API Key」3. 复制生成的 API Key以sk-开头的一串字符示例sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx⚠️重要API Key 只显示一次请务必保存到安全的地方如果忘记了需要重新创建。查看可用模型在智谱开放平台的「模型」页面你可以看到所有可用的模型模型说明推荐场景**glm-4.7**旗舰模型能力最强复杂编程任务、代码重构**glm-5**最新一代模型通用编程任务**glm-4-flash**轻量模型速度最快快速问答、简单修改**glm-4-long**超长上下文大型项目分析八、第五步安装 CC-Switch核心神器⭐CC-Switch 是整个方案的核心——它就像一个万能遥控器一键管理你的 Claude Code 和 Codex CLI 的模型配置。什么是 CC-Switch**GitHub**[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)**技术栈**Tauri Rust轻量、快速、跨平台**支持工具**Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw**供应商预设**50 个包括智谱 GLM、DeepSeek、火山方舟等下载安装1. 打开 GitHub Release 页面github.com/farion1231/cc-switch/releases2. 下载对应系统的安装包系统文件名格式WindowsCC-Switch_x.x.x_x64-setup.exemacOS (Intel)CC-Switch_x.x.x_x64.dmgmacOS (Apple Silicon)CC-Switch_x.x.x_aarch64.dmgLinuxCC-Switch_x.x.x_amd64.AppImage3. 双击安装Windows或拖入 ApplicationsmacOS首次启动安装完成后打开 CC-Switch你会看到一个清爽的管理界面左侧工具列表Claude Code、Codex CLI 等中间供应商和模型配置右侧详细设置 CC-Switch 启动后会驻留在系统托盘你可以随时通过托盘图标快速切换模型九、⭐ 第六步用 CC-Switch 配置 GLM 模型三种方式这是最关键的一步我们有三种方式来配置从最简单的开始。方式一CC-Switch 界面配置⭐ 最推荐这是最简单、最直观的方式为 Claude Code 配置 GLM1. 打开 CC-Switch2. 在左侧选择「Claude Code」3. 点击「供应商」或「添加供应商」4. 在预设列表中找到「智谱 AI / GLM」5. 填入你的 API Keysk-开头的那串字符6. 选择模型推荐glm-4.77. 点击「应用」或「保存」CC-Switch 会自动帮你配置以下环境变量ANTHROPIC_API_KEY你的GLM_API_Key ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/paas/v4 ANTHROPIC_DEFAULT_SONNET_MODELglm-4.7为 Codex CLI 配置 GLM1. 在 CC-Switch 左侧选择「Codex CLI」2. 点击「供应商」3. 在预设列表中找到「智谱 AI / GLM」4. 填入同一个 API Key5. 选择模型6. 点击「应用」CC-Switch 会自动帮你修改 Codex 的配置文件~/.codex/config.toml[provider] name zhipu base_url https://open.bigmodel.cn/api/paas/v4 api_key sk-xxxxxxxx [model] default glm-4.7搞定现在两个 AI 编程助手都配置好了方式二智谱官方配置工具适合 Claude Code智谱官方提供了一个一键配置工具# 运行智谱官方配置工具 npx z-ai/coding-helper按照提示1. 选择「配置 Claude Code」2. 输入你的 API Key3. 选择要使用的模型4. 确认保存⚠️ 这个工具只支持 Claude Code不支持 Codex CLI。如果你两个都要用推荐方式一。方式三手动配置适合高级用户如果你喜欢自己掌控一切也可以手动编辑配置文件。Claude Code 手动配置编辑文件~/.claude/settings.json不存在就创建{ env: { ANTHROPIC_API_KEY: sk-xxxxxxxxxxxxxxxx, ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/paas/v4, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.7 } }环境变量说明值ANTHROPIC_API_KEY你的 GLM API Keysk-xxx...ANTHROPIC_BASE_URLAPI 地址https://open.bigmodel.cn/api/paas/v4ANTHROPIC_DEFAULT_SONNET_MODEL默认使用的模型glm-4.7Codex CLI 手动配置编辑文件~/.codex/config.toml[model] name glm-4.7 [provider] name zhipu base_url https://open.bigmodel.cn/api/paas/v4 api_key sk-xxxxxxxxxxxxxxxx [approval_policy] mode suggest十、第七步验证配置是否成功配置完成后让我们来验证两个工具是否都能正常工作。验证 Claude Code# 进入一个项目目录或者新建一个 mkdir test-project cd test-project # 启动 Claude Code claude # 在对话中输入 请帮我创建一个简单的 Python Hello World 程序如果 Claude Code 能正常回复并生成代码说明配置成功✅验证 Codex CLI# 在同一个目录下 codex # 在对话中输入 创建一个 index.html 文件包含一个简单的网页如果 Codex CLI 能正常回复并生成代码说明配置成功✅快速排错如果出现错误错误信息可能原因解决方法Connection refusedAPI 地址配置错误检查 ANTHROPIC_BASE_URL 是否正确Invalid API KeyAPI Key 错误重新复制 API KeyModel not found模型名称错误确认使用 glm-4.7 而非其他名称Token limit exceededToken 额度用完到智谱平台检查额度十一、进阶玩法CC-Switch 的更多能力CC-Switch 不仅仅是配置管理工具它还有很多强大的高级功能。 一键切换模型在系统托盘中右键 CC-Switch 图标可以快速在不同的模型之间切换GLM-4.7 ← 当前使用 GLM-5 DeepSeek V4 Claude Sonnet 4 GPT-5智能路由CC-Switch 支持按任务类型自动选择最佳模型。比如简单问答用 glm-4-flash复杂重构用 glm-4.7。 统一 MCP 服务器管理MCPModel Context Protocol是让 AI 工具连接外部服务如数据库、API的协议。CC-Switch 可以统一管理所有工具的 MCP 配置添加一次 MCP 服务器Claude Code 和 Codex CLI 都能用支持的 MCP 类型文件系统、数据库、Web 搜索、Git 等 花费追踪仪表盘CC-Switch 内置了花费追踪功能跨供应商追踪支出、请求数和 Token 用量趋势图表展示详细请求日志自定义模型定价☁️ 云同步配置支持将配置同步到云端支持 Dropbox、OneDrive、iCloud、坚果云、NAS支持 WebDAV 服务器同步多台电脑之间无缝切换 Skills 和 Prompts 管理统一管理 AI 的「技能」和「提示词」一次编写多个工具共享支持导入/导出 Deep Link 快速导入通过ccswitch://协议可以一键导入供应商配置MCP 服务器提示词和技能十二、Claude Code vs Codex CLI我该用哪个两个工具都很强大但侧重点不同。下面帮你做出选择 功能对比对比维度Claude CodeCodex CLI**开发公司**AnthropicOpenAI**核心优势**深度理解、长上下文快速执行、自动化**交互方式**对话式对话式 自动执行**执行模式**需要确认后执行可全自动执行**上下文窗口**超长200K标准**代码审查**⭐⭐⭐⭐⭐⭐⭐⭐⭐**自动重构**⭐⭐⭐⭐⭐⭐⭐⭐⭐**批量修改**⭐⭐⭐⭐⭐⭐⭐⭐⭐**任务自动化**⭐⭐⭐⭐⭐⭐⭐⭐**学习曲线**中等较低 场景推荐场景推荐工具原因代码审查Claude Code深度理解代码逻辑给出详细建议复杂重构Claude Code长上下文窗口理解整个项目结构快速原型Codex CLI快速生成、自动执行自动化脚本Codex CLIFull Auto 模式全自动执行Bug 修复都可以Claude Code 更擅长定位 bugCodex 更擅长快速修复学习新技术Claude Code解释更详细教学能力更强CI/CD 集成Codex CLI命令行友好易于自动化最佳实践两个都装上根据不同任务灵活选择。CC-Switch 让两个工具共享同一个 GLM 模型配置切换零成本。十三、常见问题排查FAQ❓ Q1Claude Code 启动后提示「无法连接到 API」原因API 地址或 API Key 配置不正确。解决方法# 检查环境变量是否正确设置 echo $ANTHROPIC_BASE_URL # 应该输出https://open.bigmodel.cn/api/paas/v4 echo $ANTHROPIC_API_KEY # 应该输出你的 API Keysk-xxx...如果为空说明 CC-Switch 没有正确设置环境变量请重新在 CC-Switch 中配置。❓ Q2Codex CLI 提示「API Key invalid」原因配置文件中的 API Key 格式不对。解决方法1. 打开~/.codex/config.toml2. 检查api_key字段确保是完整的sk-xxx...格式3. 确保没有多余的空格或引号❓ Q3模型响应很慢原因可能是选择了较大的模型或网络延迟。解决方法尝试切换到 glm-4-flash速度更快在 CC-Switch 的系统托盘中一键切换❓ Q4Token 额度用完了怎么办解决方法1. 到 open.bigmodel.cn 查看余额2. 充值或等待免费额度刷新3. 使用 CC-Switch 的花费追踪功能监控用量❓ Q5Claude Code 和 Codex CLI 可以同时使用吗可以它们是独立的工具可以同时运行。而且 CC-Switch 可以统一管理两者的模型配置互不干扰。❓ Q6如何切换回官方模型Anthropic/OpenAI在 CC-Switch 中一键切换供应商即可1. 打开 CC-Switch2. 选择对应的工具Claude Code 或 Codex CLI3. 切换供应商为「Anthropic」或「OpenAI」4. 填入对应的 API Key❓ Q7CC-Switch 支持哪些操作系统支持 Windows、macOSIntel Apple Silicon、Linux。所有平台功能一致。十四、总结与参考链接 全流程回顾安装 Node.js ↓ 安装 Claude Code Codex CLI ↓ 注册智谱 GLM获取 API Key ↓ 安装 CC-Switch ↓ CC-Switch 一键配置 GLM 模型 ↓ 开始用 AI 编程 参考链接资源链接CC-Switch GitHub[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)CC-Switch 下载[github.com/farion1231/cc-switch/releases](https://github.com/farion1231/cc-switch/releases)智谱 AI 开放平台[open.bigmodel.cn](https://open.bigmodel.cn)智谱 GLM Coding Plan[bigmodel.cn/claude-code](https://bigmodel.cn/claude-code)Claude Code 官方文档[docs.anthropic.com/en/docs/claude-code](https://docs.anthropic.com/en/docs/claude-code)Codex CLI 官方文档[github.com/openai/codex](https://github.com/openai/codex)Node.js 官网[nodejs.org](https://nodejs.org)CC-Switch 一键安装 (x-cmd)[cn.x-cmd.com/install/cc-switch](https://cn.x-cmd.com/install/cc-switch) 写在最后AI 编程工具正在飞速进化Claude Code 和 Codex CLI 代表了当前最前沿的终端 AI 编程体验。而 CC-Switch 加上智谱 GLM 模型让国内开发者可以用极低的成本享受这种体验。别犹豫了赶紧动手试试吧有任何问题欢迎在评论区留言交流 关键词CC-Switch、Claude Code、Codex CLI、GLM、智谱AI、AI编程、终端AI、模型切换、国内使用、配置教程