用途：codex-shim 是本地 Python API 代理，拦截 Codex Desktop 的模型请求并转发到 Factory BYOK（~/.factory/settings.json）、ChatGPT 订阅 GPT-5.5，或自定义 OpenAI/Anthropic/通用 chat completion 端点，从而绕过 Codex 服务端 Statsig 模型白名单。它暴露本地 Responses API 端点，由 Codex Desktop 指向。
主要能力：支持 OpenAI、Anthropic、DeepSeek、Gemini、OpenRouter、Z.ai 等模型；在 BYOK 模型旁保留 ChatGPT 订阅 GPT-5.5；不修改 ~/.codex/config.toml（用启动期覆盖）；在 Codex Responses API 与上游 API（OpenAI chat completions、Anthropic messages）间互译；对 Anthropic 形态提供方把 extended thinking 块译为 reasoning.encrypted_content；转发三个通用 MCP 工具（list_mcp_resources、list_mcp_resource_templates、read_mcp_resource）。
安装与用法：克隆 https://github.com/0xSero/codex-shim，用 python3 -m pip install --user aiohttp pytest 安装依赖（需 Python 3.11+），将 bin/codex-shim、bin/codex-app、bin/codex-model 软链到 ~/.local/bin。关键命令：codex-shim generate（读 Factory 设置生成 .codex-shim/custom_model_catalog.json）、codex-shim start/status/stop/restart（默认 127.0.0.1:8765）、codex-shim list、codex-model list、codex-model <slug>、codex-app [路径]、codex-shim codex -- chat "..."。可用 --settings 指定配置、--port 改端口。API key 通过环境变量提供。macOS 若模型不出现在选择器，需一次性 ASAR 补丁禁用 Statsig 隐藏过滤，并重算哈希、重签名；可通过备份回滚。chatgpt 认证模式存在 ~/.codex/auth.json 时自动生成 openai-gpt-5-5 代理到 chatgpt.com/backend-api/codex/responses。
适用场景：希望在 Codex Desktop 中使用自有密钥的多家模型或 ChatGPT 订阅额度、并绕过模型白名单的开发者。
限制：需 Python 3.11+ 与 aiohttp；macOS 选择器补丁有操作风险；Codex Desktop 不会展开各 MCP 服务器单独工具，属客户端行为。其余收费、价格等信息暂未提供。