AI Coding Assistant on 纪伟的个人博客

Codex 使用指南

Tue, 03 Mar 2026 10:00:00 +0800

Codex 是一个运行在终端里的 AI 工程代理——能读取项目、执行命令、修改文件，围绕一个目标完成一段完整的工程工作流。刚接触时容易把它当成“另一个 Claude Code CLI”，但用一段时间会发现：两者更像是两套不同的工程工作台，而不只是换了一个模型。

本文整理 Codex 的核心概念、常用命令和推荐工作方式，并标注它和 Claude Code 的关键差异。

一、Codex 适合做什么

Codex 的核心定位是工程代理。它不只是输出代码片段，而是可以围绕一个目标完成一段完整的工程工作流：

理解陌生项目；
找到相关代码和配置；
修改实现；
运行构建、测试或检查；
根据失败结果继续修复；
查看最终差异并汇报风险。

因此，下面两种提问方式的效果通常不同：

1

打开 A 文件，搜索 B，然后修改 C。

1
2


修复登录超时后没有回到原页面的问题。
保持现有接口兼容，补充回归测试，并说明验证结果。

第一种是在描述操作步骤，第二种是在描述工程目标。第二种方式给 Codex 留出了定位根因和选择实现方案的空间，也更容易在项目结构变化后继续工作。

二、一次任务的推荐流程

一个稳定的 Codex 任务通常可以分为五个阶段：

1. 先说目标和边界

明确希望改变什么，同时说明哪些东西不能改变：

1
2
3
4


给这个 Hugo 博客增加文章更新时间。
只通过项目级 layouts 覆盖主题，不直接修改 themes/stack。
没有 lastmod 的文章不要显示更新时间。
完成后执行生产构建并检查生成结果。

2. 让它先检查现状

对于陌生项目，先使用只读请求：

1
2


理解这个项目，说明架构、启动方式、关键配置和部署链路。
只做分析，不修改文件。

这样可以先发现项目约定、已有未提交修改和环境限制，避免一开始就进入错误目录或覆盖现有工作。

3. 让它实施最小修改

实现阶段应该明确兼容性和范围：

1
2


实现这个功能，不改变公开接口，不增加运行时依赖。
修改范围保持最小，并保留当前工作区已有的修改。

4. 要求验证

“文件已经修改”不等于“功能已经完成”。应该明确要求运行相关测试、构建或静态检查：

1
2


修改后运行最相关的测试；如果失败，继续定位原因并修复。
最后查看 diff，说明哪些检查成功、哪些检查因环境限制没有执行。

5. 查看最终差异

交付前至少检查：

是否只改了任务相关文件；
是否误改了配置、日期或公开接口；
是否留下生成文件；
测试和构建是否真的执行过；
是否有未解决的环境限制。

三、Codex CLI 常用命令

先查看当前安装版本和完整帮助：

1
2
3


codex --version
codex --help
codex <子命令> --help

Windows PowerShell 如果因为执行策略阻止 codex.ps1，可以使用对应的命令文件：

1
2


codex.cmd --version
codex.cmd --help

启动和恢复会话

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


codex 启动交互式 CLI
codex "理解这个项目" 带初始任务启动
codex -C <目录> 指定工作目录
codex -m <模型> 临时指定模型
codex -i <图片> 附加图片输入
codex --search 启用实时 Web 搜索
codex resume 从列表恢复历史会话
codex resume --last 恢复最近一次会话
codex resume <名称|ID> 按会话名称或 UUID 直接恢复（见第九节）
codex fork --last 从最近会话创建分支
codex archive <名称|ID> 归档会话（从选择器隐藏，不删除）
codex unarchive <名称|ID> 恢复已归档的会话
codex delete <名称|ID> 永久删除会话

非交互任务和审查

1
2
3
4
5


codex exec "<任务>" 非交互执行，适合脚本或 CI
codex review 执行代码审查
codex apply 应用云端任务产生的最新 diff
codex doctor 检查安装、配置、认证和运行环境
codex update 更新 CLI

配置和扩展

1
2
3
4
5
6


codex login 登录
codex logout 清除本地认证
codex mcp 管理 MCP 服务器
codex plugin 管理插件
codex completion 生成 shell 自动补全
codex features 查看功能开关

常用启动参数

1
2
3
4
5
6
7
8


-C, --cd <目录> 设置工作目录
-m, --model <模型> 选择模型
-i, --image <文件> 附加图片
-s, --sandbox <模式> read-only / workspace-write / danger-full-access
-a, --ask-for-approval <策略> untrusted / on-request / never
--add-dir <目录> 增加可写目录
-c key=value 临时覆盖 config.toml
--no-alt-screen 保留终端滚动历史

--dangerously-bypass-approvals-and-sandbox 会绕过授权和沙箱。普通开发机不应该使用它；只有在外部环境已经完成隔离的自动化任务中，才有理由考虑这个选项。

四、交互中的斜杠命令

在 Codex 输入框中输入 /，可以打开当前版本支持的命令菜单。命令会随 CLI 版本、模型和启用的功能变化，所以菜单是最可靠的参考。

最常用的命令包括：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


/status 查看会话 ID、上下文占用和限额
/model 切换模型（并调整推理强度）
/permissions 调整当前会话权限
/compact 压缩长会话上下文
/review 审查未提交修改或比较基准分支
/init 生成 AGENTS.md 脚手架
/plan 切换计划模式
/mcp 查看 MCP 连接状态
/apps 浏览连接器
/plugins 浏览插件
/ps 查看后台终端任务
/agent 查看或切换子代理线程
/fork 从当前对话创建分支
/resume 从会话选择器恢复历史会话
/rename [名称] 重命名当前会话；不带名称时弹出输入框并给出基于对话的建议
/new [名称] 开始新会话，可顺便命名（/clear 同样支持带名称）
/clear [名称] 清空界面并开始新会话，可顺便命名
/archive 归档当前会话并退出 CLI
/delete 永久删除当前会话及其派生会话，然后退出 CLI
/feedback 提交反馈
/exit 退出 CLI

/compact 和 Claude Code 中的同名命令概念接近：在长会话中压缩上下文并保留关键摘要。使用它之前，最好确认重要的约束已经写入 AGENTS.md，或者在后续请求中重新强调。

此外还有 /fast、/personality、/hooks、/vim、/keymap、/goal、/cloud、/local 等命令；具体可用项以 / 菜单为准，未显示即表示当前版本或配置不支持。

五、值得记住的快捷键

Enter 和 Tab 的区别

