本章要解决的问题是如何安装和配置 Codex-plugin-cc，以便在 Claude Code 中使用智能代码审查和任务委托功能。通过本章，你将能够成功安装和配置 Codex-plugin-cc，并理解其基本用法。

要开始安装和配置 Codex-plugin-cc，需要满足以下前置条件：

• 拥有 ChatGPT 订阅（包括免费版）或 OpenAI API 密钥。
• 安装 Node.js 18.18 或更高版本。

以下是安装和配置 Codex-plugin-cc 的步骤：

1. 在 Claude Code 中添加 marketplace：

/plugin marketplace add openai/codex-plugin-cc

2. 安装 Codex-plugin-cc：
   ```bash
/plugin install codex@openai-codex

3. 重载插件：

/reload-plugins

4. 运行 `/codex:setup` 命令以检查 Codex 是否已准备好使用：
   ```bash
/codex:setup

如果 Codex 未安装，系统会提示您安装它。您也可以手动安装：

npm install -g @openai/codex

5. 如果 Codex 已安装但尚未登录，请运行：

!codex login

注意：
- 安装和配置过程中可能会遇到错误，请检查 Node.js 版本和 API 密钥是否正确。
- Codex-plugin-cc 的用法包括代码审查、任务委托和项目管理等功能，后续章节将详细介绍。

**本章小结**：
- 安装和配置 Codex-plugin-cc 需要满足特定的前置条件。
- 通过添加 marketplace、安装插件、重载插件和运行 `/codex:setup` 命令，可以成功安装和配置 Codex-plugin-cc。
- Codex-plugin-cc 提供了代码审查、任务委托和项目管理等功能，需要正确配置和使用。

使用 /codex:review 进行代码审查是开发过程中的一个重要步骤，可以帮助您提高代码质量和简化开发流程。在本章中，我们将学习如何使用 /codex:review 命令来进行智能代码审查。

要使用 /codex:review，您需要确保已经安装并配置了 Codex-plugin-cc 插件，并且您的 Claude Code 环境已经准备就绪。具体来说，您需要：

• 安装 Node.js 18.18 或更高版本
• 拥有 ChatGPT 订阅（包括免费版）或 OpenAI API 密钥
• 安装 Codex-plugin-cc 插件

步骤如下：

1. 安装并配置 Codex-plugin-cc 插件：

/plugin marketplace add openai/codex-plugin-cc /plugin install codex@openai-codex /reload-plugins /codex:setup

2. 运行 `/codex:review` 命令来进行代码审查：
   ```bash
/codex:review

这个命令会对您的当前工作进行正常的 Codex 审查，给您同样的代码审查质量，就像直接在 Codex 中运行 /review 命令一样。

注意：

• 代码审查，尤其是多文件更改，可能需要一段时间。一般推荐在后台运行。
• 使用 --base <ref> 参数可以指定基准分支进行审查，例如：

/codex:review --base main

- 使用 `--background` 参数可以在后台运行审查：
   ```bash
/codex:review --background

• 使用 /codex:status 命令可以检查审查进度，使用 /codex:cancel 命令可以取消正在进行的任务。

本章小结：

• 使用 /codex:review 命令可以进行智能代码审查
• 需要安装并配置 Codex-plugin-cc 插件
• 可以使用 --base 参数指定基准分支，使用 --background 参数在后台运行审查
• 可以使用 /codex:status 命令检查审查进度，使用 /codex:cancel 命令取消任务

使用 /codex:adversarial-review 进行可控审查，可以对代码的实现和设计进行压力测试，挑战特定的决策和风险区域。要使用这个功能，需要确保 Codex-plugin-cc 插件已经正确安装和配置。

要点：

• 确保 Node.js 18.18 或更高版本已安装
• 确保 Codex-plugin-cc 插件已正确安装和配置

步骤：

1. 在 Claude Code 中运行 /codex:setup 命令，确保 Codex 已经正确配置
2. 使用 /codex:adversarial-review 命令进行可控审查，例如：

/codex:adversarial-review --base main challenge 是否使用了正确的缓存和重试设计

预期结果：Codex 将对代码的实现和设计进行压力测试，挑战特定的决策和风险区域，并提供审查结果。

注意：

• /codex:adversarial-review 命令可以使用 --wait 和 --background 参数来控制审查过程
• 可以使用 --base <ref> 参数来指定审查的基准分支
• 可以使用额外的焦点文本来指定审查的具体区域

实用技巧：

