Codex 怎么用?从启动到完成第一个任务(2026 年 10 月版:Codex 0.165、GPT-6.1 Terra、中途改推理强度)

Codex 怎么用?这篇 Codex 使用教程已按 Codex CLI 0.165.0 更新:查版本并升级、用本站 API Key 选 GPT-6.1 Terra、对话中途改推理强度、memory v2 怎么开关,再到跑通第一个小任务、插话纠偏、看 diff 和回滚。新功能都在 0.165.0 上实测,附用时。

8 分钟阅读
Codex 怎么用?从启动到完成第一个任务(2026 年 10 月版:Codex 0.165、GPT-6.1 Terra、中途改推理强度)
2026-10-29 更新:按 Codex CLI 0.165.0 补充。模型列表加入 GPT-6.1 Terra;支持的模型默认可以在对话中途改推理强度;新 profile 默认用 memory v2;会话选择器可按仓库筛选;模型不存在时直接报错、不再重试。下面的入门流程沿用 0.163.0 的实测。

先说结论:Codex 怎么用,记住一个小闭环就够了:进对目录启动 → /status 确认模型和权限 → 给一个边界清楚的小任务 → 看 diff、跑测试 → 决定保留还是回滚。2026 年 10 月的版本里,最值得新手知道的变化是:Codex 干活时可以直接发新消息纠偏,不用等它做完。

我们用 Codex CLI 0.163.0 + gpt-6.1-sol 把下面每一步都跑了一遍:在回复第 3 秒插话改需求,Codex 直接按新要求改完并跑通测试,全程 49 秒;旁路问答 /side 一问一答 8 秒,不打断主任务。

速查表

想做什么命令或操作说明
看版本 / 升级codex --version / npm install -g @openai/codex@latest本文基于 0.163.0
确认模型、Provider、权限/status每次行为不对先看这里
改权限/permissions新手保持 Ask for approval
换模型和推理强度/model先选模型,再选强度
干活中途改需求直接输入新消息回车0.163.0 默认开启
搜索修改设置/config,按 / 搜索改动自动保存
查看和改快捷键/keymapLeader 键默认 Ctrl+X
不打断主任务问个问题/sideCtrl+/ 在主对话和旁路之间切换
复制某段输出/copy选中文字用 Ctrl+Insert
在独立 worktree 里干活/worktree 或 codex --worktree不影响主目录
回退到之前的消息空输入框按两次 Esc只回退对话,不回退代码

第一步:检查版本,必要时升级

bash
codex --version

本文按 0.165.0 更新(入门流程在 0.163.0 上实测)。版本低于 0.165.0,先升级:

bash
npm install -g @openai/codex@latest

还没装 Codex 的,先看 Codex 安装教程。

0.161.0 起,Codex 自带的模型列表默认用 GPT-6.1 Sol(gpt-6.1-sol)。另外,官方更新日志写明:从 2026 年 10 月 14 日起,用 ChatGPT 账号登录的 Codex 不能再用 GPT-5.5,用 API Key 认证的会话不受影响。如果你的 config.toml、profile、脚本或定时任务里还写着 gpt-5.5,建议一并改成 gpt-6.1-sol。

Codex 0.165 有什么新变化

据 OpenAI Codex 0.165.0 发布说明,和新手相关的是下面几条。我们在一台干净机器上用临时 HOME 装了 0.165.0 逐条试过。

查版本并升级到 0.165

plaintext
codex --version
npm install -g @openai/codex@0.165.0

实测 npm 安装用时约 5 秒,装完 codex --version 显示 codex-cli 0.165.0。

用本站 API Key 选 GPT-6.1 Terra

0.165.0 的模型列表加入了 GPT-6.1 Terra。我们用本站 API Key 实测,gpt-6.1-terra 正常返回。把配置里的模型改成:

plaintext
model = "gpt-6.1-terra"

或者只在某一次运行时指定:codex -m gpt-6.1-terra。实测 codex exec -m gpt-6.1-terra 回一句简短的话用时约 40 秒。Terra 的定位和更多测试见 GPT-6.1 Terra 在 Codex 里怎么用。

对话中途改推理强度

0.165.0 起,支持的模型默认可以在同一个对话里改推理强度,不用开新会话。在 TUI 里输入 /model,选同一个模型、换一档推理强度,后面的回复就按新档位走,之前的上下文还在。非交互模式可以这样接着上次的会话换档:

