A.1 安装与启动
桌面版
- 下载：chatgpt.com/codex
- 启动：双击 Codex App
- 登录：右上角 → Sign In → ChatGPT 账号
- 工作区：File → Open Folder
CLI
npm install -g @openai/codex
codex # 在当前目录启动
codex /path/to/project # 在指定目录启动
codex --version # 查版本
codex --help # 帮助
Web
chatgpt.com/codex → Sign In → 选 "Web Codex"
A.2 模型选择
/model # 看可选模型
/model GPT-5.4 # 切到 GPT-5.4（综合最强）
/model GPT-5.4 Fast # 速度优先
/model GPT-5.3-Codex # 编码优化（推荐写代码用）
/model thinking # 切到深度推理（高消耗）
| 任务 |
推荐 |
| 普通对话 |
GPT-5.4 |
| 大量代码 |
GPT-5.3-Codex |
| 复杂决策 |
GPT-5.4 thinking |
| 快速回答 |
GPT-5.4 Fast |
| 长文本理解 |
GPT-5.4（200K context） |
A.3 权限模式
/approvals # 看当前 / 切换
/approvals read-only # 只读
/approvals safe # 自动批准安全操作（推荐）
/approvals full-auto # 全自动（小心！）
| 模式 |
文件读 |
文件写 |
跑命令 |
网络 |
| read-only |
✓ |
✗ |
✗ |
✗ |
| safe |
✓ |
✓（工作区内） |
✓（白名单） |
部分 |
| full-auto |
✓ |
✓ |
✓ |
✓ |
A.4 常用 Slash 命令
/new # 开新会话（清空上下文）
/resume # 恢复上次会话
/save # 保存当前会话
/history # 看会话历史
/clear # 清屏（不清上下文）
/context # 看当前上下文用量
/memory # 管理 Memory
/memory add "X 偏好" # 添加 Memory
/memory list # 列出 Memory
/memory edit # 编辑 Memory
/skills # 看可用 Skills
/skills reload # 重新加载 Skills
/agents # 看 AGENTS.md 加载情况
/plan # 切 Plan Mode（先规划不动手）
/exit # 退出
/help # 帮助
A.5 提示词四要素法
[目标] 我要做什么
[上下文] 项目背景、相关文件、现有代码
[约束] 用什么 / 不用什么 / 风格规范
[完成标准] 怎么算做完
例：
[目标] 给登录表单加"忘记密码"链接
[上下文] React + TypeScript 项目，src/components/LoginForm.tsx
[约束] 用现有的设计 system，不要引入新 lib
[完成] 链接点击后跳转 /forgot-password 路由
A.6 提示词常用句式
帮我...
基于 [文件] 做...
按 [规范] 改...
不要 [禁忌]
完成后 [验收]
先看一下 [背景]，再开始
分步骤做：1) ... 2) ... 3) ...
跑一下 [命令]，看结果
解释一下 [概念] / [代码]
对比 A 和 B 的优缺点
找出 [文件] 里的问题
帮我 review 这段
A.7 防 AI 跑偏的句式
等一下，先让我看看
不要做 X，只做 Y
拆成 3 步，每步停下来确认
回到原始需求再想想
你刚才的逻辑哪一步错了
重新开始，不要受之前影响
A.8 让 AI 解释 / 验证
为什么用 X 而不是 Y？
你做的 X 有什么风险？
跑一下证明它真的工作
列出你刚才执行的所有命令
这段代码有没有 edge case？
有哪些你假设了但没说的前提？
A.9 文件操作
读取 path/to/file.txt
分析 ~/Desktop/data.csv
打开 ./logs/error.log
对比 v1.md 和 v2.md
搜索 src/ 里所有用了 useEffect 的地方
找出 ~/Documents/ 里所有 .pdf
列出 ./images/ 文件大小排序
统计 src/ 总行数
A.10 数据处理
# Excel
读 sales.xlsx Sheet1，按"区域"分组求和
# CSV
合并 jan.csv 和 feb.csv，去重保留最新
# JSON
解析 config.json，提取 endpoints 字段
# PDF
提取 paper.pdf 的全文，按章节存到 chapters/
# 图片
读 photo.jpg 描述内容
比较 before.png 和 after.png 差异
A.11 命令行工作
# 安全的命令一般直接跑：
ls / pwd / cd / cat / grep / find
# 写代码任务常用：
git status / diff / log / commit
npm install / run / test
python -m / pip install
docker ps / build / run
# 危险命令必须 ask：
rm -rf
git push --force
DROP / DELETE
sudo
A.12 Git 配合
让 Codex 做这些：
- "看一下 git status，告诉我有哪些改动"
- "git diff 最近的改动并给我总结"
- "帮我写本次 commit 的 message（用 conventional commits 格式）"
- "看 git log 最近 10 条，找出我修过的最频繁的文件"
- "对比 main 和当前分支，列出 PR 应该写的内容"
不让 Codex 做这些（你自己来）：
- git push --force
- git rebase -i（交互式）
- git reset --hard 到远程不存在的 commit
A.13 调试与排错
# 让 Codex 帮你
跑 [命令]，把报错贴给我看
看一下 [日志文件] 找异常
test 失败了，输出是 X，帮我 debug
我猜问题在 X 文件，你看下
加点 print，跑一下，看中间状态
# AI 卡住时
停下，让我看看
你的思路偏了，回到 [关键问题]
拆细，先做最小可验证的部分
A.14 项目结构推荐
my-project/
├── AGENTS.md # AI 指令
├── README.md # 给人看
├── .codex/
│ ├── skills/ # 项目专属 Skills
│ └── memory.md # 项目级 Memory
├── .gitignore # 包含 .codex/cache/
├── src/ # 源码
├── tests/ # 测试
├── docs/ # 文档
└── data/ # 数据（不入 git）
A.15 全局配置位置
| 平台 |
路径 |
| macOS / Linux |
~/.codex/ |
| Windows |
%USERPROFILE%\.codex\ |
.codex/ 目录里：
AGENTS.md - 全局指令memory.md - 全局记忆skills/ - 全局 Skillsautomations/ - 自动化任务config.yaml - 配置logs/ - 日志
A.16 网络与代理
# 设代理（macOS / Linux）
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
# Windows PowerShell
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"
# 永久（写 ~/.zshrc 或 ~/.bashrc）
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
source ~/.zshrc
A.17 配额与限流
| 订阅 |
Codex 配额（月） |
| Free |
极低（基本不能用） |
| Plus |
标准 |
| Pro |
5-10x Plus |
| Business |
公司级 |
| Enterprise |
协商 |
触发限流：
A.18 自动化触发器
# 时间
schedule: "0 9 * * *" # 每天 9:00
schedule: "0 9 * * 1" # 每周一 9:00
schedule: "0 9 1 * *" # 每月 1 号 9:00
# 事件
on_file_added: "~/Downloads/"
on_email_match: "subject contains '订单'"
on_github_pr: "opened"
on_cron: "every 30 minutes"
A.19 Skill 极简模板
---
name: 任务名
description: 一句话说明（决定何时调用）
keywords: [关键词 1, 关键词 2]
version: 1.0.0
---
## 何时使用
- 触发场景
## 输入
- 需要的信息
## 步骤
1. ...
2. ...
3. ...
## 输出
- 文件 / 格式 / 长度
## 验收
- 怎么算成功
完整模板见 附录 C。
A.20 AGENTS.md 极简模板
# 项目名
## Project Overview
[这是什么、谁用、为什么]
## Tech Stack
- 主要技术栈
## Project Structure
src/, tests/, docs/...
## Common Commands
- 跑：xxx
- 测：xxx
- 部署：xxx
## Conventions
- 命名规范
- 风格规范
## Boundaries
### Always
### Ask First
### Never
完整模板见 附录 B。
A.21 文字工作场景速查
| 场景 |
命令模板 |
| 写邮件 |
帮我写一封邮件给 X，主题 Y，要点 1/2/3，语气 Z |
| 周报 |
帮我写本周周报，调用 weekly-report Skill |
| 会议纪要 |
整理这份会议录音，生成纪要 |
| 翻译 |
把这段中译英，注意术语 X→Y |
| 改写 |
这段太长，砍到 100 字内 |
| 润色 |
这段改成口语化风格 |
| 摘要 |
这份 PDF 总结成 500 字 |
A.22 数据 / Excel 速查
| 场景 |
命令模板 |
| 清洗 |
读 sales.xlsx，统一区域、金额、日期格式 |
| 合并 |
合并 jan.csv 和 feb.csv，去重 |
| 拆分 |
按"地区"列拆分 data.xlsx 到多个文件 |
| 关联 |
用 customer_id 把 orders 和 customers 关联 |
| 透视 |
按"产品 + 月份"做透视表 |
| 图表 |
生成 4 个图：折线 / 柱状 / 饼 / 热力 |
| 分析 |
找出销售额 TOP 10 客户，按地区分布 |
A.23 编程任务速查
| 场景 |
命令模板 |
| 加功能 |
给 X 模块加 Y 功能，参考 PLAN.md |
| 修 bug |
测试报错 X，看 Y 文件帮我修 |
| 重构 |
把 X 文件拆成更小的模块 |
| 写测试 |
给 X 函数写单元测试 |
| Code review |
review 我的 PR，重点看安全 / 性能 |
| 文档 |
给 X 项目生成 README |
| 部署 |
把项目部署到 Netlify |
A.24 团队协作速查
| 场景 |
工具 |
| Skill 库共享 |
Git 仓库 + clone 到 ~/.codex/skills/team |
| AGENTS.md 标准化 |
项目根 + 团队模板 |
| PR review |
Codex GitHub Action |
| Issue 自动初筛 |
Codex GitHub App |
| 跨工具协作 |
都读 AGENTS.md（开放标准） |
A.25 紧急情况速查
| 情况 |
立即做 |
| AI 改坏了文件 |
git checkout -- 文件名 回退 |
| 误删文件 |
找废纸篓 / Time Machine |
| 误传敏感数据 |
立即删对话、改密码、通知合规 |
| API Key 泄露 |
platform.openai.com → Revoke |
| 账号被封 |
help.openai.com 申诉 |
| 拼配额 |
/model fast 切廉价模型 |
| 卡死 |
Ctrl+C 中断、/new 新开 |
A.26 一句话哲学
- 不知道用什么模型？GPT-5.4
- 不知道开什么权限？safe
- 不知道说啥？四要素：目标 / 上下文 / 约束 / 验收
- AI 一直在道歉？换种说法
- AI 跑偏了？/new 重开
- 不知道 Skill 怎么写？看 SKILL.md 模板
- 不知道 AGENTS.md 写啥？看附录 B
- 重要决策？永远 AI 出方案，人拍板
- 看不懂 AI 给的代码？让它"用人话解释一下"
- 想偷懒？写 Skill / Automation
- 想升级？看完整本书第二遍
永无岛