# Codex + CC Switch 自定义模型配置教程

这篇教程说明如何安装 OpenAI Codex 桌面端与 CC Switch，并通过 CC Switch 给 Codex 配置第三方或自定义模型。

适用场景：

- 你希望使用 Codex 桌面端体验
- 你有一个 OpenAI 兼容、Responses 兼容或 Chat Completions 兼容的模型服务
- 你希望在 Codex 中使用 DeepSeek、Kimi、Qwen、豆包、MiniMax、OpenRouter、自建网关等非默认模型

## 1. 先理解两者关系

Codex 是本地运行的 AI 编程 Agent。桌面端与本地 Codex 配置共享同一套用户配置，会读取 `~/.codex/config.toml`、`~/.codex/auth.json`、模型目录等本地文件。

CC Switch 是一个桌面管理工具，用来统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等 AI 编程工具的 Provider。配置 Codex 时，它会帮你写入或更新 Codex 需要的本地配置。

简单说：

```text
你在 CC Switch 里添加 Provider
        ↓
CC Switch 写入 Codex 配置和模型目录
        ↓
重新打开 Codex 桌面端
        ↓
Codex 使用新的 API 地址、Key 和模型
```

## 2. 安装 Codex 桌面端

- 下载：[https://developers.openai.com/codex/app](https://developers.openai.com/codex/app)
- 备用地址：
  - Mac(Apple Silicon): [https://image.hitick.top/download/Codex_apple.dmg](https://image.hitick.top/download/Codex_apple.dmg) 
  - Mac(Intel): [https://image.hitick.top/download/Codex_intel.dmg](https://image.hitick.top/download/Codex_intel.dmg)
  - Windows: [https://image.hitick.top/download/Codex_Installer.exe](https://image.hitick.top/download/Codex_Installer.exe)
  - 下载与你系统匹配的安装包后安装。
- 完成后**不需要**立即启动


## 3. 安装 CC Switch
- 官网：[https://ccswitch.io](https://ccswitch.io)
- GitHub 仓库：[farion1231/cc-switch](https://github.com/farion1231/cc-switch)
- 最新 Release：[GitHub Releases](https://github.com/farion1231/cc-switch/releases/latest)
- 备用地址：
  - Mac: [https://image.hitick.top/download/CC-Switch-v3.16.5-macOS.dmg](https://image.hitick.top/download/CC-Switch-v3.16.5-macOS.dmg)
  - Windows: [https://image.hitick.top/download/CC-Switch-v3.16.5-Windows.msi](https://image.hitick.top/download/CC-Switch-v3.16.5-Windows.msi)
下载与你系统匹配的安装包后启动 CC Switch。

## 4. 在 CC Switch 中添加 Codex Provider

1. 打开 CC Switch
2. ![cc-1.jpg](pic/cc-1.jpg)
3. ![cc0.jpg](pic/cc0.jpg)
4. 点击返回
5. 切换到 `Codex` 面板
6. 点击添加 Provider
7. ![cc1.jpg](pic/cc1.jpg)
8. 选择自定义配置
9. ![cc2.jpg](pic/cc2.jpg)
10. ![cc3.jpg](pic/cc3.jpg)
11. ![cc4.jpg](pic/cc4.jpg)
12. 点击添加
13. 回到 Provider 列表，点击启用
14. 完全退出 Codex 桌面端，再重新打开 Codex

## 5. 验证是否成功接入大模型

重新打开 Codex 桌面端，在模型选择器中查看是否能看到刚才配置的模型名称。选择模型后，发一个最小测试：

```text
请用一句话回复：当前模型已经接通。
```

## 6.接入MCP
1. ![mcp1.jpg](pic/mcp1.jpg)
2. ![mcp2.jpg](pic/mcp2.jpg)
3. ![mcp3.jpg](pic/mcp3.jpg)
4. 将自己的 `ApiToken` 粘贴到下面语句中，再发给 Agent。

```text
我的 Hitick Api Token 是：<your_api_token>。请保存它，并查询黄金的最新报价。
```

5. 开始使用