文档中心内部

配置文件

告诉 Codex 两件事:找谁干活、凭什么让它干。

装完 Codex 之后,它还缺什么?

缺两张纸条:一张写"找谁",一张写"凭什么"。

📄config.toml用哪个模型
发到哪个地址
+
🔑auth.json你的通行证
→
✅能干活了敲 codex 就能用

都是纯文本,随便什么编辑器都能改;写错重贴一遍,弄不坏电脑。

本次更新 · 四处过时

早先发的那份有四行要动:两行改值,两行删掉。

✕ 旧的(发出去的那份)
  • model = "gpt-5.5"
  • service_tier = "fast"
  • disable_response_storage = true
  • preferred_auth_method = "apikey"
✓ 现在该是
  • model = "gpt-6-astra"
  • service_tier = "default"
  • 这两行 整行删掉
删不删都不会报错

后两行留着也不报错——多余的设置项会被忽略;只是当前版本的 Codex 里已经没有这两项了,写了也不看。建议删掉,保持干净。

动手改

先看一眼你的 config.toml 有多长,这决定了你该用哪种改法。没有这个文件?先跳到下一节建好再回来。

📄就十几行,到此为止刚装完、还没怎么用
→ 整段替换最省事
或
📋下面还有一大堆有 [projects]、[desktop]、[plugins] 这类段落
→ 只改那四行
用过一阵的机器,千万别全选删掉

Codex 会把它自己的设置也写进同一个文件:你已经授权过的项目目录、桌面应用的字号、装好的插件。这些都排在后面。全选删掉再粘贴,它们会一起没——插件被关掉、项目要重新授权、桌面设置回到出厂。

情况一 · 刚装完,文件很短

全选(Ctrl + A / Cmd + A)删掉,整段贴下面这份保存。

~/.codex/config.toml · 整段替换
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访达 → 前往 → 前往文件夹

没有就建一个。没提示即成功,提示"已存在"也照样往下。

Windows · 按 Win + R 输入 cmd 回车,再粘贴这行
mkdir %USERPROFILE%\.codex
macOS · 打开「终端」,粘贴这行
mkdir -p ~/.codex
Windows 必看:先打开两个开关

点开头的文件夹默认隐藏,后缀名也默认藏着。不打开,你看不到 .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_window
model_auto_compact_token_limit
一次能记住多少、到多少时自动压缩旧聊天。保持默认
service_tier服务档位,保持默认
base_url接口地址,请求都发到这里
wire_api
requires_openai_auth
协议细节,照抄即可
这两行放开了权限,先看懂再用

sandbox_mode = "danger-full-access" 给了它完整的文件读写权限,approval_policy = "never" 让它不再逐步问你。你说一句话,它自己干完,中间不打断。

这么设是为了让它真能动手改文档,否则每个字都要确认。代价是当前文件夹里的东西它能随意增删改——别在你不认识、不想被改的文件夹里启动它。

auth.json 和你的密钥

同样在 .codex 里新建文本文件,改名 auth.json(后缀是 .json,不是 .txt)。把引号之间那串换成管理员给的密钥,其余符号原样保留,都是英文半角。

~/.codex/auth.json · 整段替换
{
  "OPENAI_API_KEY": "sk-xxxxxxxx(找管理员要)"
}
付款密码
这串密钥按用量计费,谁拿到谁就能花公司的钱。
四个不要,一个要

不要截图发群、不要贴进在线工具或问答网站、不要传到 GitHub 或网盘、不要写进邮件正文。别人要用,让他找管理员单独要。

换电脑、离职、工作转交时要通知管理员重置。怀疑泄露就马上说一声——重置很快,不追究,越早说损失越小。

检查清单

1两个文件都在config.toml
auth.json
→
2名字没多后缀不是 config.toml.txt
→
✓内容是新版gpt-6-astra + default
且删掉了那两行

里面还有别的文件不用管。第 2 条不对就是后缀名开关没开,回上面勾上再改名。三条都对即完成;报错去出错了怎么办按症状查。

土土金内部文档 · 本页最后更新 2026-09-09

内容有误或步骤跑不通,请把页面地址和截图发给内部技术支持。