本帖子介绍了如何使用 OpenCodex 将第三方 AI API（如 DeepSeek、XAI、Kimi 等）及本地离线大模型（通过 Ollama 部署）接入 Codex 客户端，解除官方 Token 和模型限制，并支持多模型自由切换。

OpenCodex 保姆级部署与使用教程

1. 环境准备与 OpenCodex 安装

Step 1: 安装 Node.js 环境

1. 前往 Node.js 官网 下载并安装 LTS 版本。

2. 双击安装程序，全程使用默认参数配置，直至点击 Finish 完成。

3. 按 Win + R 输入 cmd 打开命令行终端，运行以下命令验证安装：

   Bash

node -v
npm -v

若能正常输出版本号，则说明环境配置成功。

Step 2: 安装 OpenCodex

1. 在 CMD 命令行终端中输入以下命令进行全局安装：

   Bash

npm install -g opencodex

(注：如遇权限或拦截报错，可尝试重新运行安装指令或使用管理员身份运行 CMD)

2. OpenCodex 启动与后台管理

1. 打开 CMD 终端，输入启动命令：

   Bash

opencodex

• 启动成功后，终端会显示本地服务网址（通常为 http://localhost:...）。

• 在浏览器中打开该 URL，即可进入 OpenCodex Web 控制面板（在此界面可统一管理模型提供商、日志监控和模型状态）。

• 注意：运行 OpenCodex 的 CMD 终端不能关闭，需保持后台运行。

3. 接入第三方 AI API（以 DeepSeek 为例）

1. 获取 API Key：登录 DeepSeek 开放平台，在“API keys”页面创建一个新的 API Key 并复制。

2. 配置提供商：

   • 在 OpenCodex Web 控制面板中点击 提供商 (Providers) -> 添加提供商。

   • 选择 付费 (Paid) 标签页中的 DeepSeek。

   • 将复制好的 API Key 粘贴进对应框内，点击 添加提供商 保存。

3. 切换使用：

   • 完全退出并重启 Codex 桌面客户端。

   • 打开 Codex 模型选择列表，即可直接选择 DeepSeek 模型进行对话。

4. 接入本地离线大模型（Ollama + OpenCodex）

Step 1: 安装 Ollama 与下载本地模型

1. 下载并安装 Ollama Windows 版。

2. 打开新的 CMD 终端，使用 ollama pull 命令拉取所需的本地模型（如 Gemma 4）：

   Bash

ollama pull gemma:latest

等待模型文件下载完成。

Step 2: 在 OpenCodex 中关联 Ollama

1. 返回 OpenCodex Web 控制面板，点击 提供商 -> 添加提供商。

2. 选择 免费 (Free) 标签页下的 Ollama（系统会自动预设好本地 URL [http://127.0.0.1:11434](http://127.0.0.1:11434)）。

3. 点击 添加提供商 保存。

4. 重启 Codex 客户端，在模型列表中选择拉取的本地模型（如 gemma）即可实现纯本地无限制对话。

5. 常用日常运维与卸载

• 禁用/删除模型：在 OpenCodex Web 控制面板的“提供商”页面中，可以随时对已添加的 API 或本地模型进行“禁用 (Disable)”或“删除 (Delete)”操作。

• 卸载 OpenCodex：若希望恢复 Codex 原生的默认官方状态，直接在 CMD 中运行以下命令卸载 OpenCodex 即可：

  Bash

npm uninstall -g opencodex