配置文件
告诉 Codex 两件事:找谁干活、凭什么让它干。
装完 Codex 之后,它还缺什么?
缺两张纸条:一张写"找谁",一张写"凭什么"。
发到哪个地址
都是纯文本,随便什么编辑器都能改;写错重贴一遍,弄不坏电脑。
本次更新 · 四处过时
早先发的那份有四行要动:两行改值,两行删掉。
model="gpt-5.5"service_tier="fast"disable_response_storage=truepreferred_auth_method="apikey"
model="gpt-6-astra"service_tier="default"- 这两行 整行删掉
后两行留着也不报错——多余的设置项会被忽略;只是当前版本的 Codex 里已经没有这两项了,写了也不看。建议删掉,保持干净。
动手改
先看一眼你的 config.toml 有多长,这决定了你该用哪种改法。没有这个文件?先跳到下一节建好再回来。
→ 整段替换最省事
[projects]、[desktop]、[plugins] 这类段落→ 只改那四行
Codex 会把它自己的设置也写进同一个文件:你已经授权过的项目目录、桌面应用的字号、装好的插件。这些都排在后面。全选删掉再粘贴,它们会一起没——插件被关掉、项目要重新授权、桌面设置回到出厂。
情况一 · 刚装完,文件很短
全选(Ctrl + A / Cmd + A)删掉,整段贴下面这份保存。
model_provider = "crs"
model = "gpt-6-astra"
model_reasoning_effort = "xhigh"
personality = "friendly"
sandbox_mode = "danger-full-access"
approval_policy = "never"
model_context_window = 1000000
model_auto_compact_token_limit = 800000
service_tier = "default"
plan_mode_reasoning_effort = "xhigh"
[model_providers.crs]
name = "crs"
base_url = "https://api.tutujin.com/v1"
wire_api = "responses"
requires_openai_auth = true
情况二 · 已经用过一阵
只找下面这四行改,其它一行都别动。改完保存,重开 Codex 就生效。
| 找到这一行 | 怎么处理 |
|---|---|
model = "gpt-5.5" | 改成 model = "gpt-6-astra" |
service_tier = "fast" | 改成 service_tier = "default" |
disable_response_storage = true | 整行删掉 |
preferred_auth_method = "apikey" | 整行删掉 |
这四行都在文件最上面那一段,也就是第一个方括号段落(形如 [model_providers.crs])之前。方括号往下的内容一个字都不该变。
这两个文件放在哪
要放在你自己的用户文件夹下那个叫 .codex 的子文件夹里,不是公司发的"codex 教学"文件夹——那只是安装材料,Codex 不看它。
| 系统 | 文件夹位置 | 怎么打开 |
|---|---|---|
| Windows | %USERPROFILE%\.codex | 地址栏粘贴,回车 |
| macOS | ~/.codex | 访达 → 前往 → 前往文件夹 |
没有就建一个。没提示即成功,提示"已存在"也照样往下。
mkdir %USERPROFILE%\.codex
mkdir -p ~/.codex
点开头的文件夹默认隐藏,后缀名也默认藏着。不打开,你看不到 .codex,还会建出 config.toml.txt、auth.json.txt 这种假文件——最常见的失败原因。
- 打开开关:Windows 资源管理器 查看 → 显示,勾上「隐藏的项目」和「文件扩展名」;macOS 按
Cmd + Shift + . - 再建文件:进
.codex右键 → 新建 → 文本文档,全名改成config.toml(连.txt一起去掉),弹窗选是;macOS 用文本编辑器新建即可
每一行是什么意思
不用背。要留意的只有中间那两行安全设置。
| 设置项 | 人话解释 |
|---|---|
model_provider | 用哪家的服务。填 crs,指向下半部分那个通道 |
model | 用哪个模型,相当于请哪位专家干活 |
model_reasoning_effort | 想多久再回答:low / medium / high / xhigh。越高越聪明也越慢越贵,日常可用 medium |
plan_mode_reasoning_effort | 同上,只在计划模式下生效 |
personality | 说话风格。friendly 客气,pragmatic 直接 |
sandbox_mode | 允许它读写你电脑上的文件——见下方 |
approval_policy | 是否每步弹窗问你。never 是不问——见下方 |
model_context_windowmodel_auto_compact_token_limit | 一次能记住多少、到多少时自动压缩旧聊天。保持默认 |
service_tier | 服务档位,保持默认 |
base_url | 接口地址,请求都发到这里 |
wire_apirequires_openai_auth | 协议细节,照抄即可 |
sandbox_mode = "danger-full-access" 给了它完整的文件读写权限,approval_policy = "never" 让它不再逐步问你。你说一句话,它自己干完,中间不打断。
这么设是为了让它真能动手改文档,否则每个字都要确认。代价是当前文件夹里的东西它能随意增删改——别在你不认识、不想被改的文件夹里启动它。
auth.json 和你的密钥
同样在 .codex 里新建文本文件,改名 auth.json(后缀是 .json,不是 .txt)。把引号之间那串换成管理员给的密钥,其余符号原样保留,都是英文半角。
{
"OPENAI_API_KEY": "sk-xxxxxxxx(找管理员要)"
}
不要截图发群、不要贴进在线工具或问答网站、不要传到 GitHub 或网盘、不要写进邮件正文。别人要用,让他找管理员单独要。
换电脑、离职、工作转交时要通知管理员重置。怀疑泄露就马上说一声——重置很快,不追究,越早说损失越小。
检查清单
config.tomlauth.jsonconfig.toml.txtgpt-6-astra + default且删掉了那两行
里面还有别的文件不用管。第 2 条不对就是后缀名开关没开,回上面勾上再改名。三条都对即完成;报错去出错了怎么办按症状查。