目录
保姆级 Codex 安装配置 + 接入 DeepSeek 等国产模型教程
kizzor
2026年06月08日 20:04
收录于文集
共7篇

「CodexPlusPlus版」

链接：https://pan.quark.cn/s/7b78f96ab8aa

前置核心原理（必看，避90%坑）

新版 OpenAI Codex（桌面App + CLI）强制使用 Responses API（/v1/responses），但 DeepSeek、通义、智谱、Ollama 所有国产模型只兼容 Chat Completions API（/v1/chat/completions），协议结构、工具调用、流式格式完全不互通。 不能直接改 base_url 对接，必须加一层本地协议转换代理桥，推荐2套零代码最简方案：

  1. CC-Switch（图形界面，新手首选，Windows/macOS/Linux）

  2. Moon Bridge（命令行桥，程序员/服务器部署）

一、第一步：安装 Codex（桌面App + CLI双版本）

1.1 桌面版 Codex.app（可视化，日常写代码首选）

  1. 官网下载：https://openai.com/codex

  2. 安装后不要登录OpenAI账号，我们全程用代理转发国产模型API

  3. 全局配置目录：

  • Windows：C:\Users\你的用户名\.codex\

  • macOS/Linux：~/.codex/

1.2 Codex CLI（终端命令行，自动化/脚本用）

Windows/macOS/Linux 一键安装

代码块
PlainText
自动换行
复制代码
# Node.js 18+ 环境（通用）
npm install -g @openai/codex

# macOS Homebrew
brew install --cask codex

# 验证安装成功
codex --version
复制成功

二、第二步：获取 DeepSeek API Key（国产模型密钥获取通用流程）

DeepSeek

  1. 打开平台：https://platform.deepseek.com/

  2. 注册登录 → 左侧「API Keys」→ 创建密钥，复制保存 sk-xxxx（只显示一次）

  3. 可用代码模型：deepseek-v4-pro、deepseek-coder-v2（代码专项更强）

其他国产模型补充入口

  • 通义千问：https://dash.aliyun.com/

  • 智谱GLM：https://open.bigmodel.cn/

  • Kimi(Moonshot)：https://platform.moonshot.cn/

  • 本地Ollama（离线）：ollama pull deepseek-coder

方案A：CC-Switch 图形化一键桥接（新手保姆级，推荐）

2.1 安装 CC-Switch

  1. 发布页下载对应系统安装包：网页链接​

  2. Windows双击exe、mac打开dmg、Linux解压运行

  3. 最低要求版本 ≥3.16.0（内置DeepSeek预设）

2.2 CC-Switch 配置 DeepSeek

  1. 打开软件，切换到 Codex 标签页

  2. 点击「添加供应商」，下拉直接选择 DeepSeek（预设填好协议、地址，不用手动输）

  3. 粘贴刚才复制的 sk-xxx API Key

  4. 右上角「设置」→ 路由 面板，打开「Codex路由总开关」

  5. 把DeepSeek拖拽到列表顶部，设为默认优先模型

2.3 Codex 全局配置（桌面+CLI通用）

1）编辑全局配置文件 config.toml

打开 .codex/config.toml，清空原有内容，粘贴下面全套配置：

代码块
PlainText
自动换行
复制代码
# 全局默认模型
model = "deepseek-v4-pro"
# 代理提供商标识
model_provider = "local_proxy"
# 代理服务地址（CC-Switch默认端口4000）
[model_providers.local_proxy]
name = "CC-Switch DeepSeek Bridge"
base_url = "http://127.0.0.1:4000/v1"
wire_api = "responses" # 告诉Codex走Responses协议格式
requires_openai_auth = true
cli_auth_credentials_store = "file" # 从文件读密钥，跳过网页登录弹窗
复制成功

2）创建密钥文件 auth.json

同目录新建 auth.json：

代码块
PlainText
自动换行
复制代码
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-这里填你的DeepSeek密钥"
}
复制成功

2.4 启动验证（关键步骤）

  1. 保持 CC-Switch全程后台打开、路由开启

  2. 完全退出Codex桌面App，重新打开

  3. 随便打开一个代码文件夹，输入指令：帮我写一个Python快速排序

  4. 终端CLI验证：