这是 Codex 与普通命令行交互很不一样的地方：

Enter：发送当前输入；Codex 工作时可以向当前轮次注入新指令；
Tab：Codex 工作时把输入排队到下一轮；
Esc 两次：在输入框为空时，编辑上一条用户消息，并从那里创建分支；
Ctrl+C：中断或退出当前会话；
↑ / ↓：浏览输入历史或菜单项目；
Page Up / Page Down：在较长界面中翻页。

简单来说：发现当前方向马上错了，用 Enter 纠正；想让它做完当前步骤后再处理另一件事，用 Tab 排队；想保留现有路线并尝试另一种方案，用双击 Esc 分叉。

如果当前版本支持 /keymap，可以检查和修改 TUI 快捷键；支持 /vim 时，可以把输入框切换为 Vim 编辑模式。

六、`AGENTS.md` 是 Codex 的项目说明书

Claude Code 常用 CLAUDE.md，Codex 使用 AGENTS.md 作为项目级持久说明。它适合保存每次工作都应该遵守的内容：

项目架构和关键目录；
构建、测试和格式化命令；
编码规范；
不应该直接修改的区域；
验证要求；
部署和 Git 约定。

例如，一个 Hugo 项目的 AGENTS.md 可以写成：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# AGENTS.md

## Commands

- 本地预览：hugo server --buildFuture
- 生产构建：hugo --minify --buildFuture
- 初始化主题：git submodule update --init --recursive

## Conventions

- 新文章使用 Page Bundle。
- 不直接修改 themes/stack。
- 修改后必须执行生产构建。
- 未经明确要求，不改变文章发布日期。

一次性的要求不要写进 AGENTS.md。例如“这次只修改一个文件”属于当前任务的约束，直接在对话中说明即可。

七、先理解权限模型：边界、沙箱与审批

Codex 能否执行一条命令，不是由单独一个“权限开关”决定的。至少要分清三层：

1
2
3
4
5


操作系统与运行环境 进程本身能访问什么
 ↓
Codex 沙箱 命令允许读写哪些路径、是否允许网络访问
 ↓
审批策略 哪些操作可以直接执行，哪些必须先征得用户同意

操作系统权限是最外层边界。例如，当前用户本来就无权访问某个目录，调整 Codex 的会话模式也不会凭空获得管理员权限。

1. 权限配置文件决定“能做什么”

新版 Codex CLI 正在引入 Beta 权限配置文件（permission profiles）。一个配置文件可以同时规定文件系统的 read、write、deny 规则，以及命令能够访问哪些网络域名。内置配置文件有三个：

权限配置文件	文件访问能力	典型用途
`:read-only`	本地命令只读	阅读代码、架构分析、代码审查
`:workspace`	可写当前工作区根目录和系统临时目录	日常开发
`:danger-full-access`	移除本地沙箱限制	已有外部强隔离的专用环境

这里的冒号是名称的一部分。:workspace 不代表工作区内所有位置都必然可写，例如它默认仍会保护工作区中的 .git、.codex 等敏感目录。组织管理员还可以限制用户能够选择哪些配置文件。

“工作区”通常是启动 Codex 时指定的目录。可以用 -C 改变工作目录，也可以用 --add-dir 增加某个明确的可写目录：

1

codex -C C:\Projects\MyApp --add-dir C:\Projects\Shared

不要为了访问一个子目录就把整个磁盘加入可写范围。网络、.git 目录及其他敏感位置也可能受到配置文件或运行环境的额外限制，具体以会话状态和审批提示为准。

2. 新旧两套配置不要混用

权限配置文件是新版机制，旧版 CLI 使用 sandbox_mode、sandbox_workspace_write 以及 --sandbox。两套机制不能叠加：

使用新版时，在 config.toml 中设置 default_permissions 和 [permissions.<name>]；
使用旧版兼容方式时，使用 sandbox_mode 或命令行参数 --sandbox；
只要加载的配置中出现 sandbox_mode、启动时传入 --sandbox，或所选 profile 设置了 sandbox_mode，Codex 就会采用旧版沙箱设置，而不是 default_permissions。

因此，看到 :workspace 和 workspace-write 时不要认为它们是两个可以组合的选项：前者是新版内置 permission profile，后者是旧版 --sandbox 的取值。

3. 审批策略决定“何时问你”

审批策略不扩大沙箱边界，它只决定命令在什么情况下需要用户确认：

策略	行为
`untrusted`	只有被判定为可信的低风险命令直接运行，其他命令请求批准
`on-request`	由 Codex 判断何时需要申请额外权限，适合交互式开发
`never`	不弹出审批；命令若被沙箱拦截，失败结果直接返回给 Codex

这里最容易误解的是 never：它表示“永不询问”，并不表示“拥有全部权限”。在旧版兼容配置中，workspace-write + never 仍受工作区沙箱约束，只是越界时不会弹窗申请放行。

4. 看懂一次授权请求

命令需要越过当前边界时，Codex 会展示待执行命令及申请理由。确认前至少检查：

命令准备访问或修改哪个路径；
是否包含安装依赖、联网、删除、提交或推送等副作用；
批准仅适用于这一次操作，还是会记住某类命令前缀；
实际目标是否仍在当前任务范围内。

授予执行权限不等于授权所有业务动作。例如允许调用 git，不等于允许任意提交、改写历史或推送；这类规则仍应写进 AGENTS.md，由 Codex 在执行前单独确认。

权限问题和实现问题也要分开判断：命令被沙箱拦截，不代表代码有错；命令成功执行，也不代表构建、测试和结果检查已经完成。

八、查看、切换与配置权限模式

当前会话的实际权限来自所选 permission profile（或旧版 sandbox）及审批策略。/permissions 显示的是面向用户的 Model Permissions 预设，不应该与 --sandbox 的底层取值混为一谈。

1. 查看当前模式

在交互会话中输入：

1

/status

它会显示当前会话信息。查看其中的 permissions、sandbox 和 approval 相关字段，确认生效的是新版 permission profile 还是旧版 sandbox，以及当前审批策略。不要只根据启动参数推断，因为配置文件、命令行覆盖项和组织策略都可能改变最终结果。

输入 /permissions 会打开权限选择界面，当前选中的配置也能帮助确认会话模式：

1

/permissions

两者的用途不同：/status 适合只查看，/permissions 用于查看并切换。当前没有通用的固定快捷键可以一键轮换权限模式；最快的稳定入口仍是 /permissions，具体按键绑定可以查看 /keymap（如果当前版本提供该命令）。

2. `/permissions` 到底有哪些选项

