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、模型切换、国内使用、配置教程

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