CC-Switch + Claude Code + Codex CLI 接入 GLM 模型：从零到一的手把手实战教程
CC-Switch + Claude Code + Codex CLI 接入 GLM 模型：从零到一的手把手实战教程
🎯 本文目标：让你在 30 分钟内，从零搭建一套「Claude Code + Codex CLI + CC-Switch + 智谱 GLM」的 AI 编程环境，用国内模型的价格，享受世界级的 AI 编程体验。**一个工具管理两个顶级 AI 编程助手**！
📋 目录
- 一、先搞懂：这些工具都是干嘛的？
- 二、完整工具链一览（架构图）
- 三、你需要准备什么？（环境要求）
- 四、第一步：安装 Node.js（地基）
- 五、第二步：安装 Claude Code（Anthropic 的 AI 编程助手）
- 六、第三步：安装 Codex CLI（OpenAI 的 AI 编程助手）
- 七、第四步：注册智谱 GLM 并获取 API Key
- 八、第五步：安装 CC-Switch（核心神器）
- 九、⭐ 第六步：用 CC-Switch 配置 GLM 模型（三种方式）
- 十、第七步：验证配置是否成功
- 十一、进阶玩法：CC-Switch 的更多能力
- 十二、Claude Code vs Codex CLI：我该用哪个？
- 十三、常见问题排查（FAQ）
- 十四、总结与参考链接
一、先搞懂：这些工具都是干嘛的？
如果你是第一次接触这些概念，别慌！让我用一个 「餐厅」 的比喻来帮你秒懂：
🍽️ 餐厅比喻
| 概念 | 比喻 | 实际是什么 |
|---|---|---|
| **Claude Code** | 餐厅的主厨 A | Anthropic 推出的 AI 编程助手，在终端里帮你写代码、改 bug、重构项目 |
| **Codex CLI** | 餐厅的主厨 B | OpenAI 推出的 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 编程助手 #1 | Anthropic 出品，终端交互，深度代码理解 |
| **Codex CLI** | AI 编程助手 #2 | OpenAI 出品，终端交互，高效任务执行 |
| **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.org
2. 下载 LTS（长期支持） 版本，确保版本号 ≥ 22
3. 双击安装包，一路 Next，保持默认选项即可
4. 安装完成后，打开 命令提示符（按 Win+R，输入 cmd），验证：
node -v
# 应该显示 v22.x.x 或更高版本
npm -v
# 应该显示 10.x.x 或更高版本
macOS 用户
方式一：官网安装包（推荐新手）
1. 打开 nodejs.org
2. 下载 macOS LTS 版本
3. 双击 .pkg 文件安装
方式二：Homebrew（推荐老手）
brew install node@22
Linux 用户（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 Code（Anthropic 的 AI 编程助手）
Claude Code 是 Anthropic 公司推出的终端 AI 编程助手。你可以在终端里直接跟它对话，让它帮你写代码、改 bug、重构项目。
安装命令
打开终端（Windows 用 cmd/PowerShell，macOS/Linux 用 Terminal），输入：
npm install -g @anthropic-ai/claude-code
💡 国内用户加速：如果下载慢，可以使用淘宝镜像：
```bash
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
```
验证安装
claude --version
# 显示版本号即安装成功
首次运行
# 进入你的项目目录
cd your-project
# 启动 Claude Code
claude
⚠️ 此时先不要登录或配置，等我们用 CC-Switch 来统一配置 GLM 模型后再使用。
六、第三步：安装 Codex CLI（OpenAI 的 AI 编程助手）
Codex CLI 是 OpenAI 推出的终端 AI 编程助手。它不仅能帮你写代码，还能直接执行命令，自动化完成各种开发任务。
🆚 Codex CLI 的三种使用形态
| 形态 | 说明 | 适合场景 |
|---|---|---|
| **CLI（命令行）** | 在终端中使用 | 服务器、快速任务、CI/CD |
| **Desktop（桌面客户端）** | 独立的桌面应用 | 日常开发、可视化操作 |
| **VSCode 插件** | 集成在 VSCode 中 | 边写代码边用 AI |
本文以 CLI 形态 为主，这也是 CC-Switch 管理的方式。
安装命令
npm install -g @openai/codex
💡 国内用户加速：
```bash
npm install -g @openai/codex --registry=https://registry.npmmirror.com
```
验证安装
codex --version
# 显示版本号即安装成功
Codex CLI 的配置文件位置
| 系统 | 配置文件路径 |
|---|---|
| macOS / Linux | `~/.codex/config.toml` |
| Windows | `%USERPROFILE%\.codex\config.toml` |
⚠️ 此时同样先不配置，等 CC-Switch 来统一管理。
Codex CLI 的权限模式
Codex 有三种执行权限，你可以在使用时选择：
| 模式 | 命令参数 | 说明 |
|---|---|---|
| **Suggest** | `codex --suggest` | 只建议，不执行（最安全） |
| **Auto Edit** | `codex --auto-edit` | 自动编辑文件，但不执行命令 |
| **Full Auto** | `codex --full-auto` | 全自动，可执行任何命令（最高效但需谨慎） |
七、第四步：注册智谱 GLM 并获取 API Key
API Key 就像是你进入「食材仓库」的钥匙。有了它，Claude Code 和 Codex CLI 才能使用 GLM 模型。
注册步骤
1. 打开 open.bigmodel.cn
2. 注册账号：支持手机号注册
3. 实名认证：根据提示完成（国内平台都需要）
4. 领取免费额度：新用户注册即送 2000 万 Tokens 🎉
获取 API Key
1. 登录后，进入 「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/releases
2. 下载对应系统的安装包：
| 系统 | 文件名格式 |
|---|---|
| Windows | `CC-Switch_x.x.x_x64-setup.exe` |
| macOS (Intel) | `CC-Switch_x.x.x_x64.dmg` |
| macOS (Apple Silicon) | `CC-Switch_x.x.x_aarch64.dmg` |
| Linux | `CC-Switch_x.x.x_amd64.AppImage` |
3. 双击安装（Windows）或拖入 Applications（macOS）
首次启动
安装完成后，打开 CC-Switch，你会看到一个清爽的管理界面：
- 左侧：工具列表（Claude Code、Codex CLI 等）
- 中间：供应商和模型配置
- 右侧：详细设置
💡 CC-Switch 启动后会驻留在系统托盘，你可以随时通过托盘图标快速切换模型！
九、⭐ 第六步：用 CC-Switch 配置 GLM 模型（三种方式）
这是最关键的一步！我们有三种方式来配置，从最简单的开始。
方式一：CC-Switch 界面配置（⭐ 最推荐）
这是最简单、最直观的方式！
为 Claude Code 配置 GLM
1. 打开 CC-Switch
2. 在左侧选择 「Claude Code」
3. 点击 「供应商」 或 「添加供应商」
4. 在预设列表中找到 「智谱 AI / GLM」
5. 填入你的 API Key（sk- 开头的那串字符）
6. 选择模型（推荐 glm-4.7）
7. 点击 「应用」 或 「保存」
CC-Switch 会自动帮你配置以下环境变量：
ANTHROPIC_API_KEY=你的GLM_API_Key
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/paas/v4
ANTHROPIC_DEFAULT_SONNET_MODEL=glm-4.7
为 Codex CLI 配置 GLM
1. 在 CC-Switch 左侧选择 「Codex CLI」
2. 点击 「供应商」
3. 在预设列表中找到 「智谱 AI / GLM」
4. 填入同一个 API Key
5. 选择模型
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 Key
3. 选择要使用的模型
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 Key | `sk-xxx...` |
| `ANTHROPIC_BASE_URL` | API 地址 | `https://open.bigmodel.cn/api/paas/v4` |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | 默认使用的模型 | `glm-4.7` |
Codex 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 refused` | API 地址配置错误 | 检查 `ANTHROPIC_BASE_URL` 是否正确 |
| `Invalid API Key` | API Key 错误 | 重新复制 API Key |
| `Model not found` | 模型名称错误 | 确认使用 `glm-4.7` 而非其他名称 |
| `Token limit exceeded` | Token 额度用完 | 到智谱平台检查额度 |
十一、进阶玩法：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 服务器管理
MCP（Model 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 Code | Codex CLI |
|---|---|---|
| **开发公司** | Anthropic | OpenAI |
| **核心优势** | 深度理解、长上下文 | 快速执行、自动化 |
| **交互方式** | 对话式 | 对话式 + 自动执行 |
| **执行模式** | 需要确认后执行 | 可全自动执行 |
| **上下文窗口** | 超长（200K+） | 标准 |
| **代码审查** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **自动重构** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **批量修改** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **任务自动化** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **学习曲线** | 中等 | 较低 |
🎯 场景推荐
| 场景 | 推荐工具 | 原因 |
|---|---|---|
| 代码审查 | Claude Code | 深度理解代码逻辑，给出详细建议 |
| 复杂重构 | Claude Code | 长上下文窗口，理解整个项目结构 |
| 快速原型 | Codex CLI | 快速生成、自动执行 |
| 自动化脚本 | Codex CLI | Full Auto 模式全自动执行 |
| Bug 修复 | 都可以 | Claude Code 更擅长定位 bug，Codex 更擅长快速修复 |
| 学习新技术 | Claude Code | 解释更详细，教学能力更强 |
| CI/CD 集成 | Codex CLI | 命令行友好，易于自动化 |
💡 最佳实践：两个都装上！根据不同任务灵活选择。CC-Switch 让两个工具共享同一个 GLM 模型配置，切换零成本。
十三、常见问题排查（FAQ）
❓ Q1：Claude Code 启动后提示「无法连接到 API」
原因：API 地址或 API Key 配置不正确。
解决方法：
# 检查环境变量是否正确设置
echo $ANTHROPIC_BASE_URL
# 应该输出：https://open.bigmodel.cn/api/paas/v4
echo $ANTHROPIC_API_KEY
# 应该输出你的 API Key（sk-xxx...）
如果为空，说明 CC-Switch 没有正确设置环境变量，请重新在 CC-Switch 中配置。
❓ Q2：Codex CLI 提示「API Key invalid」
原因：配置文件中的 API Key 格式不对。
解决方法：
1. 打开 ~/.codex/config.toml
2. 检查 api_key 字段，确保是完整的 sk-xxx... 格式
3. 确保没有多余的空格或引号
❓ Q3：模型响应很慢
原因：可能是选择了较大的模型，或网络延迟。
解决方法：
- 尝试切换到 `glm-4-flash`（速度更快）
- 在 CC-Switch 的系统托盘中一键切换
❓ Q4：Token 额度用完了怎么办？
解决方法：
1. 到 open.bigmodel.cn 查看余额
2. 充值或等待免费额度刷新
3. 使用 CC-Switch 的花费追踪功能监控用量
❓ Q5：Claude Code 和 Codex CLI 可以同时使用吗？
可以！ 它们是独立的工具，可以同时运行。而且 CC-Switch 可以统一管理两者的模型配置，互不干扰。
❓ Q6：如何切换回官方模型（Anthropic/OpenAI）？
在 CC-Switch 中，一键切换供应商即可：
1. 打开 CC-Switch
2. 选择对应的工具（Claude Code 或 Codex CLI）
3. 切换供应商为「Anthropic」或「OpenAI」
4. 填入对应的 API Key
❓ Q7：CC-Switch 支持哪些操作系统？
支持 Windows、macOS（Intel + 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、模型切换、国内使用、配置教程
更多推荐
8
0- 0
已为社区贡献7条内容
所有评论(0)