在 Codex CLI 0.147.0 中，执行 /permissions 会打开 Update Model Permissions，默认提供四个预设：

选项	实际行为	适合场景
`Read Only`	可以读取当前工作区；修改文件或访问互联网前需要批准	阅读代码、代码审查、排查问题
`Ask for approval`	可以读取和修改当前工作区并执行命令；访问互联网或修改工作区外文件前需要批准	普通本地开发，稳妥的默认选择
`Approve for me`	由自动安全审查判断操作风险，只对检测为可能不安全的操作询问	希望减少弹窗、又不想完全放开权限的开发任务
`Full Access`	无需询问即可修改工作区外文件并访问互联网	仅用于你明确接受风险的受控环境

菜单会在当前项后显示 (current)。例如：

1
2
3
4
5
6


Update Model Permissions

 1. Read Only
› 2. Ask for approval (current)
 3. Approve for me
 4. Full Access

四档的核心区别是两个问题：能否直接越过当前工作区 ，以及谁来批准高风险操作 。其中 Approve for me 不是“自动批准一切”，而是把审批交给 Codex 的自动安全审查；Full Access 才是允许工作区外写入和联网且不再询问的高风险模式。

这张菜单仍可能随 CLI 版本、实验功能、permission profiles 和组织管理策略变化。官方文档有时只用 Auto、Read Only 举例，那是对预设的概括，不一定等于特定版本界面的完整菜单。最可靠的依据始终是本机 /permissions 实际显示的内容。

切换只影响后续操作，不会撤销此前已经产生的文件修改。选择完成后，Codex 会提示权限策略已经更新。

3. 新版：用 permission profile 配置默认权限

新版配置文件的最小用法是在 config.toml 中选择一个内置 profile：

1

default_permissions = ":workspace"

另外两个内置值是 :read-only 和 :danger-full-access。还可以定义具名配置文件，例如允许修改工作区、禁止读取 .env，并只允许访问 OpenAI API：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


default_permissions = "project-edit"

[features]
network_proxy = true

[permissions.project-edit]
description = "修改项目，但保护环境文件并限制网络目标"
extends = ":workspace"

[permissions.project-edit.filesystem.":workspace_roots"]
"**/*.env" = "deny"

[permissions.project-edit.network]
enabled = true

[permissions.project-edit.network.domains]
"api.openai.com" = "allow"

network.enabled = true 只允许命令联网；要让 domains 中的规则真正限制目标域名，还必须启用 features.network_proxy，或由管理员启用相应的托管网络要求。启用并允许使用具名 profile 后，它也可能出现在 /permissions 选择器中。权限配置文件目前仍是 Beta，格式和行为可能继续演进。

4. 旧版兼容方式：启动时指定 sandbox

普通本地开发推荐：

1

codex --sandbox workspace-write --ask-for-approval on-request

只读理解项目：

1

codex --sandbox read-only --ask-for-approval on-request

无人值守但已有严格工作区隔离的任务，可以考虑：

1

codex --sandbox workspace-write --ask-for-approval never

完全绕过沙箱和审批的组合风险极高：

1

codex --dangerously-bypass-approvals-and-sandbox

它只适合外部已经完成强隔离、输入和命令范围也受到控制的自动化运行器，不适合个人开发机、生产服务器或包含重要资料的目录。

5. 配置的选择与覆盖

权限配置可能来自多个位置，理解优先级有助于排查“为什么实际模式和预期不同”：

1
2
3
4


新版：default_permissions + [permissions.<name>]
旧版：sandbox_mode / sandbox_workspace_write / --sandbox
审批：approval_policy / --ask-for-approval
会话中：/permissions

新版 permission profiles 与旧版 sandbox 设置二选一，不能按普通“覆盖层”理解为同时生效。实际结果以 /status 为准。临时需要多写一个目录时可用 --add-dir；需要精确控制路径和网络时，使用具名 permission profile。

6. 推荐选择

场景	推荐方式
阅读代码、架构分析、审查	`/permissions` 选择 `Read Only`，或使用 `:read-only`
普通功能开发	`/permissions` 选择 `Ask for approval`
希望减少人工确认	选择 `Approve for me`，同时保留自动风险审查
需要限定网络域名	自定义 permission profile，配置域名 allowlist
受控 CI 或临时自动化	严格限定工作区或自定义 profile，再按需使用 `never`
生产机、个人目录	避免 `Full Access`、`:danger-full-access` 和绕过安全参数

最后记住几个互不相关的概念：/plan 改变的是工作方式，/fast 改变的是服务速度档位，/permissions 才用于权限配置。Approve for me 仍有自动安全审查，只有 Full Access 才会在工作区外写入和联网时不再询问。

九、会话控制和长任务

1. 让会话保持可控

长任务最好分成几个可以验证的阶段：

1
2
3


先分析，不要改文件。
给出方案后再实施第一步。
完成第一步后运行测试，再继续下一步。

发现方向不对时：

用 Enter 立即注入纠正信息；
用 Tab 把新任务排到当前轮次之后；
双击 Esc 编辑上一条消息，并从那里创建分支；
用 /status 查看上下文和会话状态；
用 /compact 压缩已经很长的上下文。

2. 目标和计划

复杂任务可以使用：

1

/plan

它适合先拆解多步骤任务、记录验证点，再开始实际修改。对于简单的单文件修改，不必为了形式强行使用计划模式。

如果当前版本支持持久目标，也可以使用：

1

/goal 完成迁移并保持全部测试通过

目标适合跨多轮持续推进的工作，但仍然需要在每个阶段查看 diff 和验证结果。

3. 并行和分支

不确定两种实现方案时，可以使用 /fork 保留当前对话，再在分支中尝试另一种方案。涉及不同模块的独立任务，也可以使用 /agent 或 /subagents 查看子代理线程。

并行工作并不自动解决冲突。多个线程同时修改同一文件时，仍需要人工审查最终 diff。

4. 会话命名、恢复与整理

会话多了以后，“哪次讨论是哪次”全靠翻记录。Codex 支持为会话命名，并可使用名称或 UUID 管理已保存的会话：

命名。/rename <名称> 直接设置当前会话名称；不带名称执行 /rename 会弹出输入框，其中预填当前名称（如果已设置），并给出一条基于对话内容自动生成的可编辑建议。命名后，名称会出现在 /status 的 Thread name 行和恢复选择器中，也可能随状态栏配置显示在 TUI 底部。启动时没有等价于 Claude Code claude -n 的参数；想开局就命名，启动后立即执行 /new <名称> 或 /clear <名称>。