• 使用 /codex:adversarial-review 命令来压力测试代码的实现和设计，挑战特定的决策和风险区域
• 使用 /codex:status 命令来检查审查过程的进度
• 使用 /codex:cancel 命令来取消正在进行的审查任务

本章小结：

• 使用 /codex:adversarial-review 命令进行可控审查
• 确保 Codex-plugin-cc 插件已经正确安装和配置
• 使用 --base <ref> 参数来指定审查的基准分支
• 使用额外的焦点文本来指定审查的具体区域

使用 /codex:rescue 进行任务委托是提高工作效率的关键步骤。通过这个命令，我们可以将特定任务交给 Codex 处理，从而节省时间和精力。要使用 /codex:rescue，我们需要确保 Codex-plugin-cc 已经正确安装和配置。

前置条件：

• 已经安装 Node.js 18.18 或更高版本。
• 已经安装并配置了 Codex-plugin-cc。
• 有一个 ChatGPT 订阅（包括免费版本）或 OpenAI API 密钥。

步骤操作：

1. 打开 Claude Code，并确保 Codex-plugin-cc 已经启用。
2. 输入 /codex:rescue 命令，后面跟着你想要委托给 Codex 的任务描述。例如：

/codex:rescue investigate why the tests started failing

   这个命令会让 Codex 调查测试失败的原因。
3. 根据需要，可以添加选项来指定任务的详细信息。例如：
   ```bash
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test

这个命令指定使用 gpt-5.4-mini 模型，以中等努力程度来调查不稳定的集成测试。

预期结果：

• Codex 会接受任务并开始处理。
• 你可以使用 /codex:status 命令来检查任务的进度。
• 一旦任务完成，你可以使用 /codex:result 命令来查看结果。

注意事项：

• 任务的处理时间可能会比较长，尤其是当任务复杂或者模型选择较大时。
• 可以使用 --background 选项来将任务放到后台运行，这样可以避免阻塞 Claude Code 的界面。
• 如果你之前已经运行过一个任务，可以使用 --resume 选项来继续上一次的任务。

实用技巧：

• 在委托任务时，尽量提供清晰和具体的描述，这样可以帮助 Codex 更好地理解任务的要求。
• 如果任务需要继续之前的工作，可以使用 --resume 选项来继续上一次的任务。

本章小结：

• 了解了如何使用 /codex:rescue 命令来委托任务给 Codex。
• 知道了如何添加选项来指定任务的详细信息。
• 了解了任务处理的预期结果和注意事项。

要使用 /codex:transfer 进行会话转移，我们需要先确保已经安装并配置了 Codex-plugin-cc 插件。以下是使用 /codex:transfer 的步骤：

前置条件

• 已经安装 Node.js 18.18 或更高版本
• 已经安装并配置了 Codex-plugin-cc 插件
• 已经在 Claude Code 中启动了一个会话

步骤操作

1. 在 Claude Code 中输入 /codex:transfer 命令，创建一个持久的 Codex 线程。

/codex:transfer

   预期结果：系统会打印出一个 `codex resume <session-id>` 命令。

2. 如果需要手动指定会话来源，可以使用 `--source` 参数。
   ```bash
/codex:transfer --source ~/.claude/projects/-Users-me-repo/<session-id>.jsonl

预期结果：系统会使用指定的会话来源创建 Codex 线程。

注意事项

• /codex:transfer 命令会使用 Codex 的外部代理会话导入器，因此会遵循与在 Codex App 中导入 Claude 历史相同的转换规则。
• 会话来源必须位于 ~/.claude/projects 目录下。
• 如果使用的 Codex 版本不支持会话导入，需要升级 Codex 版本。

实用技巧

• 在使用 /codex:transfer 命令之前，确保已经保存了当前的会话，以避免数据丢失。
• 如果遇到会话转移失败的情况，检查会话来源是否正确，并确保 Codex 版本是最新的。

本章小结

• 使用 /codex:transfer 命令可以创建一个持久的 Codex 线程，并将当前 Claude Code 会话转移到 Codex 中。
• 需要确保已经安装并配置了 Codex-plugin-cc 插件，并且 Node.js 版本是 18.18 或更高。
• 可以使用 --source 参数手动指定会话来源。
• 会话转移可能需要升级 Codex 版本以支持会话导入。

本章要解决的问题是如何使用 /codex:status 和 /codex:result 命令来管理任务。读完本章，你将能够掌握如何检查任务进度、获取任务结果和管理任务。

要点：

• 使用 /codex:status 命令检查任务进度
• 使用 /codex:result 命令获取任务结果

