Codex 接入 DeepSeek API 完整配置文档

Codex 接入 DeepSeek API 完整配置文档(文章由AI生成,经过本人测试)

架构说明

复制代码
Codex CLI (Windows) → hosts 劫持 127.0.0.1 → Caddy (HTTPS→HTTP) → LiteLLM (4446端口) → DeepSeek API

核心原理:让 Codex 以为自己连的是 OpenAI,实际通过两层代理转发到 DeepSeek。

最终效果 :Codex 里填任意 OpenAI 模型名(如 gpt-4.1),实际调用的是 deepseek-chat。


前置准备

  • Windows 10/11
  • Python 3.10+(已装 pip)
  • DeepSeek API Key(去 platform.deepseek.com 申请)
  • OpenAI Codex CLI 已安装

第一步:安装 LiteLLM

powershell 复制代码
pip install 'litellm[proxy]'

第二步:安装 Caddy

  1. 浏览器打开:https://caddyserver.com/api/download?os=windows&arch=amd64
  2. 下载后重命名为 caddy.exe
  3. 以管理员身份打开 PowerShell,移动文件:
powershell 复制代码
move C:\Users\你的用户名\Downloads\caddy.exe C:\Windows\System32\caddy.exe
  1. 验证安装:
powershell 复制代码
caddy version

第三步:修改 hosts 文件

  1. 以管理员身份打开记事本

  2. 文件 → 打开 → 路径输入:

    C:\Windows\System32\drivers\etc\hosts

  3. 文件类型选「所有文件」

  4. 末尾加一行:

    127.0.0.1 api.openai.com

  5. 保存,关闭

  6. 验证:

powershell 复制代码
ping api.openai.com
# 应该返回 127.0.0.1

第四步:创建 Caddy 配置文件

在桌面上新建文件 Caddyfile(注意:没有 .txt 后缀名),内容:

复制代码
api.openai.com:443 {
    tls internal
    reverse_proxy 127.0.0.1:4446
}

保存到 C:\Users\你的用户名\Desktop\Caddyfile


第五步:配置 Codex

编辑 C:\Users\你的用户名\.codex\config.toml:

toml 复制代码
model = "gpt-4.1"
model_provider = "local-relay"

[model_providers.local-relay]
name = "Local Relay"
api_base_url = "http://127.0.0.1:4446/v1"
env_key = "OPENAI_API_KEY"

[projects.'C:\Users\你的用户名\Desktop']
trust_level = "trusted"

[windows]
sandbox = "unelevated"
  • model 可以填任意 OpenAI 模型名(如 gpt-4.1、gpt-4o、o4-mini),别填非 OpenAI 的就行
  • api_base_url 和 model_provider 只是占位,实际请求被 hosts 劫持不经过这里

第六步:启动服务(每次使用前执行)

6.1 启动 LiteLLM

打开一个 PowerShell 窗口:

powershell 复制代码
$env:DEEPSEEK_API_KEY="你的DeepSeek API Key"
litellm --model deepseek/deepseek-chat --port 4446 --host 0.0.0.0

看到 Uvicorn running on http://0.0.0.0:4446 就是跑起来了。

这个窗口不要关。

6.2 启动 Caddy

以管理员身份打开另一个 PowerShell:

powershell 复制代码
cd C:\Users\你的用户名\Desktop
caddy run

看到 serving initial configuration 就是跑起来了。

这个窗口也不要关。


第七步:启动 Codex

再开一个 PowerShell 窗口:

powershell 复制代码
codex

输入任意内容测试,能正常回复即可。


日常使用流程

以后每次使用时:

  1. 启动 LiteLLM(普通 PowerShell 即可)
  2. 启动 Caddy(管理员 PowerShell)
  3. 启动 Codex

三个终端各司其职,关任何一个都会断。


常见问题排查

问题 检查项
Invalid HTTP request received Caddy 没启动,Codex 直连 LiteLLM 导致 HTTPS/HTTP 不匹配
ping api.openai.com 不是 127.0.0.1 hosts 文件没改对,用管理员身份重新编辑
Caddy 启动报权限错误 没以管理员身份运行
回复内容不像 DeepSeek 查看 LiteLLM 窗口日志,确认有请求;去 DeepSeek 后台看用量
想换其他模型 改 LiteLLM 启动命令,比如 --model deepseek/deepseek-reasoner 用 R1

切换模型速查

不用改任何配置,关掉 LiteLLM 换个命令重启即可:

powershell 复制代码
# DeepSeek V3(默认)
litellm --model deepseek/deepseek-chat --port 4446 --host 0.0.0.0

# DeepSeek R1(推理模型)
litellm --model deepseek/deepseek-reasoner --port 4446 --host 0.0.0.0

# 其他兼容 OpenAI 接口的模型
$env:OPENAI_API_KEY="你的其他key"
litellm --model openai/gpt-4.1 --port 4446 --host 0.0.0.0

卸载/还原

如需恢复原状:

  1. 删除 hosts 文件中 127.0.0.1 api.openai.com 这行
  2. 停掉 LiteLLM 和 Caddy
  3. 卸载:
powershell 复制代码
pip uninstall litellm
# 直接删除 caddy.exe

最后更新 :2026-04-24
适用版本:Codex v0.121.0+、LiteLLM 最新版、Caddy v2.x

相关推荐
世界是一片荒原10 小时前
给 DeepSeek Harness 做多会话工作台:四格原生会话、Agent 脉络图与压缩预警
deepseek
AI大模型-小华17 小时前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
AI英德西牛仔20 小时前
智谱清言导出word指令失效?PC端深度用户正在用“AI导出鸭”重构内容归档流
人工智能·重构·word·excel·deepseek·ai导出鸭
Jahzo1 天前
DSH 客户端二开实战(四):业务登录如何接入原生桌面与本地 Host
架构·deepseek
小七-七牛开发者2 天前
Anthropic:Agent 不必一直运行,也能持续工作
agent·claude·deepseek·anthropic·alwaysonagent
逐梦苍穹2 天前
不训练不微调:直接改权重矩阵,给小模型补上新能力
ai编程·codex·claudecode
大模型真好玩2 天前
做好真人分身却不知道拍什么?8个视频应用场景直接抄
人工智能·agent·deepseek
沉默王二3 天前
真狠啊,DeepSeek 开放全家桶 API。
人工智能·agent·deepseek
XLYcmy3 天前
基于大语言模型的智能漏洞检测与修复系统 作品报告评审分析报告 上
llm·prompt·模糊测试·漏洞修复·漏洞检测·deepseek·消融实验
CS_Zero4 天前
DeepSeek V4.1 Flash 1017 (Batch) 新手极速上手指南
开发语言·batch·deepseek