Codex国内用户完整指南：安装+官方插件配置全流程（手把手）

对于国内开发者来说，有效使用Codex及其全部官方插件一直是个挑战，因为网络限制和配置障碍。这篇新手友好、"手把手喂饭"式指南拆解从安装到插件激活的完整流程，确保即使非技术用户也能无复杂配置地利用Codex的全部能力。

1. 此国内友好配置的核心优势

无需特殊网络：普通国内网络即可使用（无需VPN）。
全部官方插件可用：激活所有8+官方Codex插件（浏览器、终端、文件管理等）。
连接稳定：使用国内API网关，避免延迟或断连。
零编程经验也能用：按复制粘贴命令和可视化步骤操作即可。

2. 准备工作（3样东西）

一台Windows 10/11或macOS 12+电脑（64位，建议8GB+内存）。
一个免费的DeepSeek API Key（替代GPT的国产AI模型）。
10分钟时间（整个流程精简到10分钟以内）。

3. 第一步：下载Codex客户端（国内镜像）

Codex官方下载在国内可能无法访问——使用可信国内镜像：

访问Codex国内镜像（阿里云托管，安全可用）。
选择对应系统版本：
- Windows：下载 Codex-Setup-1.8.2.exe（58MB）。
- macOS：下载 Codex-1.8.2.dmg（62MB）。
双击安装——无需自定义设置（直接点"下一步"→"安装"→"完成"）。

4. 第二步：配置国产AI模型连接

Codex默认使用ChatGPT，我们将其连接到DeepSeek实现稳定访问：

安装后打开Codex，点击左下角"Settings"（齿轮图标）。
选择"Model Configuration" → "Custom API"。
填写以下信息：

API Provider: DeepSeek
API Base URL: https://api.deepseek.com/v1
API Key: [在此粘贴你的DeepSeek API key]
Model: deepseek-chat

点击"Test Connection"——显示绿色"Connected Successfully"即成功。
点击"Save"保存设置。

如何获取DeepSeek API Key（30秒教程）

前往DeepSeek开放平台，用手机号注册。
登录后点击"API Keys" → "创建新Key"。
命名Key（如"Codex使用"），点击"生成"——立即复制Key（不会再显示）。

5. 第三步：安装全部官方Codex插件

Codex的强大在于插件——以下是安装和启用全部官方插件的方法：

在Codex中点击左侧边栏的"Plugins"（拼图图标）。
点击"Install Official Plugins" → 选择"All Plugins"（或勾选需要的单个插件）：
- Browser（浏览器）：网页搜索和页面抓取。
- Terminal（终端）：运行Shell命令。
- File Manager（文件管理）：读写本地文件。
- Code Interpreter（代码解释器）：执行Python/R代码。
- PDF Reader（PDF阅读器）：分析PDF文档。
- Image Generator（图片生成器）：文本生成图片。
- Excel Processor（Excel处理器）：编辑分析Excel文件。
- Git Integration（Git集成）：管理Git仓库。
点击"Install"——等待20秒下载所有插件。

验证插件激活

运行此测试提示词确认插件工作：

使用Browser插件搜索"2024年最佳Python框架"，然后用File Manager插件将结果保存为桌面上的"python-frameworks-2024.txt"文件。

6. 第四步：实战用例

1. 自动化文件整理（File Manager插件）

使用File Manager插件整理我的"下载"文件夹：
1. 创建子文件夹："文档"、"图片"、"视频"、"其他"。
2. 将所有.pdf/.docx/.txt文件移动到"文档"。
3. 将所有.jpg/.png/.gif文件移动到"图片"。
4. 将所有.mp4/.mov文件移动到"视频"。
5. 将剩余文件移动到"其他"。
6. 生成每个文件夹移动了多少文件的摘要。

2. 运行代码片段（Code Interpreter插件）

使用Code Interpreter插件：
1. 计算前100个质数的和。
2. 生成显示这些质数分布的柱状图。
3. 将图表保存为桌面上的"prime-numbers-chart.png"。
4. 输出最终和及文件路径。

3. 分析PDF数据（PDF Reader插件）

使用PDF Reader插件：
1. 打开"文档"文件夹中的"sales-report-2024.pdf"。
2. 提取前5页的所有数字销售数据。
3. 计算总收入和月均销量。
4. 将分析结果保存为同文件夹下的"sales-analysis-2024.txt"。

7. 常见问题排查

问题1：插件安装失败

# Windows
cd C:Program FilesCodex
codex --repair-plugins

# macOS
cd /Applications/Codex.app/Contents/MacOS
./Codex --repair-plugins

问题2：API连接错误

确保API Key未过期（DeepSeek Key有效期90天）。
检查网络连接是否稳定。
重新输入API Base URL：https://api.deepseek.com/v1（无拼写错误）。

问题3：Terminal插件不工作（Windows）

打开Codex → "Plugins" → "Terminal" → "Settings"。
选择"Use PowerShell"（默认是Command Prompt）。
点击"Save"后重试运行命令。

常见问题

用这个配置使用Codex需要ChatGPT账号吗？

不需要。通过将Codex配置为使用DeepSeek作为后端模型，你完全绕过了ChatGPT。只需一个免费的DeepSeek API Key。这使得Codex不受OpenAI账号限制或地域约束。DeepSeek API也便宜得多——约为OpenAI定价的二十分之一。

除了DeepSeek还能用其他国产模型吗？

可以。同样的配置模式适用于任何OpenAI兼容的API。你可以通过更改设置中的API Base URL和模型名称使用月之暗面（Kimi）、智谱AI（GLM）或百度文心一言。关键是模型必须支持OpenAI兼容的chat completions端点。推荐以DeepSeek作为起点，因为其编码性能出色且成本低。

如果Codex更新破坏了配置怎么办？

Codex更新通常保留自定义API配置。如果重大更新重置了你的设置，只需重复第二步（重新输入API详情）。你的DeepSeek API Key仍然有效。对于更新后的插件问题，运行 codex --repair-plugins 如上文排查部分所示。

下一篇： Claude动态工作流：把一个AI变成百人团队 →