codex-shim：让Codex Desktop支持GPT-5.5和任意BYOK模型的本地代理

开源项目codex-shim在GitHub上获得600+星标，它是一个本地Python代理服务器，能让Codex Desktop使用任意BYOK（Bring Your Own Key）模型，包括通过ChatGPT订阅访问GPT-5.5。对于想在Codex中使用非默认模型的开发者来说，这是一个非常实用的工具。

它解决什么问题

Codex Desktop只显示其服务端配置允许的模型。如果你有OpenAI、Anthropic、DeepSeek、Gemini、OpenRouter或本地代理模型，想在Codex的模型选择器中直接使用，codex-shim可以帮你实现。

核心思路：codex-shim在本地启动一个OpenAI Responses兼容的API端点，Codex连接到这个本地代理，代理再将请求路由到你配置的各个上游模型。

主要功能

1. BYOK模型集成到Codex选择器

不需要重新编译Codex，也不需要请求重放工作流。在~/.codex-shim/models.json中配置你的模型，它们就会出现在Codex的正常模型选择器中。

2. 原生Codex Agent循环保持完整

函数调用、工具输出、推理块、图像支持模型、shell命令元数据和流式SSE都会被正确翻译，而不是简单地扁平化为纯文本。

3. ChatGPT/Codex直通

如果~/.codex/auth.json有有效的Codex访问令牌，代理可以将Codex的原生/v1/responses流量路由到ChatGPT的Codex后端，使用当前Codex构建中的gpt-5.5标识符。

4. 代理友好架构

可以在代理前面再放一个本地代理，用于去重模板、注入稳定指令、修复伪工具文本或按策略路由提示。

安装和使用

环境要求

• Python 3.11+
• Codex CLI/Desktop已安装并认证
• 配置文件：~/.codex-shim/models.json（BYOK模型）或~/.codex/auth.json（ChatGPT直通）

基本设置

# 克隆项目
git clone https://github.com/0xSero/codex-shim.git
cd codex-shim

# 安装依赖
pip install -e .

# 配置模型
# 编辑 ~/.codex-shim/models.json 添加你的模型

# 启动代理
codex-shim

模型配置示例

在models.json中，你可以配置多种上游模型：

• OpenAI兼容端点（包括本地Ollama、LM Studio）
• Anthropic Messages API
• DeepSeek API
• OpenRouter
• 任何OpenAI格式的chat端点

实际效果

据项目维护者测试，在ChatGPT直通模式加前端提示代理的组合下：

• 计费输入token量减少了数倍
• 实际响应时间明显快于基线路由
• Codex的原生UX完全保持

需要注意的是，这些数据来自维护者的内部测试，项目中没有提供可复现的基准测试脚本。

适用场景

• 模型灵活性：想在Codex中尝试不同模型的效果
• 成本优化：通过BYOK使用更便宜的模型
• 本地推理：将Codex连接到本地Ollama等服务
• GPT-5.5访问：通过ChatGPT订阅在Codex中使用GPT-5.5

项目链接

https://github.com/0xSero/codex-shim

本文参考来源：GitHub – 0xSero/codex-shim