技能介绍

要解决什么问题

Codex CLI 在 0.142.x 版本起把 wss://api.openai.com/v1/responses 写死在代码里，base_url 之类的配置项一律不生效。这意味着你无法像其他 OpenAI 兼容工具那样，把 Codex 指到本地或国产模型的端点上。本项目的思路是在本机搭一条 WSS 桥接：让 Codex 以为自己在和 OpenAI 说话，实际流量被劫持转发到 FreeLLMAPI，再由 FreeLLMAPI 路由到 DeepSeek、Qwen、GLM、Kimi 等国产模型或任何 OpenAI 兼容 API，全程无需 OpenAI Key。

它是怎么工作的

核心链路可以拆成几个关键环节：

DNS 劫持：以管理员权限修改 hosts 文件，把 api.openai.com 的 IPv4/IPv6 都指向 127.0.0.1，让 Codex 的连接请求落到本机。
绕过系统代理：Windows 上 Codex 走系统代理，若代理未排除 api.openai.com，流量会绕过 hosts 直接连到真实 OpenAI，这是最常见的翻车点。
TLS 证书链：Codex 的 Rust TLS 栈不接受普通自签名证书（报 CaUsedAsEndEntity），必须生成 CA → 服务器证书的标准证书链，并把 CA 装进 Windows 受信根。
WSS 桥接：FreeLLMAPI 自带的 bridge-443.mjs 绑定 443 端口，把 Codex 的请求转发到本地 FreeLLMAPI，再按 /v1/responses 端点自动路由到目标模型。

部署步骤包括清理旧环境、hosts 劫持、代理排除、生成并安装证书、启动桥接脚本、端到端验证 SSE 流。FreeLLMAPI 的 Keys 页面添加各家模型 key 即可使用。

适用边界与注意点

仅支持 CLI：Codex 桌面版不支持自定义 API 端点，此方案只能在命令行使用。
Windows 沙箱限制：默认 sandbox 会拦截所有 PowerShell 命令，建议让 Codex 输出方案后手动应用；--yolo 可绕过但有安全风险。
免费额度受限：FreeLLMAPI 有 cooldown 机制，可能遇到 All models rate-limited；key 重启后可能因加密密钥丢失失效，需重新获取。
桥接启动依赖管理员权限：443 端口绑定需要 UAC 确认，批处理启动失败时优先检查端口监听状态。

整体上，这是一个典型的中间人代理方案，适合在 Windows + Codex CLI 环境下想零成本使用国产模型的开发者，前提是你能接受 hosts 劫持和本机证书这类稍显 hacky 的配置方式。