一、前言

Codex 是一款优秀的 AI 编程助手，但原生依赖海外模型，国内开发者使用门槛较高。本文将手把手教大家如何通过更简洁的方式，让 Codex 接入多款主流大模型，同时完成 PyCharm 插件集成，全程图文实操，新手也能跟着配置。

二、环境准备清单

• 官方原版 Codex 客户端
• Codex++ 增强启动器（核心中转工具）
• 魔芋 API 账号及 API Key（核心中转服务）
• PyCharm（需安装对应 AI 插件）

三、第一步：安装 Codex

1. 下载 Codex

微软商店下载地址：https://apps.microsoft.com/detail/9plm9xgg6vks?hl=zh-CN&gl=CN

点击下载并自动安装，等待部署完成。

2. 首次初始化

首次打开原版 Codex 后，直接关闭程序及后台进程（右键退出），为后续配置做准备。

3. 安装 Codex++ 中转站

Codex++ 是 Codex 的外部增强启动器，不会修改 Codex 原文件，通过脚本注入实现模型转发，是接入国产大模型的核心工具。

下载地址
GitHub 开源地址：https://github.com/BigPizzaV3/CodexPlusPlus
进入页面后点击 Releases，根据系统选择安装包：

Windows：CodexPlusPlus-*-windows-X64-setup.exe
macOS Intel：CodexPlusPlus-*-macos-x64.dmg
macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg

4. **Codex++安装流程 **

• 双击安装包，可自定义安装目录（建议安装到非系统盘，如 D:\codex++）；
• 等待安装完成，桌面会生成两个图标：
  
  Codex++：静默启动入口，直接启动 Codex 并加载增强配置；
  Codex++管理工具：控制面板，用于配置、修复、切换模型。

四、第二步：Codex 接入魔芋 API 平台

我这边为了方便，也节省分别配置 Base URL、模型名称等参数的步骤，就统一使用API集成平台了。

魔芋 API 平台已经是集成了市面上所有主流大模型，包括 GPT-5 系列、Claude 系列、Gemini、DeepSeek、通义千问、Grok 等。对于开发者来说是节省了不少步骤。只需要一个账号一个 API Key，就可以一键切换使用所有模型。

并且它是原生兼容 Codex 的 Responses API 和 Chat Completions 协议，无需额外转换工具，配置即用。而且费用也透明，能查看自己消耗了。

魔芋 API 配置步骤

1. 获取魔芋 API Key

访问魔芋 API 官网https://www.moyu.info/，注册账号并充值，在控制台生成专属 API Key。

2. Codex 配置文件修改

找到 Codex 的配置文件 ~/.codex/config.toml（Windows 系统通常在 C:\Users\你的用户名\.codex\config.toml），按以下格式修改：

[auth]
provider = "openai"
api_key = "your-moyu-api-key"

[api]
base_url = "https://api.moyu-api.com/v1"
model = "gpt-5-codex"

3. 环境变量配置（Windows）

按下 Win+R，输入 cmd 打开命令行，执行以下命令：

setx OPENAI_API_KEY "你的魔芋API Key"

关闭当前 CMD，重新打开，执行以下命令验证是否生效：

echo %OPENAI_API_KEY%

终端正常输出 API Key，代表环境变量配置成功。

4. 启动测试

新 CMD 窗口直接输入 codex，若正常启动并显示当前模型名称，说明模型接入完成。

在对话框输入指令测试，正常返回内容即代表接入成功。

模型切换超简单

使用魔芋 API 后，切换模型只需修改 config.toml 中的 model 字段即可：

# 切换到 DeepSeek
model = "deepseek-r1"

# 切换到通义千问
model = "qwen3.7-max"

# 切换到 Claude
model = "claude-sonnet-4"

# 切换到 GPT-5
model = "gpt-5"

无需重新注册、无需重新获取 Key，改完重启 Codex 即可生效。

注意：后续启动 Codex 统一使用 Codex++ 入口。

五、第三步：PyCharm 集成 Codex + 魔芋 API

实现 IDE 内直接使用 AI 大模型辅助编码。

1. 安装 CC GUI 插件

打开 PyCharm，依次点击 文件 → 设置 → 插件(Marketplace)；

搜索 CC GUI (Claude or Codex)，点击安装，完成后 重启 PyCharm。

2. 安装依赖 SDK

重启后右侧工具栏打开 CC GUI；

进入 SDK依赖管理，分别安装 Claude Code SDK 和 Codex SDK；

等待依赖自动安装（耗时较长，耐心等待），显示版本号即为安装完成。

3. 关联本地 Codex 配置

在 CC GUI 中进入 设置 → 供应商管理，选择 Codex；

点击 显式授权，读取本地 ~/.codex/ 下的配置文件；

在模型列表中，可以手动添加魔芋 API 支持的任意模型，如 gpt-5-codex、qwen3.7-max、deepseek-r1 等，切换为当前使用模型。

4. 最终测试

在 CC GUI 输入对话指令，模型正常响应代码/问答内容，即 PyCharm 集成全部完成。

六、补充说明 & 避坑总结

1. 常见问题

• Codex 启动失败：检查配置文件中的 base_url 和 api_key 是否正确；
• API 调用无响应：核对 API Key、Base URL、模型名称是否填写错误；
• 环境变量不生效：setx 命令修改环境变量后，必须重启 CMD/PyCharm。

2. 模型选型建议

通过魔芋 API 平台，你可以根据场景灵活选择：

场景	推荐模型	理由
日常编码	GPT-5 Codex	编程专用，稳定性最佳
复杂推理	GPT-5 Thinking / DeepSeek R1	深度推理能力强
代码审查	Claude Sonnet 4	代码理解能力突出
快速原型	GPT-5	响应速度快，多模态支持
性价比首选	通义千问 qwen3.7-max	免费额度友好

3. 核心优势总结

相比传统逐个接入多个平台的方式，魔芋 API 方案的核心优势在于：

• 零重复注册：一个账号、一个 Key，覆盖所有主流模型
• 配置极简：只需修改一个配置文件，无需多个中转工具
• 稳定可靠：智能路由保障服务可用性，告别频繁报错
• 成本可控：统一账单、透明消费，支持按需付费

七、总结

本文通过 Codex++ 实现了 Codex 客户端的模型转发，先后完成DeepSeek、通义千问两款国产大模型接入，同时落地 PyCharm IDE 集成。同时通过魔芋 API 平台，实现了 Codex 客户端的一站式多模型接入，整套方案摆脱了原生海外模型限制，也免去了逐个注册配置多个平台的繁琐流程，开发者只需一个魔芋 API Key，即可灵活切换使用 GPT-5、Claude、DeepSeek、通义千问等所有主流大模型，适合开发人员日常调试、写代码、查 Bug 使用。