代码块
PlainText
自动换行
复制代码
# 直接运行codex对话
codex chat
# 读取整个项目重构代码
codex "重构整个前端Vue项目，拆分组件"
复制成功

能正常输出代码、执行文件修改=接入成功。

方案B：Moon Bridge 命令行桥（无GUI、服务器/纯终端）

3.1 拉取Moon Bridge源码

代码块
PlainText
自动换行
复制代码
git clone https://github.com/ZhiYi-R/moon-bridge.git
cd moon-bridge
复制成功

3.2 新建 config.yml 最小配置

代码块
PlainText
自动换行
复制代码
mode: "Transform"
server:
  addr: "127.0.0.1:38440" # 桥服务端口
models:
  deepseek-v4-pro:
    context_window: 128000
    max_output_tokens: 8192
providers:
  deepseek:
    base_url: "https://api.deepseek.com/v1"
    api_key: "sk-你的DeepSeek密钥"
offers:
  - model: deepseek-v4-pro
    provider: deepseek
复制成功

3.3 启动桥服务 + 生成Codex配置

代码块
PlainText
自动换行
复制代码
# 后台启动桥接服务
moonbridge --config config.yml &
# 自动生成Codex全局配置写入~/.codex
moonbridge --config config.yml --print-codex-config moonbridge --codex-base-url "http://127.0.0.1:38440/v1" --codex-home "$HOME/.codex" > "$HOME/.codex/config.toml"
复制成功

之后直接运行 codex 即可调用DeepSeek。

三、扩展：一键切换其他国产模型（通义千问/智谱/Ollama离线）

3.1 通义千问配置示例（CC-Switch）

  1. CC-Switch添加供应商选择「自定义OpenAI兼容」

  2. BaseURL：https://dashscope.aliyuncs.com/compatible-mode/v1

  3. API Key：阿里云dashscope密钥

  4. 模型名：qwen3.6-coder

3.2 本地Ollama离线DeepSeek-Coder（不消耗API余额）

  1. 先装Ollama：https://ollama.com/

  2. 拉取代码模型：ollama pull deepseek-coder:33b

  3. CC-Switch添加自定义供应商：

  • BaseURL：http://127.0.0.1:11434/v1

  • Key随便填（Ollama本地无鉴权，填sk-local即可）

  • 模型名：deepseek-coder:33b

3.3 多模型共存切换技巧

  1. 在config.toml里写多个provider块

  2. CLI临时切换模型，不用改配置文件：

代码块
PlainText
自动换行
复制代码
# 临时用智谱GLM
codex chat --model glm-4-coder --model-provider local_proxy
# 临时切本地Ollama
codex chat --model deepseek-coder:33b
复制成功

四、Windows/macOS 分步避坑细节

Windows专属路径快速打开

  1. 打开文件资源管理器，顶部地址栏输入：

代码块
PlainText
自动换行
复制代码
%USERPROFILE%\.codex
复制成功

  1. 新建文件注意：记事本保存时「保存类型=所有文件」，文件名直接输入.env/auth.json，不要带.txt后缀

macOS权限问题

代码块
PlainText
自动换行
复制代码
# 给配置文件夹完整读写权限
chmod 700 ~/.codex
# 密钥文件严格只读
chmod 600 ~/.codex/auth.json
复制成功

五、常见报错&修复

  1. Codex打开空白/卡在加载页 原因：CC-Switch没启动、路由开关没开；解决：先开CC-Switch再开Codex

  2. 401鉴权失败 检查auth.json密钥复制无误、无多余空格换行；不要给key加引号

  3. 模型无响应、超时 DeepSeek国内直连尚可，不稳定可配置代理；桥端口被占用就改CC-Switch/MoonBridge端口号

  4. 只能聊天，不能修改文件/执行命令 权限问题：项目文件夹右键授予读写权限；CLI用管理员/root运行一次

  5. 提示wire_api不匹配 config.toml必须写 wire_api = "responses"，写错成chat直接请求失效

六、安全重要提醒

  1. .env/auth.json存放明文API密钥，绝对不要上传Git、云盘

  2. 密钥泄露立刻去DeepSeek平台重置API Key

  3. 本地桥接所有请求只走本机127.0.0.1，数据不会经过第三方中转，隐私安全

  4. 离线Ollama方案完全无外网流量，适合内网保密项目开发

cv50226181