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、模型切换、国内使用、配置教程
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)