
GPT-6.1 Terra Codex CLI 怎么切换:2条命令实测
GPT-6.1 Terra 在 2026 年 10 月 26 日发布后,已经进到 Codex CLI 里。切到它只需两条命令:启动时用 codex -m gpt-6.1-terra 直启,已经在会话里就用 /model 切换。前置要求就两点,一是 Codex CLI 版本不能低于 0.159.0,二是你的订阅得是 Plus、Pro、Business、Enterprise 或 Edu,普通免费 Chat 没有 Terra。下面从升级到验证给你完整步骤。
前置准备:版本和订阅两个硬门槛
切换前先确认两件事,缺一个都不行。
- Codex CLI 版本 ≥0.159.0。用
codex --version查当前版本,低于 0.159.0 就升级:npm install -g @openai/codex或按官方安装方式更新。版本太低会识别不了 gpt-6.1-terra 这个模型名。 - 订阅达标。Terra 只对 Plus、Pro、Business、Enterprise、Edu 用户开放,普通免费版用不了。如果你平时用的是免费 Chat,切了也没用,会提示无权限。
另外确认你已经登录并配置好了 Codex CLI 的 API Key,没配置过的先走一遍 codex login。

方法一:启动时直切
最直接的办法,在启动 Codex 时带上 -m 参数指定模型。
- 打开终端,进入你的工作目录。
- 执行
codex -m gpt-6.1-terra。 - 进入交互界面后,确认界面顶部或状态栏显示当前模型是 gpt-6.1-terra。
这条命令适合每次切换特定模型开工的场景,不用进界面再改。
方法二:会话内切换
已经在 Codex 交互界面里、想临时换模型,用会话内指令。
- 在 Codex 的输入框里输入
/model并回车。 - 弹出的模型选择浮层里选 gpt-6.1-terra。
- 确认当前会话已切换,继续对话。
这个方法不用退出重进,适合在任务中途根据难度换模型。

进阶:用 config.toml 固定默认模型
如果你长期用 Terra,可以直接改 Codex 的配置文件,让它默认就加载这个模型。配置文件在 ~/.codex/config.toml。
model = "gpt-6.1-terra"
model_reasoning_effort = "medium"
保存后重启 Codex,默认模型就是 Terra 了。model_reasoning_effort 用来设推理档位,默认 medium。
怎么确认模型真的切过去了
很多人切了但不确定有没有生效,给你三个可验证的信号。
- 界面显示:交互界面顶部或状态栏的模型名变成 gpt-6.1-terra。
- 行为特征:Terra 的 visual 推理和 computer use 表现明显,给它一个看屏幕截图的任务,看它能不能基于图像作答。
- 报错排除:如果切了之后报「model not found」或「not available for your plan」,说明版本没升级或订阅不达标,回到前置准备检查。
六档推理档位怎么选
Terra 按六档推理发布:non-reasoning、low、medium、high、xhigh、max,ChatGPT 里默认 medium。
| 档位 | 适合场景 | 备注 |
|---|---|---|
| non-reasoning | 简单格式转换 | 最快,最低成本 |
| low | 批量任务、粗筛 | 错误率 16.7%,比上代 53.6% 大降 |
| medium | 日常开发(默认) | 平衡档 |
| high | 复杂重构 | 精度更高 |
| xhigh | 疑难 bug | 成本明显上升 |
| max | 最复杂任务 | 最高档,错误率 4.3% |
档位越高越慢越贵,非必要别拉满。API 侧按 OpenAI 现行惯例用 reasoning_effort(Responses API 里是 reasoning.effort)对应 low/medium/high,xhigh 和 max 是否以同名值开放,以 API 参考为准。

ChatGPT Work 里怎么用(一段带过)
如果你不用命令行,ChatGPT Work 里也能用 Terra。Plus、Pro、Business、Enterprise、Edu 用户在 ChatGPT Work 或 Codex 里直接选模型即可,不需要命令行。缺点是 Work 里的推理档位默认 medium,不追求极致精度的话够用。
常见报错速查
| 现象 | 原因 | 解法 |
|---|---|---|
| model not found | Codex CLI 版本过低 | 升级到 ≥0.159.0 |
| not available for your plan | 订阅不达标 | 升级到 Plus/Pro/Business/Enterprise/Edu |
| 切换后没反应 | 没走 /model 或 -m | 确认命令拼写,模型名必须是 gpt-6.1-terra |
| 不知道现在用哪个模型 | 界面没显示 | 看顶部/状态栏,或用 /model 查看 |
常见问题
Codex CLI 里怎么切到 GPT-6.1 Terra?
两条命令:启动时执行 `codex -m gpt-6.1-terra`,会话内输入 `/model` 选择 gpt-6.1-terra。前提是 CLI 版本 ≥0.159.0 且订阅达标。
免费版能用 GPT-6.1 Terra 吗?
不能。Terra 只对 Plus、Pro、Business、Enterprise、Edu 用户开放,普通免费 Chat 没有 Terra。
GPT-6.1 Terra 有几个推理档位?
六档:non-reasoning、low、medium、high、xhigh、max,ChatGPT 里默认 medium。档位越高精度越高、成本越高。
怎么确认 Codex 真的切换到了 Terra?
看三点:界面顶部或状态栏模型名变为 gpt-6.1-terra;给它一个看图任务看能否图像作答;若报 model not found 说明版本或订阅有问题。
GPT-6.1 Terra API 价格多少?
标准 API 输入 $1/百万 token、缓存输入 $0.05/百万、输出 $5/百万,比 GPT-5.6 Terra 和 GPT-6.1 Sol 便宜 50%。

京ICP备2024094994号-29