文档 / 智能体 / Orca 中的 Codex

Codex 是 OpenAI 的智能体 CLI。Orca 对 Codex 的集成是应用中最深入的集成之一——使用、热切换和重启都会保留账户身份。

设置¶

1. 按照 OpenAI 的文档安装 Codex。
2. 从任意终端登录。
3. Orca 会读取 ~/.codex 以获取账户和凭据。

启动¶

从代理组合框中选择 Codex。Orca 会以工作树作为 cwd 启动 codex，并将认证路由到当前选定的账户。

账户热切换¶

许多 Codex 用户会运行多个账户来扩展速率限制。Orca 的账户切换器可以在无需重新登录或编辑配置的情况下切换活动账户。请参阅 热切换 Codex 账户。

系统默认账户与额外账户¶

系统默认账户使用你真实的 ~/.codex 登录信息（与在 Orca 之外直接运行 codex 时使用的 home 目录相同）。Orca 管理的额外账户会在 Orca 的账户数据下拥有各自独立的 home 目录，因此凭据和运行记录保持隔离。新的 Codex 启动会跟随当前活动账户；已经运行的会话会保留其启动时的 home 目录，直到你重启它们。

嵌套 Task 子代理¶

当 Codex 生成 Task 子代理时，Orca 可以在工作树代理列表和 代理仪表板 中将其显示为父代理下的子行。展开箭头可查看每个子代理；点击子代理可聚焦父终端（子代理不拥有独立的窗格）。

在新会话中继续¶

从代理终端的标题栏或上下文菜单中选择 在新会话中继续…。Orca 会启动一个新的代理会话（使用相同或不同的 CLI），并从先前的会话记录或捕获的上下文中注入一个受限的交接提示。原始会话保持原样——这不是 codex resume。

重启标签¶

当 Codex 退出时，重启标签会使用同一账户重新启动代理。如果你在会话中途切换了账户并希望使用新账户重启，请先使用账户切换器，然后再重启。

使用与速率限制¶

Orca 会读取当前活动账户的本地 Codex 使用状态，并将其显示在状态栏中。请参阅 使用与速率限制跟踪。

在 Windows (WSL) 上使用 Codex¶

在 Windows 上，Orca 可以从你主机上的安装或 WSL 发行版运行 Codex。从账户切换器中添加 WSL 托管的 Codex 账户——Orca 会在该发行版内创建一个隔离的账户 home 目录（位于 ~/.local/share/orca/codex-accounts/<id>/home），并将其映射回主机，作为 \\wsl.localhost\<distro>\... 路径用于读取认证信息，同时通过所选发行版进行启动、热切换和速率限制获取。如果目标发行版中未安装 Codex，添加账户对话框会失败，并显示一条可操作的消息，告诉你哪个发行版缺少该二进制文件。