plaintext
codex exec -c model_reasoning_effort=low "让 calc.py 的 divide 在除数为 0 时返回 None"
codex exec -c model_reasoning_effort=high resume --last "再给 divide 加一行 docstring"

实测(gpt-6.1-sol):第一步 low 档改完用时约 66 秒,第二步在同一个会话里切到 high 档,日志显示 reasoning effort: high、会话 id 不变,加 docstring 用时约 87 秒。各档位怎么选、预设怎么用,见 Codex 0.164 推理强度预设。

memory v2:是什么、怎么开关

记忆功能会把过去会话里的要点存下来,之后的会话可以用上。0.165.0 起新 profile 默认用 memory v2 这一版存储。在我们的全新 HOME 里,codex features list 显示 memories 默认是关的,用下面的命令开关(实测约 0.1 秒,会写进 config.toml 的 [features]):

plaintext
codex features enable memories
codex features disable memories

据发布说明,memory v2 还支持导入其他 agent 的记忆;在 0.165.0 里对应开关 external_agent_memory_import 仍标为开发中,默认关闭,不急着用。项目规则还是写进 AGENTS.md 更稳。

会话选择器按仓库筛选

据发布说明,codex resume 打开的会话选择器加了按仓库筛选,用了多个 worktree 时更好找回同一个仓库的会话。

模型不存在时直接报错

0.165.0 遇到「模型不存在」不再重试,直接把服务端的错误信息显示出来。我们故意写了一个不存在的模型名,0.3 秒就退出并给出提示。看到这类报错,检查 model 拼写,再对照 config.toml 配置指南。

创建 API Key →

第二步:注册并创建 API Key

  1. 在 AICodeWith 注册并登录
  2. 左侧导航栏点「密钥管理」,右上方点「创建密钥」,起一个好认的名字
  3. 生成后立即复制保存,这个窗口关掉后就看不到完整的 Key 了

立即注册 AICodeWith →

创建 API Key →

第三步:写全局配置 ~/.codex/config.toml

打开 ~/.codex/config.toml(Windows 在 C:\Users\你的用户名\.codex\config.toml),写入:

toml
model_provider = "aicodewith"
model = "gpt-6.1-sol"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "sk-你的Key"

写在全局配置里,所有项目通用,不用每次打开终端再设置。每一项的含义见 Codex config.toml 配置指南,更完整的接入和验证步骤见 Codex 接入 AICodeWith 教程。其他认证方式的区别见 Codex API Key 怎么配置。

第四步:启动,确认模型、权限和认证

进入项目根目录再启动,Codex 会围绕当前目录读写文件:

bash
cd 你的项目目录
git status
codex

第一次在某个目录启动,会问你是否信任这个文件夹,确认是自己的项目再选 Trust and continue。

/status:确认模型和 Provider

进入后先输入 /status。我们实测看到的关键几行:

text
Model:               GPT-6.1-Sol (reasoning low)
Model provider:      aicodewith
Directory:           /你的项目目录
Permissions:         Workspace (Ask for approval)

Model provider 显示 aicodewith,说明配置生效了。

用 experimental_bearer_token 的话,在终端里运行 codex login status 会显示 Not logged in。我们实测这种配置下它就是这样显示的,但 Codex 照常能用。判断能不能用,以 /status 里的 Provider 和发一条消息能不能正常回复为准。

/permissions:先别放开太多

/permissions 有 4 档:

选项含义
Ask for approval(默认)能读写项目里的文件、运行命令;访问网络或改项目外的文件要你确认
Approve for me只有被判断为可能不安全的操作才问你
Full Access可以改项目外的文件、联网,都不再询问,慎用
Read Only只读,改文件或联网都要确认

新手保持默认的 Ask for approval。我们测试时发现,这一档下 .git 目录对 Codex 是只读的,它要建分支时会弹窗请你确认,这正是你需要看一眼的时候。

/model:选模型和推理强度

/model 先选模型,再选推理强度(Low、Medium、High、Extra high 等)。用 API Key 时列表里仍能看到 GPT-5.5,但新任务建议用 GPT-6.1 Sol。日常改代码用默认的 Low 就够快;跨很多文件的重构或难查的 bug 再调高。

第五步:做一个小任务,练习插话、/side 和 /copy

测试仓库里有一个 calc.py,divide(a, b) 没处理除数为 0。

中途插话纠偏

先发:

text
给 calc.py 的 divide 加上除数为 0 的处理:抛出 ValueError,提示信息写「除数不能为 0」,并在 test_calc.py 里补测试,最后运行 python3 -m unittest。

