简介:codex配置文件一般情况不需要操作处理,在codex登陆的时候会自动创建好。什么时候需要处理呢?那就是在购买GPT的API的Token计费的时候会用到,通过sk-************配置gpt的接口,会调整一个config.toml的文件。

示例配置:

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://xxx.cn/v1"
wire_api = "responses"
requires_openai_auth = true

[marketplaces.openai-bundled]
last_updated = "2026-05-11T03:11:10Z"
source_type = "local"
source = "/Users/wyl/.codex/.tmp/bundled-marketplaces/openai-bundled"

[marketplaces.openai-primary-runtime]
last_updated = "2026-05-07T06:55:27Z"
source_type = "local"
source = "/Users/wyl/.cache/codex-runtimes/codex-primary-runtime/plugins/openai-primary-runtime"

[plugins."documents@openai-primary-runtime"]
enabled = true

[plugins."spreadsheets@openai-primary-runtime"]
enabled = true

[plugins."presentations@openai-primary-runtime"]
enabled = true

[plugins."browser-use@openai-bundled"]
enabled = true

[projects."/Users/wyl/Desktop/Workspace/php/project1"]
trust_level = "trusted"

[projects."/Users/wyl/Desktop/Workspace/go/project2"]
trust_level = "trusted"

一、逐行解释(最关键的部分)

1. 顶层模型配置(你用什么 AI)

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "high"
  • model_provider = “OpenAI”

    你选择的 AI 服务商是 OpenAI(也可以换成 Anthropic、DeepSeek 等)

  • model = “gpt-5.5”

    主对话 / 编码模型(这里写的是 gpt-5.5,实际不存在,是自定义 / 中转模型名)

  • review_model = “gpt-5.5”

    代码审查、代码校验用的模型

  • model_reasoning_effort = “high”

    AI 思考力度 = 高

    • low:快、简单
    • medium:平衡
    • high:思考更久、逻辑更强、token 消耗更多
  • requires_openai_auth = true(相对来说这个比较重要)

    • 不让服务端保存 response / conversation state,客户端每次请求都要把完整上下文重新发过去。

    • 影响是:

      • token 计费规则没变
      • 但由于每轮都重新上传更多上下文:
        • input tokens 会明显变大
        • 长对话下增长尤其明显
        • 上下文越长,烧 token 越快
    • 这个开关最初主要是给:

      • ZDR(Zero Data Retention)
      • 企业合规
      • 不允许 OpenAI 保存上下文
    • 所以如果你:

      • 不是企业合规需求
      • 不需要 Zero Data Retention
      • 只是个人使用 Codex

      那通常建议,不配置,默认即可,默认不写等同下面这中配置:

      disable_response_storage = false
      

2. OpenAI 服务商配置(接口地址)

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://xxx.cn/v1"
wire_api = "responses"
requires_openai_auth = true
  • base_url

    AI 接口的中转地址 / 第三方地址

    你这里是 https://xxx.cn/v1,说明不是官方 OpenAI,是国内中转 / 代理接口

  • wire_api = “responses”

    使用 OpenAI 的 Responses API(新版接口,比 chat/completions 更强)

  • requires_openai_auth = true

    需要 API Key 认证

3. 市场 / 运行时插件源(系统内置插件)

[marketplaces.openai-bundled]
[marketplaces.openai-primary-runtime]

这两个是插件市场来源

  • 本地插件存放路径
  • 最后更新时间

普通用户不用改

4. 插件开关(你能使用哪些 AI 功能)

[plugins."documents@openai-primary-runtime"]
enabled = true

[plugins."spreadsheets@openai-primary-runtime"]
enabled = true

[plugins."presentations@openai-primary-runtime"]
enabled = true

[plugins."browser-use@openai-bundled"]
enabled = true

这些是AI 能力开关

  • documents:读写文档(Word/Markdown)

  • spreadsheets:处理表格

  • presentations:生成 PPT

  • browser-use浏览器自动化(让 AI 自己打开浏览器操作网页)

    enabled = true
    

    就是已开启

5. 项目信任目录(AI 能读写哪些文件夹)

[projects."/Users/wyl/Desktop/Workspace/go/project2"]
trust_level = "trusted"

这是安全权限配置

  • trusted = 完全信任

  • 意味着 AI 可以读取、修改、创建、删除这个项目里的文件

  • 你这里信任了 2 个项目:

    • PHP 项目
    • Go 项目 project2

二、一句话总结(最精简版)

这份配置告诉你的 AI 编程助手三件事:

  1. 用 gpt-5.5 模型,走国内中转接口
  2. 开启文档、表格、PPT、浏览器自动化插件
  3. 允许 AI 自由操作你 2个 Go/PHP 项目的文件
Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