AI 编程手册

从“工具能对话”走到“任务可验证交付”。这里按真实入口整理 Codex 与 Claude Code 的项目操作、权限、diff、测试、并行工作、团队定制和故障处理。

SuperToken 中文整理版 · 核对日期 2026-07-14 · Codex CLI 0.144.3 · Claude Code CLI 2.1.209

本版重点

内容优先于页面装饰。每条核心流程都尽量回答：从哪里开始、做什么、正常看到什么、怎样证明完成、失败时查哪里，以及哪些权限不能默认放开。

OpenAICodex 中文深度手册

桌面 App、CLI、IDE、Cloud、Worktree、Review、MCP、Skills、Plugins 与 Hooks。

从入口选择开始 →AnthropicClaude Code 中文深度手册

CLI、IDE、后台代理、Worktree、Remote Control、MCP、Agents、Hooks 与 Plugins。

从入口选择开始 →

你应该先看哪一页

当前情况	先看
工具还没连上 SuperToken	工具部署与配置
第一次用 Codex，不知道选 App 还是 CLI	Codex 入口与 10 分钟快速开始
想在 Codex App 中看 diff、终端和 Worktree	Codex 桌面 App
第一次用 Claude Code	Claude Code 入口与 10 分钟快速开始
想使用 Claude Code IDE、后台或远程入口	Claude Code IDE 与远程入口
已经会基本命令，想把流程做稳定	Codex 项目实战 或 Claude Code 项目实战
遇到认证、权限、目录、MCP 或网关错误	Codex 排错 或 Claude Code 排错

Codex 学习路径

1. 入口与快速开始：选择 App、CLI、IDE 或 Cloud，完成第一次验证。
2. 桌面 App：Local、Worktree、Review、终端、Handoff、Scheduled 和 Appshots。
3. CLI 使用：sandbox、approval、图片、会话、exec 和 review。
4. IDE 与 Cloud：编辑器上下文、共享设置和远程环境差异。
5. 项目与团队定制：AGENTS.md、配置、Rules、MCP、Skills、Plugins 和 Hooks。
6. 项目实战：陌生仓库、Bug、功能、重构、测试、审查和自动化。
7. 故障排除与速查：按症状定位安装、配置、权限、网络、MCP、Worktree 和 Cloud。

Claude Code 学习路径

1. 入口与快速开始：以当前 CLI 能力为证据，完成第一次验证。
2. CLI 使用：信任、权限模式、上下文、会话、JSON 和安全自动化。
3. IDE 与远程入口：IDE、Background、Worktree/tmux、Remote Control、Chrome 和 Ultrareview。
4. 项目与团队定制：CLAUDE.md、settings、MCP、Skills、Agents、Hooks 和 Plugins。
5. 项目实战：从探索和计划走到验证与交付。
6. 故障排除与速查：doctor、safe mode、认证、权限、MCP、IDE 和 SuperToken 网关。

PDF 一键下载

PDFCodex 中文手册App、CLI、IDE、定制、实战与排错PDFClaude Code 中文手册CLI、IDE、远程、定制、实战与排错PDFSuperToken 工具配置手册安装、接入、验证与配置排错

PDF 由同一套 Markdown 正文生成，不维护另一份容易过期的内容。网页适合搜索、放大图片和追踪链接；PDF 适合离线、归档和团队分发。

Codex 还是 Claude Code

对比项	Codex	Claude Code
当前实测 CLI	0.144.3	2.1.209
核心本地入口	App、CLI、IDE	CLI、IDE 连接
项目长期说明	AGENTS.md	CLAUDE.md
用户配置	~/.codex/config.toml	~/.claude/settings.json
项目配置	.codex/config.toml	.claude/settings.json
非交互执行	codex exec	claude -p
继续/分叉	resume / fork	-c / -r / --fork-session
本地并行	App Worktree、任务	Background agents、Worktree/tmux
审查	App Review、/review、codex review	会话审查、Ultrareview
定制	Rules、MCP、Skills、Plugins、Hooks	permissions、MCP、Skills、Agents、Hooks、Plugins

没有脱离项目的“绝对更强”。同一个真实小任务分别试用，比较改动准确性、验证完整度、人工审查成本、权限清晰度和消耗，比比较一轮回答更可靠。

通用任务模板

目标：
为订单列表增加按状态筛选，并把筛选条件同步到 URL。

上下文：
入口在 src/pages/orders，现有筛选组件在 src/components/filters。
先阅读同目录实现、调用方和测试。

边界：
不要更换状态管理库；不要修改服务端接口；保留移动端布局。

完成标准：
1. 支持 pending、paid、cancelled；
2. 刷新后筛选状态不丢失；
3. 覆盖成功、空数据和错误状态；
4. 运行 lint、类型检查和相关测试；
5. 审查完整 diff；
6. 最后说明改动、验证证据、未验证项和剩余风险。

五条不变的原则

1. 先建立事实，再修改。 先找入口、相似实现、测试和现有约束。
2. 复杂任务先计划。 计划要暴露歧义、权限、数据和验证风险。
3. 一次一个可验收目标。 不把修复、重构、升级和新功能混在一起。
4. 完成必须有证据。 Git diff、测试结果和真实界面状态比最终回答重要。
5. 权限按需开放。 密钥、生产环境、删除、推送、发布和付款保持人工控制。

来源与截图规则

• Codex 产品事实优先使用 2026-07-14 获取的 OpenAI 当前官方手册。
• Claude Code 本版优先使用本机官方 CLI 2.1.209；Anthropic 官方站恢复后再升级按钮级内容。
• 官方图、本机实拍、SuperToken 控制台图和自制示意图必须使用不同来源标签。
• AI 生成界面不能标成官方截图。
• 图片进入 PDF 前必须记录产品、版本、来源、日期、Alt 和脱敏状态。
• 快速变化的命令以本机 --help 和当前账号界面为准。

主要资料

• OpenAI Codex documentation
• OpenAI Codex manual
• Claude Code documentation
• Claude Code CLI reference