前置条件：

• 已安装并配置好 Codex-plugin-cc 插件
• 已运行过 /codex:review 或 /codex:rescue 命令

步骤操作：

1. 运行 /codex:status 命令检查任务进度：

/codex:status

预期结果：任务进度信息将被打印出来。

2. 运行 /codex:result 命令获取任务结果：

/codex:result

预期结果：任务结果将被打印出来。

注意：

• 如果任务尚未完成， /codex:status 命令将显示任务进度信息。
• 如果任务已经完成， /codex:result 命令将显示任务结果信息。
• 可以使用 /codex:cancel 命令取消正在运行的任务。

实用技巧：

• 可以使用 /codex:status 命令检查任务进度，并根据需要取消任务或获取任务结果。
• 可以使用 /codex:result 命令获取任务结果，并根据需要进行进一步的操作。

本章小结：

• 使用 /codex:status 命令检查任务进度
• 使用 /codex:result 命令获取任务结果
• 可以使用 /codex:cancel 命令取消正在运行的任务
• 可以根据任务进度和结果进行进一步的操作

使用 /codex:cancel 进行任务取消

我们先来了解一下 /codex:cancel 命令的作用。这个命令用于取消正在进行的 Codex 任务，例如代码审查或任务委托。

前置条件

• 已安装并配置了 Codex-plugin-cc
• 已经启动了 Claude Code 并登录了 Codex 账户

操作步骤

1. 确定任务 ID：在取消任务之前，我们需要确定要取消的任务 ID。我们可以使用 /codex:status 命令来查看当前的任务状态和 ID。

/codex:status

    这个命令会返回当前任务的状态和 ID，我们可以从中找到要取消的任务 ID。
