Codex Desktop 自定义模型配置指南

最优方式：让 Codex 自动完成配置，而非手动编辑。

通用指令模板

code 
读取 ~/.codex/config.toml，添加自定义模型配置。
- 不覆盖已有配置
- API Key 禁止明文写入
- 完成后验证 TOML 语法，提示是否需重启

场景一：Ollama 本地模型

code

配置 Ollama 为 Codex 自定义模型。
- 健康检查：http://localhost:11434/v1/models
- model: qwen3:8b
- provider_id: local_ollama
- base_url: http://localhost:11434/v1
- wire_api: responses

场景二：DeepSeek API

code 
配置 DeepSeek API 为 Codex 自定义模型。
- model: deepseek-v4-pro
- provider_id: deepseek
- base_url: https://api.deepseek.com
- API Key 从环境变量 DEEPSEEK_API_KEY 读取，禁止写入 config.toml

场景三：本地部署（LM Studio / vLLM / SGLang）

code 
检查 http://127.0.0.1:8000/v1/models 可用性。
若可用，将首个模型配置为 Codex 自定义模型。
- provider_id: local_model
- base_url: http://127.0.0.1:8000/v1
- wire_api: responses（优先）

自检指令

code 
检查自定义模型配置：
- config.toml 语法合法性
- model_provider 与 provider_id 是否匹配
- base_url 是否正确
- API Key 是否未明文存储
- 是否需要 Responses 兼容代理层