Codex 配置文件 config.toml 示例
API 和 outh 通用，让你的 Codex 发挥最大能力。
##################################################################################
# 默认对话/执行使用的模型。
model = "gpt-5.5"
# 默认模型服务商 id，必须匹配 [model_providers.<id>]。
model_provider = "OpenAI"
# 推理强度。常见值从低到高如 low/medium/high/xhigh；越高通常越慢、成本越高，但复杂任务更稳。
model_reasoning_effort = "xhigh"
# 服务等级。priority=优先层级；standard=标准层级；不设置默认使用标准层级。
service_tier = "priority"
# 命令审批策略。never=不审批直接执行；on-request=需要时询问；untrusted=只自动运行可信命令。
approval_policy = "untrusted"
# 命令沙箱权限。danger-full-access=文件和网络都不限制；workspace-write=限制在工作区；read-only=只读。
sandbox_mode = "workspace-write"
# /review 使用的模型。通常与 model 保持一致；也可以设成更便宜/更快的审查模型。
review_model = "gpt-5.5"
# 是否隐藏不稳定功能警告。true=少提示；false=显示提醒。
suppress_unstable_features_warning = true
# 审批由谁判断。user=用户自己；auto_review=自动审查器。approval_policy=never 时不生效。
approvals_reviewer = "user"
# 模型服务商配置总表；下面每个子表是一个 provider id。
[model_providers]
##################################################################################
# 模型服务商配置。模型服务商名会决定你的历史对话的路径，使用模型服务商A时，看不到模型服务商B的历史对话，因此不建议随意更改。特别地，如果你使用OpenAI这个服务商，则可以调用OpenAI官方强大的远程压缩。因此无论你是用API还是outh，都建议按如下配置。
[model_providers.OpenAI]
# provider 展示名。通常和表名一致。
name = "OpenAI"
# API 协议。responses=Responses API；chat/completions 等值取决于 provider 支持。
wire_api = "responses"
# 是否要求 OpenAI/ChatGPT 登录认证。true=需要；false=不需要。
requires_openai_auth = true
# provider 是否支持 websocket/realtime 通讯。true=支持；false=普通 HTTP。注意，网络较差时应该关闭此选项。
supports_websockets = true
##################################################################################
# 功能开关区。一般 true=启用，false=禁用。
[features]
# 启用项目 Hook。可以理解为能够在每次对话时自动注入你预先配置的提示词。
hooks = true
# 启用 Codex 记忆功能入口。
memories = true
# 任务运行时防止电脑空闲睡眠。
prevent_idle_sleep = true
# 新版 @mention/引用能力。感觉没什么存在感。
mentions_v2 = true
# Fast 模式 UI/逻辑。
fast_mode = true
# Computer Use 插件能力。强大的电脑控制插件。
computer_use = true
# 远程压缩 v2。采用新的返回体结构，通过v1/responses而不是v1/responses/compact返回压缩的上下文。部分API站点不支持，导致远程压缩会报错，此时需要关闭v2。但仅仅改这个字段不够，因为app将v2强制开启写到了代码里，还需要去改源码重新打包。
remote_compaction_v2 = true
# 远程连接能力。
remote_connections = true
# Chronicle 屏幕/历史上下文能力。
chronicle = true
# JavaScript REPL 功能开关。
js_repl = false
##################################################################################
# Codex Desktop 桌面端 UI/交互偏好。主要影响界面，不影响模型能力。
[desktop]
# 桌面端主题。dark=深色；light=浅色；system=跟随系统。
appearanceTheme = "dark"
# 插电时保持远程控制唤醒。true=减少远程会话断；false=按系统策略。
keepRemoteControlAwakeWhilePluggedIn = true
# Codex 创建 Git 分支时的默认前缀。
git-branch-prefix = "ryan/"
# 桌面端语言覆盖。zh-CN=简体中文；空/删除通常跟随系统。
localeOverride = "zh-CN"
# review 展示方式。detached=独立/分离展示；其它值取决于客户端支持。
reviewDelivery = "detached"
# 后续消息队列模式。steer=新消息用于调整当前线程/任务。
followUpQueueMode = "steer"
# 听写词典。空数组=[] 表示不额外添加专有词。
dictationDictionary = []
# 会话详情显示粒度。STEPS_COMMANDS=显示步骤和命令。
conversationDetailMode = "STEPS_COMMANDS"
# 任务运行时防止睡眠。true=桌面端保持运行；false=按系统策略。
preventSleepWhileRunning = true
# 默认终端面板位置。right=右侧；bottom=底部。
defaultTerminalLocation = "right"
##################################################################################
# Codex 记忆功能配置。控制是否读取/生成本机长期记忆。
[memories]
# 是否允许生成新记忆。
generate_memories = true
# 是否读取已有记忆。
use_memories = true
##################################################################################
# 终端 UI 配置区。
[tui]
# 模型可用性提示/新手引导状态。
[tui.model_availability_nux]
# 模型可用性提示状态。数值由 Codex 自动写入；建议不要手工修改。
"gpt-5.5" = 2
##################################################################################
# 提示通知状态。通常是 Codex 自动写入，用于少显示某些提示。
[notice]
# Fast 默认选择提示状态。true=已选择/不再提示；false=可能继续提示。
fast_default_opt_out = true
##################################################################################
# 遥测/指标总开关。用于减少 Codex 收集数据上报。
[analytics]
# 是否启用 Codex 默认 analytics/metrics。false=关闭默认指标上报，包括默认 ab.chatgpt.com metrics；true=允许上报。
enabled = false
##################################################################################
# 反馈功能开关。
[feedback]
# 是否启用 /feedback 提交。
enabled = false
##################################################################################
# OpenTelemetry 遥测导出配置。
[otel]
# OTel 日志 exporter。none=不导出；otlp-http/otlp-grpc=导出到自定义观测平台。
exporter = "none"
# OTel trace exporter。none=不导出调用链；启用后会把 trace 发到指定平台。
trace_exporter = "none"
# OTel metrics exporter。none=不导出指标；statsig=默认 ab.chatgpt.com 指标端点；otlp-* = 自定义端点。
metrics_exporter = "none"
# 是否在 OTel 日志/trace 中记录用户 prompt 原文。false=不记录；true=记录，隐私风险更高。
log_user_prompt = false
##################################################################################
# 插件启用状态总表。每个子表对应一个插件包。
[plugins]
# 单个插件启用状态。enabled=true 表示启用；false 表示禁用该插件。
[plugins."github@openai-curated"]
# 是否启用这个插件。true=启用；false=禁用。
enabled = true
[plugins."cloudflare@openai-curated-remote"]
enabled = true
##################################################################################
# MCP 服务配置总表。每个子表是一个本地 stdio MCP 服务。
[mcp_servers]
# 单个 MCP 服务配置。command/args 决定如何启动它。
[mcp_servers.context7]
# MCP 传输类型。stdio=通过本地进程标准输入输出通信；http/ws 取决于服务支持。
type = "stdio"
# 启动 MCP 服务的可执行文件路径。路径失效会导致该 MCP 不可用。
command = "./.local/bin/npx"
# 启动 MCP 服务时传给 command 的参数。npx -y 会临时下载/运行 npm 包。
args = ["-y", "@upstash/context7-mcp"]
# 该 MCP 服务的环境变量。
[mcp_servers.context7.env]
# Context7 使用的密钥。
CONTEXT7_API_KEY = ""
# 传给 MCP 子进程的 PATH。决定它能找到哪些命令。
PATH = ""
##################################################################################
# 插件市场来源缓存。通常由 Codex 自动维护。
[marketplaces]
# 单个插件市场来源缓存。通常自动维护。
[marketplaces.openai-bundled]
# 插件市场缓存更新时间。通常自动维护。
last_updated = ""
# 插件市场来源类型。local=本地目录；remote/git 取决于版本支持。
source_type = "local"
# 插件市场本地路径。路径失效会影响插件发现/更新。
source = ""
##################################################################################
# 已信任项目列表。trust_level=trusted 表示允许该项目按信任规则运行。
[projects]
# 单个项目的信任记录。
[projects.""]
# 项目信任级别。trusted=信任此项目配置/Hook；未信任项目限制更多。
trust_level = "trusted"
##################################################################################
# Hook 信任状态总表。通常由 Codex 自动维护。
[hooks]
# 已信任的项目 Hook 哈希。hash 匹配时 Codex 认为该 Hook 没被篡改。
[hooks.state]
# 单个 Hook 的信任哈希记录。通常自动维护，不建议手工改。
[hooks.state.""]
# Hook 内容的可信哈希。Hook 文件变化后需要重新信任。
trusted_hash = ""
常用工具
如果使用API，则fast/部分插件不可用，需要每次更新后自己修改：
解决 gpt 5.5 最近因思考截断导致降智的方案：
其他推荐的工作流/工具：
- 最强agent工作流Trellis
- 最强outh/MCP/Skill/提示词/配置本地管理工具