2.  **取消任务**：一旦我们确定了任务 ID，我们就可以使用 `/codex:cancel` 命令来取消任务。
    ```bash
/codex:cancel <任务 ID>

将 `<任务 ID>` 替换为我们在上一步中确定的任务 ID。

预期结果

• 任务被成功取消：如果任务被成功取消，我们会看到一个确认消息，表明任务已经被取消。
• 任务无法被取消：如果任务无法被取消，我们可能会看到一个错误消息，表明任务不能被取消。这种情况可能是由于任务已经完成或由于其他原因导致任务无法被取消。

注意事项

• 任务 ID 必须正确：在取消任务时，我们必须确保任务 ID 是正确的。如果任务 ID 不正确，可能会导致错误或其他任务被取消。
• 任务可能已经完成：在某些情况下，任务可能已经完成，我们无法取消已经完成的任务。在这种情况下，我们会看到一个错误消息，表明任务已经完成。

实用技巧

• 使用 /codex:status 命令来查看任务状态：在取消任务之前，我们可以使用 /codex:status 命令来查看当前的任务状态和 ID。这可以帮助我们确定要取消的任务 ID。
• 确保任务 ID 是正确的：在取消任务时，我们必须确保任务 ID 是正确的。如果任务 ID 不正确，可能会导致错误或其他任务被取消。

本章小结

• 使用 /codex:cancel 命令来取消正在进行的 Codex 任务
• 确定任务 ID 使用 /codex:status 命令
• 取消任务时必须确保任务 ID 是正确的
• 任务可能已经完成，无法被取消

高级用法：配置和定制 Codex-plugin-cc

本章将指导您如何配置和定制 Codex-plugin-cc，以满足您的特定需求。

前置条件

• 已安装 Node.js 18.18 或更高版本
• 已安装 Codex-plugin-cc 插件
• 已配置 ChatGPT 订阅或 OpenAI API 密钥

配置 Codex-plugin-cc

要配置 Codex-plugin-cc，您可以使用以下命令：

/codex:setup

此命令将提示您输入您的 ChatGPT 订阅或 OpenAI API 密钥。

定制 Codex-plugin-cc

您可以通过修改插件的配置文件来定制 Codex-plugin-cc。配置文件位于 ~/.claude/plugins/codex-plugin-cc/config.json。

以下是一些常见的配置选项：

• model: 指定使用的 Codex 模型
• effort: 指定任务的努力程度
• background: 指定是否在后台运行任务

例如，您可以将配置文件修改为：

{
  "model": "gpt-5.4-mini",
  "effort": "medium",
  "background": true
}

这将指定使用 gpt-5.4-mini 模型，任务努力程度为中等，并在后台运行任务。

高级用法示例

以下是一些高级用法示例：

• 使用 /codex:rescue 命令来调查一个 bug：

/codex:rescue investigate why the tests started failing

• 使用 /codex:transfer 命令来将当前 Claude Code 会话转移到 Codex：

/codex:transfer

• 使用 /codex:adversarial-review 命令来进行可控审查：

/codex:adversarial-review --base main challenge whether this was the right caching and retry design

注意事项

• 在配置和定制 Codex-plugin-cc 时，请确保您了解每个选项的作用和影响。
• 在使用高级用法时，请确保您已经阅读并理解相关文档和示例。

本章小结

• 配置和定制 Codex-plugin-cc 可以满足您的特定需求
• 可以通过修改配置文件来定制插件的行为
• 高级用法示例可以帮助您更好地使用 Codex-plugin-cc
• 在使用高级用法时，请确保您已经阅读并理解相关文档和示例。

实战案例：如何将 Codex-plugin-cc 应用于实际项目中

我们先来看一个实际项目的例子，了解如何将 Codex-plugin-cc 应用于代码审查和任务委托。

项目背景

假设我们有一个 Node.js 项目，需要进行代码审查和任务委托。我们已经安装了 Codex-plugin-cc 插件，并配置了 Claude Code。

步骤 1：代码审查

我们可以使用 /codex:review 命令进行代码审查。例如：

/codex:review --background

这将在后台进行代码审查，我们可以使用 /codex:status 命令检查审查进度：

/codex:status

步骤 2：任务委托

我们可以使用 /codex:rescue 命令将任务委托给 Codex。例如：

/codex:rescue investigate why the tests started failing

这将委托 Codex 调查测试失败的原因，我们可以使用 /codex:status 命令检查任务进度：

/codex:status

步骤 3：任务管理

我们可以使用 /codex:status 命令检查任务进度，使用 /codex:result 命令获取任务结果：

/codex:result

注意事项

• 在使用 /codex:review 命令时，需要确保代码已经提交到 Git 仓库中。
• 在使用 /codex:rescue 命令时，需要确保任务明确具体，否则 Codex 可能无法正确理解任务要求。
• 在使用 /codex:transfer 命令时，需要确保 Claude Code 会话已经保存到文件中。

实用技巧

• 可以使用 /codex:adversarial-review 命令进行可控审查，挑战特定的实现和设计。
• 可以使用 /codex:cancel 命令取消正在进行的任务。

本章小结

• 了解如何使用 /codex:review 命令进行代码审查。
• 了解如何使用 /codex:rescue 命令将任务委托给 Codex。
• 了解如何使用 /codex:status 和 /codex:result 命令检查任务进度和获取任务结果。

问题：如何安装 Codex 插件？

插件安装可以通过以下步骤完成：在 Claude Code 中添加 marketplace，然后安装 codex 插件，最后重载插件并运行 /codex:setup 命令以完成设置。

问题： Codex 插件需要什么环境和依赖？

Codex 插件需要 Node.js 18.18 或更高版本，以及 ChatGPT 订阅（包括免费版本）或 OpenAI API 密钥。

问题：如何使用 /codex:review 命令进行代码审查？

/codex:review 命令用于进行正常的 Codex 代码审查，可以指定 --base <ref> 参数进行分支审查，也支持 --wait 和 --background 参数。例如： /codex:review --base main 或 /codex:review --background。

问题：如何使用 /codex:adversarial-review 命令进行可控审查？

/codex:adversarial-review 命令用于进行可控审查，可以指定 --base <ref> 参数进行分支审查，也支持 --wait 和 --background 参数。例如： /codex:adversarial-review --base main challenge 是否这是正确的缓存和重试设计。

问题：如何使用 /codex:rescue 命令将任务交给 Codex？

/codex:rescue 命令用于将任务交给 Codex，可以指定 --background、--wait、--resume 和 --fresh 参数。例如： /codex:rescue investigate 为什么测试开始失败 或 /codex:rescue --resume apply 最后一次运行的顶级修复。

问题：如何使用 /codex:transfer 命令创建持久的 Codex 线程？

/codex:transfer 命令用于创建持久的 Codex 线程，可以指定 --source 参数手动覆盖会话路径。例如： /codex:transfer 或 /codex:transfer --source ~/.claude/projects/-Users-me-repo/<session-id>.jsonl。

问题：如何解决安装报错问题？

如果在安装过程中遇到报错，可以尝试检查 Node.js 版本是否符合要求，或者重试安装命令。同时，也可以检查是否正确添加了 marketplace 和安装了 codex 插件。