恢复。codex resume 打开选择器，列出创建时间、更新时间、分支、目录和会话名称（未命名的会话显示首条输入的预览），支持按名称、预览、ID、分支和目录做大小写不敏感的搜索过滤；默认只显示当前目录下的会话，加 --all 查看全部。codex resume <名称> 可以按名称直接恢复；参数若能解析为 UUID，会优先按 UUID 查找，否则按会话名查找。codex resume --last 跳过选择器，恢复当前目录下最近一次会话；需要跨目录选择时加 --all。在交互界面中，也可以执行 /resume 打开会话选择器。

整理。codex archive <名称|ID> 把会话从活动会话列表中隐藏但不删除，codex unarchive <名称|ID> 可以恢复；交互界面的 /archive 会归档当前会话并退出。codex delete <名称|ID> 和 /delete 执行的是永久删除，其中 /delete 还会删除当前会话派生出的子会话，应在确认不再需要记录后使用。会话记录通常以 JSONL 文件保存在 $CODEX_HOME/sessions/，归档后移入 $CODEX_HOME/archived_sessions/；这是本地实现细节，目录布局可能随版本演进。一次性的非交互任务若不想持久化会话，可使用 codex exec --ephemeral。

实践上可以像对待分支一样对待会话：一个独立任务一个命名会话，完成后执行 archive，避免选择器被长期任务和临时问答淹没。

十、配置文件和项目规则

除了 AGENTS.md，Codex 还可以通过用户级配置文件保存默认行为。常见的使用层级是：

1
2
3
4


当前提示词 一次性约束
AGENTS.md 项目长期规则
config.toml 个人默认模型、沙箱和工具配置
profile 针对不同项目或工作流的一组配置

临时覆盖配置可以使用：

1

codex -c model="<model>" -c sandbox_mode="workspace-write"

不要把某一次任务的特殊要求写入全局配置或 AGENTS.md。例如“这次只读审查”属于当前任务；“这个仓库永远不能直接修改主题文件”才适合放入项目规则。

项目规则应该描述可验证的约定，例如构建命令、目录边界和测试要求，不要写成无法判断的泛泛要求。

十一、从 Claude Code CLI 迁移时的实际差异

1. 不要假设工具环境相同

两者虽然都在终端中运行，但启动进程、shell、沙箱、配置文件和工具实现可能不同。同一个 Get-Content 或 git 命令，在两个客户端中读到的内容可能不一样。

2. 规则文件不同

可以同时保留：

1
2


CLAUDE.md 给 Claude Code 使用
AGENTS.md 给 Codex 使用

两者可以共享项目事实，但不要假设某个客户端会自动读取另一个客户端的专属规则文件。

3. 任务描述可以更偏向结果

以前如果习惯给 Claude Code 拆解很多 shell 步骤，在 Codex 中通常可以把提示改成最终目标，再补充边界和验收条件：

1
2


审查当前分支相对 main 的变更。
优先发现真实缺陷、兼容性问题和测试缺口，不要修改文件。

4. 验证要求要明确写出

无论使用哪个客户端，都不要默认“代码生成成功”就是“任务完成”。明确要求测试、构建和 diff 检查，结果会稳定很多。

十二、常见故障排查

命令提示没有权限

先确认命令的目标是否在工作区内，再决定是否通过 /permissions 或一次性授权放行。需要访问工作区外的单个目录时，优先使用 --add-dir，不要直接打开完全访问。

Codex 修改了文件但没有真正完成

检查它是否执行了构建和测试。可以继续发送：

1
2


现在不要解释，直接运行最相关的验证。
如果失败，继续定位并修复，直到给出明确结果。

上下文太长，回答开始重复

使用 /compact，然后重新强调不可违反的约束、当前失败点和验收标准。长期规则应移动到 AGENTS.md，不要依赖模型记住几十轮之前的对话。

Windows 上 `codex` 不能运行

如果 PowerShell 阻止 codex.ps1，尝试：

1
2


codex.cmd --version
codex.cmd --help

Git 子模块或外部目录无法写入

这通常是 Git 配置目录或沙箱边界的权限问题。先确认目标路径，再请求精确的写入授权；不要用完全访问模式掩盖路径配置错误。

十三、以 Hugo 博客为例的推荐工作方式

对一个 Hugo 博客，我会把一次内容任务写成这样：

1
2
3
4


在 AI 分类下新建一篇 Codex 使用文章。
采用现有文章的 Page Bundle 结构和 TOML front matter。
先作为 draft 保存，不要修改已有文章。
完成后检查 Markdown 结构、内部链接和 front matter；如果 Hugo 可用，再执行生产构建。

如果文章已经确定要发布，还需要同步维护文章索引：

更新 posts-index.md 的文章列表；
重新编号；
刷新总数、日期范围、分类统计和系列统计；
确保 Tags 列与 front matter 一致。

内容工作也应该遵守 Git 工作流：先看 git status，修改后看 git diff，确认无误后再提交和推送。

十四、最后的使用建议

刚开始使用 Codex 时，不必记住所有命令。先掌握下面几个就足够覆盖大部分工作：

1
2
3
4
5
6
7
8
9


codex
codex --help
codex resume --last
codex review
/status
/compact
/review
/permissions
/exit

真正影响结果的，通常不是记住更多快捷键，而是把目标、范围、约束和验收标准说清楚，并要求 Codex 给出验证证据。

可以把 Codex 当成一个能够操作工程环境的协作者，而不是只会输出代码片段的聊天机器人：让它先理解真实项目，再进行小范围修改，最后用构建、测试和 diff 证明工作确实完成。

参考：

Claude Code 使用指南

Mon, 17 Nov 2025 10:00:00 +0800

写在前面

为简化表达，本文使用cc代指Claude Code。希望另一个cc看完以后也能有所收获🤪。

带有Note标记的链接是十分推荐阅读学习的，比如下面的官方文档，本文的很多内容也是直接取自官方文档。

📝 备注

官方文档（支持中文）

标题中带有【重点】的章节，请认真阅读学习。

什么是Claude Code

Claude Code 是 Anthropic 官方推出的 AI 编程助手，它是一个可以在终端中直接运行的命令行工具。与传统的 AI 聊天工具不同，Claude Code 具备以下特点：

深度集成开发工作流 — 直接在终端中运行，可以读取、编辑文件，执行命令
强大的代码理解能力 — 基于 Claude 系列大模型（如 Sonnet、Opus、Haiku；具体可用型号取决于套餐与提供商），理解复杂代码结构
MCP 协议支持 — 通过 Model Context Protocol 扩展能力，连接外部工具和服务
持久化会话 — 对话记录本地保存，随时恢复继续讨论
灵活的权限控制 — 多种权限模式适应不同使用场景

