外观
附录 资源汇总
约 2643 字大约 9 分钟
2026-06-09
忘了命令或者配置的时候翻一翻就行。
A.1 Codex 学习路线图
先学什么、后学什么？一张图看明白整个学习路径：
A.2 官方资源
| 去哪儿 | 链接 | 啥用处 |
|---|---|---|
| Codex 官方文档 | https://developers.openai.com/codex | 最权威的使用指南 |
| Codex 更新日志 | https://developers.openai.com/codex/changelog | 看看最近又加了啥新功能 |
| Codex GitHub 仓库 | https://github.com/openai/codex | 源码、提 Issue、看讨论 |
| OpenAI 官网 | https://openai.com | 注册账号、管理订阅 |
| OpenAI API 控制台 | https://platform.openai.com | 管理 API Key、看用量 |
| AGENTS.md 官方指南 | https://developers.openai.com/codex/guides/agents-md | 项目指令文件怎么写 |
| MCP 协议文档 | https://modelcontextprotocol.io | MCP 规范和服务器列表 |
| Codex CLI 命令参考 | https://developers.openai.com/codex/cli/reference | 所有命令行参数大全 |
A.3 社区资源
| 去哪儿 | 啥用处 |
|---|---|
| OpenAI 社区论坛 | Codex 用户讨论、分享经验和技巧 |
| Codex GitHub Discussions | 在仓库里跟大家交流问题 |
| r/ChatGPT (Reddit) | 里面有不少 Codex 使用心得 |
| OpenAI 官方博客 | https://openai.com/blog |
A.4 Codex CLI 命令速查表
安装和启动
# 安装 Codex CLI
npm i -g @openai/codex
# 基本启动（交互式对话）
codex
# 带任务启动
codex "你的任务描述"
# 指定模型
codex -m gpt-5.3-codex-spark
# 非交互模式（适合脚本和自动化）
codex exec "你的任务"
# 恢复上次对话
codex --resume
# 指定工作目录
codex -C ./my-project
# 全自动模式（慎用！不问你直接干）
codex --full-auto "你的任务"启动参数一览
| 参数 | 缩写 | 干啥的 | 举个例子 |
|---|---|---|---|
--model | -m | 指定模型 | codex -m gpt-5.3-codex-spark |
--sandbox | -s | 设置沙箱模式 | codex -s workspace-write |
--ask-for-approval | -a | 控制审批策略 | codex -a on-request |
--full-auto | — | 全自动模式 | codex --full-auto "任务" |
--cd | -C | 指定工作目录 | codex -C ./my-project |
--image | -i | 传入图片 | codex -i screenshot.png "分析这个" |
--search | — | 联网搜索 | codex --search "查询最新API" |
--profile | -p | 使用配置档案 | codex -p ci |
--config | -c | 临时覆盖配置 | codex -c model=gpt-5.4 |
--add-dir | — | 额外授权目录 | codex --add-dir ../shared |
--json | — | JSON 格式输出 | codex exec --json "任务" |
--output-last-message | — | 只输出最后一条 | 配合 --json 使用 |
MCP 配置
# 添加 MCP 服务器（在 ~/.codex/config.toml 里配置）
# 也可以手动编辑配置文件
# 查看当前配置
codex --helpA.5 对话内斜杠命令速查表
会话管理
| 命令 | 干啥的 | 啥时候用 |
|---|---|---|
/new | 开一个新对话 | 想重新开始的时候 |
/resume | 恢复之前的对话 | 想接着上次聊 |
/fork | 把当前对话克隆一份 | 想试试不同方向但不丢了原来的 |
/compact | 压缩对话历史 | 聊太久它有点"记不清"了 |
/side | 临时岔开聊一句 | 想问个相关问题但不想影响主线 |
/quit 或 /exit | 退出 Codex | 干完活了 |
设置调整
| 命令 | 干啥的 | 啥时候用 |
|---|---|---|
/model | 切换模型 | 想换个更强或更快的模型 |
/fast | 快速模式 | 简单任务想快出结果 |
/personality | 调整风格 | 想让它说话方式变一变 |
/permissions | 管理权限 | 想调整它能做哪些操作 |
/approve | 重新批准被拒的操作 | 自动审查拒绝了你又想让它干 |
/status | 看当前状态 | 想知道用的啥模型、花了多少 Token |
工具和扩展
| 命令 | 干啥的 | 啥时候用 |
|---|---|---|
/init | 生成 AGENTS.md 模板 | 新项目刚开始时用 |
/memories | 管理记忆功能 | 想开关记忆生成 |
/skills | 查看和使用技能 | 想提升特定任务的效果 |
/hooks | 查看生命周期钩子 | 想了解当前挂了哪些钩子 |
/copy | 复制最新回复 | 想把它的回答粘贴到别处 |
/feedback | 反馈问题 | 遇到 Bug 想报告给官方 |
A.6 键盘快捷键速查表
终端里用 Codex
| 快捷键 | 干啥的 |
|---|---|
Enter | 发送消息 |
Shift + Enter | 换行但不发送（写多行需求时用） |
Ctrl + C | 中断当前操作 |
Escape | 取消/中断 |
Ctrl + K | 清除当前输入行 |
↑ / ↓ | 浏览历史输入 |
Tab | 自动补全 |
Ctrl + D | 退出 Codex |
VS Code 里用 Codex
| 快捷键 | 干啥的 |
|---|---|
Cmd+Shift+P → 输入 "Codex" | 打开 Codex 面板 |
Escape | 关闭面板 |
A.7 AGENTS.md 常用模板
说白了，AGENTS.md 就是给 Codex 写的"入职手册"，告诉它你的项目是啥、规矩是啥。下面几个模板你直接改改就能用。
基础模板（啥项目都能用）
# 项目简介
这是一个 [用一句话描述你的项目]
# 技术栈
- 语言：[Python / JavaScript / TypeScript / Java 等]
- 框架：[框架名称和版本]
- 数据库：[用了啥数据库]
- 测试：[测试框架]
# 项目结构
- src/ — 主要代码
- config/ — 配置文件
- tests/ — 测试用例
# 编码规范
- 代码注释用中文
- 变量命名用英文驼峰式
- 提交信息用中文写
# 常用命令
- 启动：npm run dev
- 测试：npm test
- 构建：npm run build
# 特别注意
- 不要动 config/ 目录下的文件
- 改完代码要跑一遍测试前端项目模板
# 项目简介
Vue 3 个人博客网站
# 技术栈
- Vue 3 + TypeScript
- Vite 打包
- Tailwind CSS 样式
# 编码规范
- 组件命名用 PascalCase
- 样式优先用 Tailwind 类名
- 代码注释用中文
# 常用命令
- 开发：pnpm dev
- 构建：pnpm build
- 预览：pnpm preview
# 硬性规则
- 不要安装新的 UI 框架
- 不要修改 .env 文件
- 提交前确保 pnpm build 能通过写作/笔记项目模板
# 项目简介
Obsidian 知识库，用来管理个人笔记和学习资料
# 文件组织
- 工作会议记录放在 work-meetings/ 目录
- 学习笔记放在 notes/ 目录
- 每个笔记文件开头加创建日期
# 格式要求
- 使用 Markdown 格式
- 标题层级不超过三级
- 重要内容用粗体标记
# 特别注意
- 不要删除任何已有文件
- 创建新文件前先检查是否已存在类似文件
- 文件名用中文，不加特殊字符A.8 沙箱模式速查表
| 模式名 | 啥意思 | 啥时候用 |
|---|---|---|
workspace-write | 只能在项目目录里读写 | 大部分日常使用 |
network-read | 能联网读取但不能写 | 需要查资料但不让它改东西 |
danger-full-access | 完全访问，啥都能干 | 你非常清楚自己在干嘛的时候 |
安全提醒
danger-full-access 不是闹着玩的，相当于把电脑钥匙全给了它。除非你非常确定，否则别用这个模式。
A.9 常见问题 FAQ
Q1: Codex CLI 和 Claude Code 有啥区别？
你想想，它俩都是终端里的 AI 编程助手，但"娘家"不一样：
- Codex CLI 是 OpenAI 家的，用 GPT 系列模型
- Claude Code 是 Anthropic 家的，用 Claude 系列模型
各有各的强项。Codex 在终端操作上更快、更省 Token；Claude Code 在复杂推理上更强。说白了就是两把不同的扳手，看你喜欢用哪把。
Q2: 免费账号能用 Codex 吗？
能用。有 ChatGPT 账号就能用 Codex CLI，但免费账号的用量有限。如果你经常用，建议升级到 Plus 或 Pro 套餐，体验会好很多。
Q3: AGENTS.md 文件放哪儿？
- 全局的：放在
~/.codex/AGENTS.md，所有项目都会读到 - 项目级的：放在项目根目录的
AGENTS.md，只有这个项目生效 - 覆盖用的：放在
AGENTS.override.md，优先级最高
你可以理解为：全局的是"公司通用规定"，项目级的是"部门特殊规定"，覆盖用的是"今天临时加的规矩"。
Q4: 沙箱是啥？一定要开吗？
沙箱就像给 Codex 划了一个"活动区域"，它只能在这个区域里干活，不能跑到外面去搞破坏。建议日常使用都开着，特别是你不熟悉的项目。
Q5: Codex 能读懂中文吗？
当然能！你完全可以跟它用中文交流，它理解得很好。AGENTS.md 也可以用中文写。
Q6: 装完输入 codex 提示找不到命令咋办？
大概率是安装路径没被识别到。试试这几步：
# 看看 npm 把东西装到哪里了
npm config get prefix
# 然后把这个路径/bin 添加到 PATH 环境变量里Q7: 它一直让我确认，有点烦咋整？
刚开始用建议让它每次都问，安全第一。等你熟悉了，可以用 /permissions 命令调整权限，或者在启动时加 --ask-for-approval never 参数。不过说实话，让它多问问总比它搞坏了东西强。
Q8: 怎么让 Codex 记住我的偏好？
两种方式：
- 在
~/.codex/AGENTS.md里写上你的通用偏好（比如"代码注释用中文"） - 在项目的
AGENTS.md里写项目相关的偏好
这样它每次开始干活都会先读一遍，省得你每次都说。
A.10 课程文件索引
| 章节 | 文件名 | 聊啥的 |
|---|---|---|
| 第0章 | 00-写在前面.md | 聊聊 Codex 是什么、能干啥 |
| 第1章 | 01-认识Codex.md | Codex 全貌和同类工具对比 |
| 第2章 | 02-安装与配置.md | 手把手装到电脑上 |
| 第3章 | 03-核心概念.md | 它是怎么工作的 |
| 第4章 | 04-常用操作.md | 日常够用的操作大全 |
| 第5章 | 05-AGENTS配置.md | 让它记住你的规矩 |
| 第6章 | 06-权限与沙箱.md | 安全地让它干活 |
| 第7章 | 07-扩展能力.md | 给它接上更多工具 |
| 第8章 | 08-IDE集成.md | 在编辑器里直接用 |
| 第9章 | 09-自动化工作流.md | 把重复的事自动化 |
| 第10章 | 10-实战案例.md | 手把手带你做项目 |
| 第11章 | 11-进阶技巧.md | 高手的用法和踩坑经验 |
| 附录 | 附录-资源汇总.md | 就是你正在看的这页 |
这一页的东西不用背，用的时候翻一翻就行。学习嘛，知道去哪找答案比记住答案本身更重要。