陈少文的博客
·
Codex 自定义模型配置与使用技巧
内容提要
本文介绍了Codex的配置方法，包括用户配置文件位置、模型提供者的自定义设置、常见提供者的配置示例，以及如何使用Profile切换模型。同时强调了安全性和项目信任标记的重要性，并提供了日常开发和CLI使用技巧。
关键要点
-
Codex 的用户配置文件默认位置为 ~/.codex/config.toml，Windows 为 %USERPROFILE%\.codex\config.toml。
-
配置优先级从高到低依次为：CLI 参数、项目配置、Profile 文件、用户配置和系统配置。
-
项目级配置 .codex/config.toml 不能修改 model_provider、model_providers 和认证相关项。
-
Codex 通过 [model_providers.<id>] 定义第三方 endpoint，必须指定 model 和 model_provider。
-
常见提供者配置示例包括 OpenRouter、Azure OpenAI、本地 Ollama 和 DeepSeek。
-
Profile 是独立的 overlay 配置文件，用于按场景切换模型，命名规则为 ~/.codex/<profile>.config.toml。
-
项目必须标记为 trusted，Codex 才会加载项目内的配置和规则。
-
日常开发中可以使用 Profile 分流任务，CLI 技巧包括非交互执行和查看当前配置。
-
Codex CLI 适合长任务和脚本化执行，而 Cursor 更适合 IDE 内联编辑和多文件 diff 可视化。
延伸解读
配置优先级的重要性
Codex 的配置优先级从高到低依次为 CLI 参数、项目配置、Profile 文件、用户配置和系统配置。了解这一点可以帮助用户在多种配置中快速定位问题，确保所需的设置生效，尤其是在复杂项目中，合理利用配置优先级可以避免不必要的错误和混淆。
安全性与信任标记
项目必须标记为 trusted，Codex 才会加载项目内的配置和规则。这一安全机制确保了用户的配置不会被恶意修改，尤其是在多人协作的环境中，信任标记的使用至关重要，能够有效防止潜在的安全风险。
Profile 文件的灵活性
Profile 文件允许用户根据不同场景切换模型，命名规则为 ~/.codex/<profile>.config.toml。通过这种方式，用户可以在不同的开发任务中快速调整模型配置，提高工作效率，尤其适合需要频繁切换模型的开发者。
CLI 与 Cursor 的适用场景
Codex CLI 适合长任务和脚本化执行，而 Cursor 更适合 IDE 内联编辑和多文件 diff 可视化。了解这两者的适用场景，可以帮助开发者选择最合适的工具，提高开发效率，避免在不适合的环境中使用不合适的工具。
延伸问答
Codex 的用户配置文件默认位置在哪里？
~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml）。
如何定义第三方模型提供者？
通过 [model_providers.<id>] 定义，必须指定 model 和 model_provider。
Codex 的配置优先级是怎样的？
配置优先级从高到低依次为：CLI 参数、项目配置、Profile 文件、用户配置和系统配置。
如何使用 Profile 切换模型？
使用命令 codex --profile <profile_name> 切换到指定的 Profile。
项目必须如何标记才能加载配置和规则？
项目必须标记为 trusted，Codex 才会加载项目内的配置和规则。
Codex CLI 和 Cursor 有什么区别？
Codex CLI 适合长任务和脚本化执行，而 Cursor 更适合 IDE 内联编辑和多文件 diff 可视化。