CLI命令

这部分命令在终端中直接执行。

以下仅列出常用命令，查看完整参考。

命令	描述	示例
`claude update`	更新到最新版本
`claude --version`, `-v`	输出版本号
`claude --continue`, `-c`	继续当前目录中最近的对话
`claude --resume`, `-r`	按 ID 或名称恢复特定会话，或显示交互式选择器以选择会话	`claude --resume auth-refactor`
`claude mcp list`	列出所有配置的MCP服务器
`claude --permission-mode`	以指定的权限模式开始	`claude --permission-mode plan`
`claude --name`, `-n`	为会话设置显示名称，显示在 `/resume` 和终端标题中。您可以使用 `claude --resume <name>` 恢复命名会话。	`claude -n "my-feature-work"`

交互模式

这部分命令需要在终端中启动cc后，在cc交互页面中执行。

以下仅列出常用命令，完整参考请查看对应链接。

💡 提示

在提示框为空时输入 ? 可查看常用快捷键。

快速命令

完整参考

符号	描述	示例
/	命令：触发斜杠命令或 skill	/clear 清空当前上下文
@	感知：将文件/资源注入上下文	解释 @src/auth.ts 的逻辑
!	行动：在提示框中直接执行 Shell	! `git log --oneline -5`（结果注入上下文）

💡 提示

输入!执行持续性命令后，想再继续对话，需要敲击Esc键。若想后台运行命令，可使用以下方式：

提示 Claude Code 在后台运行命令

按 Ctrl+B 将常规 Bash 工具调用移到后台

在命令的最后添加 &

内置命令

完整参考

以下各表中，<arg> 表示必需的参数，[arg] 表示可选参数。

设置与配置

命令	描述
/help	显示帮助和可用命令
/model [model]	选择或更改 AI 模型。对于支持的模型，使用左/右箭头调整努力级别。更改立即生效，无需等待当前响应完成
/status	打开设置界面（状态选项卡），显示版本、模型、账户和连接性
/config	打开设置界面以调整主题、模型、输出样式和其他首选项。别名：`/settings`
/permissions	查看或更新权限。别名：`/allowed-tools`
/mcp	管理 MCP server 连接和 OAuth 身份验证
/skills	列出可用的 skills
/agents	管理 agent 配置
/plugin	管理 Claude Code plugins
/hooks	管理工具事件的 hook 配置

会话相关

命令	描述
/rename [name]	重命名当前会话。不使用名称时，从对话历史自动生成
/add-dir	将新的工作目录添加到当前会话
/resume [session]	按 ID 或名称恢复对话，或打开会话选择器。别名：`/continue`
/init	使用 `CLAUDE.md` 指南初始化项目
/compact [instructions]	压缩对话，可选的焦点说明
/clear	清除对话历史并释放上下文。别名：`/reset`、`/new`
/export [filename]	将当前对话导出为纯文本。使用文件名时，直接写入该文件。不使用时，打开对话框以复制到剪贴板或保存到文件
/plan	直接从提示进入 plan mode
/tasks	列出和管理后台任务
/diff	打开交互式差异查看器，显示未提交的更改和每轮差异。使用左/右箭头在当前 git 差异和单个 Claude 轮次之间切换，使用上/下浏览文件
/btw	提出快速附加问题，无需添加到对话中

使用情况

命令	描述
/context	将当前上下文使用情况可视化为彩色网格
/cost	显示令牌使用统计信息
/stats	可视化每日使用情况、会话历史、连胜和模型偏好

其他

命令	描述
/doctor	诊断并验证您的 Claude Code 安装和设置
/exit	退出 CLI。别名：`/quit`

键盘快捷键

完整参考

常规控制

快捷键	描述	上下文
`Ctrl+C`	取消当前输入或生成	标准中断
`Ctrl+X Ctrl+K`	终止所有后台子代理。在 3 秒内按两次以确认	后台代理控制
`Ctrl+D`	退出 Claude Code 会话	EOF 信号
`Ctrl+G`	在默认文本编辑器中打开	在默认文本编辑器中编辑您的提示或自定义响应
`Ctrl+L`	清除终端屏幕	保留对话历史
`Ctrl+O`	切换转录查看器	显示详细的工具使用和执行情况，还会展开 MCP 调用
`Ctrl+R`	反向搜索命令历史	交互式搜索以前的命令
`Ctrl+B`	后台运行任务	后台运行 bash 命令和代理。Tmux 用户按两次
`Ctrl+T`	切换任务列表	在终端状态区域中显示或隐藏任务列表
`Up/Down arrows`	导航命令历史	回忆以前的输入
`Esc` + `Esc`	回退或总结	将代码和/或对话恢复到上一个点，或从选定的消息进行总结
`Shift+Tab` 或 `Alt+M`（某些配置）	循环权限模式	在 `default`、`acceptEdits`、`plan` 之间循环；若启用 `auto` / `bypassPermissions` 也会纳入循环
`Alt+P`（macOS 为 `Option+P`）	切换模型	在不清除提示的情况下切换模型
`Alt+T`（macOS 为 `Option+T`）	切换扩展思考	启用或禁用扩展思考；是否可用取决于当前模型与配置
`Alt+O`（macOS 为 `Option+O`）	切换快速模式	启用或禁用快速模式
`Ctrl+V`	粘贴图片	从剪贴板粘贴图片；WSL 用 `Alt+V`

文本编辑

快捷键	描述	上下文
`Ctrl+K`	删除到行尾	存储已删除的文本以供粘贴
`Ctrl+U`	从光标删除到行首	存储已删除的文本以供粘贴
`Ctrl+Y`	粘贴已删除的文本	粘贴用 `Ctrl+K` 或 `Ctrl+U` 删除的文本
`Ctrl+A`	光标移到行首	移到当前逻辑行的开始
`Ctrl+E`	光标移到行尾	移到当前逻辑行的末尾
`Ctrl+W`	删除前一个单词	存储已删除的文本以供粘贴

多行输入

