让 Codex 桌面版“原生支持”你自己的大模型：本地 API 转接神器 codex-shim

昆仑开源易选

2026-05-25 0 50

你是否用过 Codex Desktop（微软开源的 AI 编程助手桌面客户端），却苦恼于它只显示官方配置的模型列表，无法直接调用你本地部署的 DeepSeek、Qwen、Llama 3，或是 OpenRouter、Anthropic、Google Gemini 等第三方 BYOK（Bring Your Own Key）模型？codex-shim 就是为此而生——它是一个轻量级本地代理服务器，无需修改或重新编译 Codex，就能让你的私有/付费模型像内置模型一样，原生出现在 Codex 的模型选择器中，并完整保留函数调用、多模态流式响应、Agent 工作流等高级能力。

核心功能

零改造接入 BYOK 模型：自动读取 ~/.factory/settings.json（或任意兼容 JSON 配置），将本地部署的 LLM（如 Ollama、LM Studio、Text Generation WebUI）或带 API Key 的云模型（OpenAI、Anthropic、Z.ai、DeepSeek、Gemini、OpenRouter）无缝注入 Codex 模型列表
智能请求路由与协议翻译：作为本地 http://localhost:8000 的 OpenAI 兼容接口，接收 Codex 发出的标准 chat completions 请求，按模型类型自动分发至对应上游，并将响应精准转换为 Codex 所需的 SSE 流式格式
保留 Codex 原生体验：所有 Agent 功能（工具调用、代码执行、推理块、Shell 命令元数据、图像输入支持）均不降级，不丢失结构化输出，告别“请求重放”或“结果粘贴”的低效工作流
可选 ChatGPT Codex 模型直通：如果你拥有 ChatGPT Plus 订阅，可启用 GPT-5.5（Codex 专属模型）的代理转发，实现本地模型 + 云端最强模型的混合调度
跨平台纯 Python 实现：基于 aiohttp 构建，Windows/macOS/Linux 全支持；仅 macOS 用户需额外一步（可选）ASAR 补丁来解除 Codex 对自定义模型条目的隐藏限制
开箱即用的配置管理：支持 JSON 配置文件灵活定义模型别名、API 地址、认证方式、系统提示词、最大上下文等参数，一次配置，长期生效

适合哪些人用

这款工具特别适合：开发者、AI 工程师、技术博主、编程教育者——尤其是那些已搭建本地大模型服务（如通过 Ollama 运行 Qwen2.5-Coder 或 DeepSeek-Coder）、频繁切换不同 API 服务商、或希望在教学/演示中向团队展示“同一套 UI 下自由切换模型”的用户。如果你厌倦了反复导出/导入提示词、手动复制响应、或为每个模型单独开发插件，codex-shim 就是你一直在找的“隐形桥梁”。

快速上手

只需三步：

安装：确保已安装 Python 3.9+，运行 pip install codex-shim（项目已发布 PyPI）
准备模型配置：编辑 ~/.factory/settings.json（示例见 GitHub README），例如添加本地 Ollama 模型：{"models": [{"id": "qwen2.5-coder", "name": "通义千问-Coder", "api_base": "http://localhost:11434/v1", "api_key": "ollama"}]}
启动并配置 Codex：终端执行 codex-shim（默认监听 localhost:8000），打开 Codex Desktop → 设置 → API → 将 Base URL 改为 http://localhost:8000 → 重启。刷新模型选择器，你的自定义模型即刻现身！