Codex 开始干活后,第 3 秒我们改主意了,直接在输入框里发:

text
改一下:除数为 0 时不要抛异常,改成返回 None,测试也按这个改。

codex-steer-mid-reply

界面提示这条消息会在下一次工具调用后送达;想让它立刻生效,按 Esc 打断并立即发送。实测 Codex 读到后直接按新要求改,没有先写一版 ValueError 再回头改,3 个测试全过,整轮 49 秒。

官方更新日志说明,0.163.0 起回复过程中发新消息即可纠偏,默认开启,不用额外配置。

/side:不打断主任务问个问题

想问点相关但不想写进主对话的问题,输入 /side 打开旁路对话。我们问「返回 None 和抛 ValueError 各有什么优缺点」,8 秒给出两句对比,没有改任何文件。

  • Ctrl+/ 在主对话和旁路对话之间切换
  • 切回主对话后再输入 /side,会回到刚才那个旁路对话,之前的问答还在(0.163.0 修好的行为)
  • 旁路里的问答不会出现在主对话里

/copy:复制某一段输出

输入 /copy 后,用 ↑ ↓ 选择要复制的内容块,比如「整条回复」或「你发的消息」,回车即可,界面提示复制了多少字符。想复制屏幕上选中的一段文字,用 Ctrl+Insert。

/config 和 /keymap:改设置和快捷键

  • /config 按类别分页(外观、通知、输入、会话、文本选择),按 / 可以直接搜索,比如搜 vim 就能找到「Start in Vim mode」。改动自动保存,官方说明大多数设置立即生效,需要重启的会单独标出
  • /keymap 列出所有可配置的快捷键,能搜索和重新绑定。Leader 键默认是 Ctrl+X,复制是 Ctrl+O,切换旁路对话是 Ctrl+/,语音静音改到了 F9

/worktree:在独立目录里试另一个方案

0.162.0 起支持受 Codex 管理的 git worktree。输入 /worktree 可以选择把当前对话带到新 worktree、在新 worktree 开新对话,或浏览已有的 worktree。命令行里也可以直接:

bash
codex --worktree

我们用 codex exec --worktree 跑了一次,20 秒,Codex 在 ~/.codex/worktrees/ 下建了一个独立的检出目录,主目录不受影响;之后在 /worktree 的「Browse worktrees」里能看到它。这个功能需要 worktrees 特性开启,可以用 codex features list 查看,我们的 0.163.0 默认就是开的。

0.161.0 起还能在会话里用 /mcp login <名字> 登录需要授权的 MCP 服务器,不用退出终端。

第六步:看 diff、跑测试,决定保留还是回滚

任务说「完成」不等于结果正确。先看改了什么:

bash
git diff --stat
git diff

再跑项目自己的测试,我们这里是:

bash
python3 -m unittest

满意就提交一个检查点:

bash
git add -A
git commit -m "divide: 除数为 0 返回 None"

不满意,只撤回这次改的文件,不要一上来就重置整个工作区:

bash
git restore calc.py test_calc.py
在 Codex 桌面版里可以编辑之前发过的消息;CLI 里空输入框按两次 Esc 可以回退到之前的消息再改。但 CLI 回退只回退对话,不回退代码,已经改过的文件要用 git 处理。详见 Codex 怎么编辑之前的消息。

常见问题

第一次用 Codex 该让它做什么?

先给一个只读或很小的任务,比如「介绍一下这个项目的结构」或「检查 README 里的启动命令和 package.json 是否一致,先不要改」。确认它读对了地方,再让它改代码。好的任务写清四件事:目标、范围、约束、怎么验证。

插话和按 Esc 打断有什么区别?

直接发新消息,Codex 会在下一次工具调用后读到并调整,已经在做的那一步会先做完。按 Esc 是立刻打断当前这一轮,再发你的新消息。改的是小细节就直接发,方向完全错了就按 Esc。

报错 401、429、503 怎么办?

额度和用量怎么看?

用量怎么算、为什么掉得快,见 Codex 用量说明。

怎么让 Codex 记住项目规则?

在 Codex 里运行 /init,生成 AGENTS.md,把项目命令、代码约定和验证方式写进去,之后每个新会话都会读取。

可以接着上次的会话继续吗?

可以,运行 codex resume 打开会话列表,选一个继续。

能让 Claude Code 和 Codex 一起干活吗?

可以,比如让一边写计划、另一边评审,见 Claude Code 和 Codex 怎么一起用。

创建 API Key →

立即注册,开始用 Codex 写代码 →

资料来源

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。