快捷键	上下文	方法
`\` + `Enter`	在所有终端中工作	快速转义
`Ctrl+J`	多行的换行符	控制序列

配置

设置

完整参考

权限模式【重点】

权限是 Claude Code 安全模型的两个正交维度：

权限模式（mode）——决定"默认怎么批准工具调用"，是一套粗粒度的全局策略；
权限规则（rule）——决定"具体允许/拒绝哪些工具"，是一套细粒度的白/黑名单（见本节末尾）。

一句话：模式管"怎么问"，规则管"问什么"。两者配合——比如开 acceptEdits 让编辑免提示，再用 deny 规则把 .env、生产配置挡在门外。

六种模式

在设置文件中用 defaultMode 指定启动时的默认模式：

模式	描述
`default`	标准行为：首次使用每个工具时逐个提示权限
`acceptEdits`	自动接受工作目录及 `additionalDirectories` 内的文件编辑，以及 `mkdir`、`touch`、`mv`、`cp` 等常见文件系统命令
`plan`	Plan Mode：可以读取文件、运行只读 shell 命令来探索分析，但不会编辑源文件。适合先调研、后动手
`auto`	自动批准工具调用，同时在后台做安全校验，确认操作与你的请求一致（研究预览阶段）
`dontAsk`	自动拒绝工具，除非已通过 `/permissions` 或 `permissions.allow` 规则预先批准
`bypassPermissions`	跳过所有权限提示。但针对根目录、主目录的删除操作（如 `rm -rf /`）仍会作为断路器（circuit breaker）弹窗

⚠️ 警告

bypassPermissions 会跳过权限提示，只应在隔离、可丢弃的环境（容器、临时虚拟机、devcontainer）里使用。auto 则依赖安全分类器自动判断操作风险，并非“无条件放行”；它仍是预览能力，且受模型、套餐、提供商与组织策略限制。

怎么切换模式

方式	作用范围	说明
设置文件的 `defaultMode`	永久	写进 `settings.json`，每次启动都生效
`claude --permission-mode plan`	单次会话	启动时指定本次模式（见前文 CLI 命令表）
`Shift+Tab`（或部分配置下的 `Alt+M`）	即时	在 `default` / `acceptEdits` / `plan` 之间循环，若启用 `auto` / `bypassPermissions` 也会纳入（见前文快捷键表）

怎么选【重点】

场景	推荐模式	理由
不熟的项目、关键仓库、首次让 cc 动手	`default`	一步步确认，出问题能及时踩刹车
信任的项目里做大量改动、重构	`acceptEdits`	文件编辑免提示，省去反复回车，但 Bash 等仍逐个受控
只想让 cc 调研、出方案、不改代码	`plan`	强制"想清楚再动手"，方案确认后再切回动手模式
全程自动、跑长任务、且相信安全校验	`auto`	后台校验兜底；预览特性，留意边界
容器/沙箱等可丢弃环境里跑 CI 式任务	`bypassPermissions`	彻底免提示换取速度，仅限隔离环境

口诀：新人 default，重构 acceptEdits，调研 plan，隔离环境才 bypass。

禁用高危模式

要阻止使用 bypassPermissions 或 auto（常用于组织托管策略），在任一设置文件中设置：

1
2
3
4
5
6


{
 "permissions": {
 "disableBypassPermissionsMode": "disable",
 "disableAutoMode": "disable"
 }
}

放在托管设置里时无法被下层覆盖。

模式之外：权限规则（allow / ask / deny）

模式给的是"默认批准策略"，精细控制要靠权限规则：用 /permissions 管理，或写进 settings.json 的 permissions.allow / ask / deny。

allow：免提示直接放行；
ask：每次都来问你；
deny：直接拦截匹配的调用（裸工具名如 Bash 会让 Claude 完全看不到该工具）。

规则按 deny → ask → allow 的顺序求值，第一条命中即生效，deny 永远优先。语法是 Tool 或 Tool(specifier)：

规则	效果
`Bash`	匹配所有 Bash 命令
`Bash(npm run build)`	只匹配这条精确命令
`Bash(npm *)`	匹配任意 `npm` 开头的命令
`Read(./.env)`	匹配读取当前目录下的 `.env`
`WebFetch(domain:example.com)`	匹配对 `example.com` 的请求

💡 提示

高频做法：只在范围足够窄时用 allow 放开常用命令，例如 Bash(npm run *)；用 deny 保护危险操作和敏感文件。不要为了省提示直接放行 Bash(git *)：它也会覆盖 git push、历史改写等高影响操作。规则只是权限边界，仍需配合仓库的 Git 工作流约定。

📝 备注

🔗 官方文档：配置权限（含完整规则语法、各工具 Bash / PowerShell / Read / Edit / MCP / Agent 的专属匹配规则，以及权限与沙箱的关系）

自定义状态行

状态行是 Claude Code 底部的可自定义栏，可以运行你配置的任何 shell 脚本。它通过 stdin 接收 JSON 会话数据，并显示你的脚本打印的任何内容，为你提供一个持久的、一目了然的上下文使用情况、成本、git 状态或任何其他你想跟踪的内容的视图。

https://code.claude.com/docs/zh-CN/statusline

Plugin组件

plugin 是一个自包含的组件目录，用于扩展 Claude Code 的自定义功能，包括 Skills、Agents、Hooks、MCP servers 和 LSP servers。

Skills

Skills 扩展了 Claude 能做的事情，skill是一个对外提供功能的“能力单元”，接收输入，执行逻辑，返回结果。

https://code.claude.com/docs/zh-CN/skills

Agents

Subagents 是处理特定类型任务的专门 AI 助手。每个 subagent 在自己的 context window 中运行，具有自定义系统提示、特定的工具访问权限和独立的权限。当 Claude 遇到与 subagent 描述相匹配的任务时，它会委托给该 subagent，该 subagent 独立工作并返回结果。

https://code.claude.com/docs/zh-CN/sub-agents

Hooks

Hooks 是用户定义的 shell 命令、HTTP 端点或 LLM 提示，在 Claude Code 生命周期中的特定点自动执行。

https://code.claude.com/docs/zh-CN/hooks-guide

https://code.claude.com/docs/zh-CN/hooks

MCP servers

Plugins 可以捆绑 Model Context Protocol (MCP) servers 以将 Claude Code 与外部工具和服务连接。

连接 MCP 服务器后，您可以要求 Claude Code：

从问题跟踪器实现功能：“添加 JIRA 问题 ENG-4521 中描述的功能，并在 GitHub 上创建 PR。”
分析监控数据：“检查 Sentry 和 Statsig 以检查 ENG-4521 中描述的功能的使用情况。”
查询数据库：“根据我们的 PostgreSQL 数据库，查找使用功能 ENG-4521 的 10 个随机用户的电子邮件。”
集成设计：“根据在 Slack 中发布的新 Figma 设计更新我们的标准电子邮件模板”
自动化工作流：“创建 Gmail 草稿，邀请这 10 个用户参加关于新功能的反馈会议。“

https://code.claude.com/docs/zh-CN/mcp

LSP servers

Plugins 可以提供Language Server Protocol (LSP) servers，在处理代码库时为 Claude 提供实时代码智能。

https://code.claude.com/docs/zh-CN/plugins-reference#lsp-servers

实用仓库

ccusage

https://github.com/ryoppippi/ccusage

A CLI tool for analyzing Claude Code/Codex CLI usage from local JSONL files.

opcode

https://github.com/winfunc/opcode

A powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.

everything-claude-code

https://github.com/affaan-m/everything-claude-code

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

superpowers

https://github.com/obra/superpowers

An agentic skills framework & software development methodology that works.

claude-code-tips

https://github.com/ykdojo/claude-code-tips

45 tips for getting the most out of Claude Code, from basics to advanced - includes a custom status line script, cutting the system prompt in half, using Gemini CLI as Claude Code’s minion, and Claude Code running itself in a container. Also includes the dx plugin.

skills

https://github.com/anthropics/skills

Public repository for Agent Skills.

最佳实践

编写有效的 CLAUDE.md

运行 /init 根据你的当前项目结构生成启动 CLAUDE.md 文件，然后随时间精化。

CLAUDE.md 是一个特殊文件，Claude 在每次对话开始时读取。包括 Bash 命令、代码风格和工作流规则。这给 Claude 提供了它无法从代码中推断的持久上下文。/init 命令分析你的代码库以检测构建系统、测试框架和代码模式，为你提供坚实的基础来精化。CLAUDE.md 文件没有必需的格式，但保持简短和易读。例如：

CLAUDE.md

1
2
3
4
5
6
7


# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you're done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

CLAUDE.md 在每个会话中加载，所以只包括广泛适用的东西。对于仅有时相关的域知识或工作流，改用 skills。Claude 按需加载它们，不会使每次对话都膨胀。保持简洁。对于每一行，问自己：“删除这个会导致 Claude 犯错吗？” 如果不会，删除它。膨胀的 CLAUDE.md 文件会导致 Claude 忽略你的实际指令！

✅ 包括	❌ 排除
Claude 无法猜测的 Bash 命令	Claude 可以通过读取代码弄清楚的任何东西
与默认值不同的代码风格规则	Claude 已经知道的标准语言约定
测试指令和首选测试运行器	详细的 API 文档（改为链接到文档）
存储库礼仪（分支命名、PR 约定）	经常变化的信息
特定于你的项目的架构决策	长解释或教程
开发者环境怪癖（必需的环境变量）	自明的实践，如”编写干净的代码”
常见陷阱或非显而易见的行为	文件逐个描述代码库

如果 Claude 继续做你不想要的事情，尽管有反对的规则，该文件可能太长，规则被遗漏了。如果 Claude 问你在 CLAUDE.md 中回答的问题，措辞可能不明确。像对待代码一样对待 CLAUDE.md：当事情出错时审查它，定期修剪它，并通过观察 Claude 的行为是否实际改变来测试更改。你可以通过添加强调（例如”IMPORTANT”或”YOU MUST”）来调整指令以改进遵守。将文件检入 git，以便你的团队可以贡献。该文件随时间增加价值。CLAUDE.md 文件可以使用 @path/to/import 语法导入其他文件：

CLAUDE.md

1
2
3
4
5


See @README.md for project overview and @package.json for available npm commands.

# Additional Instructions
- Git workflow: @docs/git-instructions.md
- Personal overrides: @~/.claude/my-project-instructions.md

你可以在多个位置放置 CLAUDE.md 文件：

主文件夹（~/.claude/CLAUDE.md）：适用于所有 Claude 会话
项目根目录（./CLAUDE.md）：检入 git 以与你的团队共享
父目录：对于 monorepos 有用，其中 root/CLAUDE.md 和 root/foo/CLAUDE.md 都会自动拉入
子目录：当处理这些目录中的文件时，Claude 按需拉入子 CLAUDE.md 文件

有效沟通

你与 Claude Code 沟通的方式显著影响结果的质量。

提出代码库问题

问 Claude 你会问资深工程师的问题。

当加入新代码库时，使用 Claude Code 进行学习和探索。你可以问 Claude 你会问另一个工程师的相同类型的问题：

日志如何工作？
我如何创建新的 API 端点？
foo.rs 第 134 行的 async move { ... } 做什么？
CustomerOnboardingFlowImpl 处理哪些边界情况？
为什么这段代码在第 333 行调用 foo() 而不是 bar()？

以这种方式使用 Claude Code 是一个有效的入职工作流，改进了加入时间并减少了对其他工程师的负担。无需特殊提示：直接提问。

让 Claude 采访你【重点】

对于更大的功能，让 Claude 先采访你。从最小的提示开始，要求 Claude 使用 AskUserQuestion 工具采访你。

Claude 会问你可能还没有考虑过的东西，包括技术实现、UI/UX、边界情况和权衡。

1
2
3
4
5


I want to build [brief description]. Interview me in detail using the AskUserQuestion tool.

Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask obvious questions, dig into the hard parts I might not have considered.

Keep interviewing until we've covered everything, then write a complete spec to SPEC.md.

一旦规范完成，启动新会话来执行它。新会话有干净的 context，完全专注于实现，你有一个书面规范可以参考。

管理你的会话

对话是持久的和可逆的。利用这一点！

尽早且经常改正方向

一旦你注意到 Claude 偏离轨道，立即改正它。

最好的结果来自紧密的反馈循环。虽然 Claude 有时会在第一次尝试时完美地解决问题，但快速改正它通常会更快地产生更好的解决方案。

Esc：使用 Esc 键在中途停止 Claude。Context 被保留，所以你可以重定向。
Esc + Esc 或 /rewind：按 Esc 两次或运行 /rewind 来打开 rewind 菜单并恢复之前的对话和代码状态，或从选定的消息进行总结。
"撤销那个"：让 Claude 恢复其更改。
/clear：在不相关的任务之间重置 context。长会话与无关的 context 可能会降低性能。

如果你在一个会话中对同一问题改正了 Claude 两次以上，context 就充满了失败的方法。运行 /clear 并使用更具体的提示重新开始，该提示包含你学到的东西。干净的会话与更好的提示几乎总是优于长会话与累积的改正。

积极管理 context【重点】

在不相关的任务之间频繁运行 /clear 来重置 context。

当你接近 context 限制时，Claude Code 会自动压缩对话历史，这保留了重要的代码和决策，同时释放空间。在长会话中，Claude 的 context window 可能会充满无关的对话、文件内容和命令。这可能会降低性能，有时会分散 Claude 的注意力。

在任务之间频繁使用 /clear 来完全重置 context window
当自动压缩触发时，Claude 总结最重要的东西，包括代码模式、文件状态和关键决策
为了更多控制，运行 /compact <instructions>，如 /compact Focus on the API changes
要仅压缩对话的一部分，使用 Esc + Esc 或 /rewind，选择消息检查点，并选择 从这里总结。这会压缩从该点开始的消息，同时保持早期 context 完整。
在 CLAUDE.md 中使用像 "When compacting, always preserve the full list of modified files and any test commands" 这样的指令来自定义压缩行为，以确保关键 context 在总结中存活
对于不需要留在 context 中的快速问题，使用 /btw。答案出现在可关闭的覆盖层中，永远不会进入对话历史，所以你可以检查细节而不增加 context。

使用 subagents 进行调查

使用 "use subagents to investigate X" 委托研究。它们在单独的 context 中探索，为实现保持你的主对话干净。

由于 context 是你的基本约束，subagents 是可用的最强大的工具之一。当 Claude 研究代码库时，它读取许多文件，所有这些都消耗你的 context。Subagents 在单独的 context windows 中运行并报告摘要：

1
2


Use subagents to investigate how our authentication system handles token
refresh, and whether we have any existing OAuth utilities I should reuse.

subagent 探索代码库、读取相关文件并报告发现，所有这些都不会使你的主对话混乱。你也可以在 Claude 实现某些东西后使用 subagents 进行验证：

1

use a subagent to review this code for edge cases

使用检查点进行 Rewind

Claude 进行的每个操作都会创建一个检查点。你可以将对话、代码或两者恢复到任何之前的检查点。

Claude 在更改前自动检查点。双击 Escape 或运行 /rewind 来打开 rewind 菜单。你可以仅恢复对话、仅恢复代码、恢复两者或从选定的消息进行总结。有关详细信息，请参阅 Checkpointing。与其仔细规划每一步，你可以告诉 Claude 尝试一些冒险的事情。如果不起作用，rewind 并尝试不同的方法。检查点在会话中持续，所以你可以关闭你的终端并稍后仍然 rewind。

检查点仅跟踪 Claude 进行的更改，不跟踪外部进程。这不是 git 的替代品。

恢复对话

运行 claude --continue 来继续你离开的地方，或 --resume 来从最近的会话中选择。

Claude Code 在本地保存对话。当任务跨越多个会话时，你不必重新解释 context：

1
2


claude --continue # Resume the most recent conversation
claude --resume # Select from recent conversations

使用 /rename 给会话起描述性名称，如 "oauth-migration" 或 "debugging-memory-leak"，以便你稍后可以找到它们。像对待分支一样对待会话：不同的工作流可以有单独的、持久的 context。

处理大型输入

处理大量代码或长指令时：

避免直接粘贴：Claude Code 可能难以处理非常长的粘贴内容
使用基于文件的工作流：将内容写入文件并要求 Claude 读取它
注意 VS Code 的限制：VS Code 终端特别容易截断长粘贴

常见错误和解决方法

1、API Error: The model has reached its context window limit.

达到上下文窗口限制。

使用/clear清空当前会话的上下文，但这会导致cc不再记得之前聊过什么，可能会影响它对项目的理解。

也可以先使用/compact压缩上下文，直到无法再压缩后，再使用/clear。

2、Unable to connect

先运行 /status 或 /doctor 检查登录状态、网络连接与配置，再按错误信息重新登录或排查代理。不要通过手工篡改 ~/.claude.json 中的内部状态字段来跳过登录或新手引导：这些字段不是稳定的公开配置接口，也不能解决真实的认证或网络故障。

3、Usage Policy

策略提示不等同于网络故障。先阅读提示中指出的具体原因，再把任务改写成合法、明确且有合理授权的目标；不要把“换种问法绕过提示”当作故障处理方法。

附录

📝 备注

🔗https://zhuanlan.zhihu.com/p/2009744974980331332

📝 备注

🔗https://code.claude.com/docs/zh-CN/best-practices

AI Coding Assistant on 纪伟的个人博客

Codex 使用指南

一、Codex 适合做什么

二、一次任务的推荐流程

1. 先说目标和边界

2. 让它先检查现状

3. 让它实施最小修改

4. 要求验证

5. 查看最终差异

三、Codex CLI 常用命令

启动和恢复会话

非交互任务和审查

配置和扩展

常用启动参数

四、交互中的斜杠命令

五、值得记住的快捷键

Enter 和 Tab 的区别

六、AGENTS.md 是 Codex 的项目说明书

七、先理解权限模型：边界、沙箱与审批

1. 权限配置文件决定“能做什么”

2. 新旧两套配置不要混用

3. 审批策略决定“何时问你”

4. 看懂一次授权请求

八、查看、切换与配置权限模式

1. 查看当前模式

2. /permissions 到底有哪些选项

3. 新版：用 permission profile 配置默认权限

4. 旧版兼容方式：启动时指定 sandbox

5. 配置的选择与覆盖

6. 推荐选择

九、会话控制和长任务

1. 让会话保持可控

2. 目标和计划

3. 并行和分支

4. 会话命名、恢复与整理

十、配置文件和项目规则

十一、从 Claude Code CLI 迁移时的实际差异

1. 不要假设工具环境相同

2. 规则文件不同

3. 任务描述可以更偏向结果

4. 验证要求要明确写出

十二、常见故障排查

命令提示没有权限

Codex 修改了文件但没有真正完成

上下文太长，回答开始重复

Windows 上 codex 不能运行

Git 子模块或外部目录无法写入

十三、以 Hugo 博客为例的推荐工作方式

十四、最后的使用建议

Claude Code 使用指南

写在前面

什么是Claude Code

CLI命令

交互模式

快速命令

内置命令

设置与配置

会话相关

使用情况

其他

键盘快捷键

常规控制

文本编辑

多行输入

配置

设置

权限模式【重点】

六种模式

怎么切换模式

怎么选【重点】

禁用高危模式

模式之外：权限规则（allow / ask / deny）

自定义状态行

Plugin组件

Skills

Agents

Hooks

MCP servers

LSP servers

实用仓库

六、`AGENTS.md` 是 Codex 的项目说明书

2. `/permissions` 到底有哪些选项

Windows 上 `codex` 不能运行