企业官网建设流程全解析

如何在Codex Desktop中使用Claude Code：CodexHost审批、Plan Mode与后台终端实战

【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-host

CodexHost是一个让你在 Codex Desktop 中直接运行 Claude Code、Pi 等多个 Agent Harness 的开源工具：它保留 Codex Desktop 原生交互体验，让 Claude Code 会话以独立线程的形式跑在同一个窗口里。本文带你完整实战三大核心能力：🔐 工具审批（Tool Approval）、📋 Plan Mode 规划模式、⚙️ 后台终端（Background Terminals）。

快速上手：在 Codex Desktop 中选择 Claude Code

只需两步即可开始：

1. 安装并启动 CodexHost（macOS / Windows / Linux 均支持）：

npm install -g @codexhost/cli codexhost

2. 在 Codex Desktop 输入框右下角的 Agent 选择器中，选中Claude Code即可。Claude Code 的会话会出现在左侧栏，与 Codex、Pi 的会话并列管理。

💡 如果启动失败，可运行codexhost console打开本地控制台（http://127.0.0.1:26339/）查看原因。

启动后你会得到如图所示的完整工作区：会话共享一个侧边栏，工具状态、Diff、用量一目了然。

工具审批实战：Claude Code 权限审批面板

Claude Code 执行Edit、Write、Bash等敏感操作时，CodexHost 会把原生的canUseTool权限回调转换为Host Approval 审批卡片，而不是自动放行。你会看到三种可选动作：

几个关键设计保证了审批的“精准对应”：

• 只有当 Claude Code 原生触发权限回调时才会出现审批卡片；原生策略已放行的操作不会伪造审批；
• 一次回合内并发的多个审批各自独立，批准一个不会影响其他；
• 审批被拒绝只是拒绝该工具，回合本身可以继续进行。

审批语义的完整规范见 claude-code-tool-approval-session/spec.md，权限模式目录定义在 permission-modes.ts。

Plan Mode 规划模式：先计划、后执行

对于大型改动，推荐先切到Plan Mode（规划模式）：Claude 会先探索代码库、只读不写，产出一份计划，最后请求退出规划。

CodexHost 直接调用 Claude Code SDK 原生的permissionMode: "plan"，当 Claude 触发ExitPlanMode时，界面会弹出独立的Review plan计划确认卡（而不是普通的“允许一次”）：

• Stay in plan mode：拒绝本次退出，Claude 继续留在规划模式；
• Approve plan and exit plan mode：批准完整计划正文，Claude 恢复到规划前的权限模式并继续执行；
• 若 SDK 未提供非空计划正文，则只提供“保持规划”选项——CodexHost 不会批准无法展示的计划。

规划模式的实现细节（所有权、状态投影与验证）可参考官方文档 claude-code-plan-mode.md，核心转换逻辑位于 plan-review.ts。

后台终端：让长时间命令不阻塞对话

Claude Code 以run_in_background方式启动的 Bash 命令（如跑测试、编译、长时间构建）不会卡住对话：

• 后台命令生成一张独立的命令卡片，所在回合正常结束，卡片保持inProgress状态；
• 卡片被列入侧栏的Background processes，实时输出尽力追加显示；
• 命令结束后卡片自动补发成功 / 失败 / 已停止的最终状态，输出取自原生task_notification提供的输出文件。

当前 Desktop 只提供“停止全部后台终端”入口，且 Host 重启后不恢复运行中的后台任务状态。更多机制说明见 claude-code-background-terminals.md。

小结与进阶

掌握以上三点，你就能在 Codex Desktop 中以“审批可控 + 计划先行 + 长任务后台化”的方式安全使用 Claude Code。想继续深入，可以看看这些资料：

• 项目总览：README.md
• Claude Code 适配器源码：packages/adapters/claude-code/
• 编辑历史恢复机制：claude-code-edit-recovery.md
• 跨 Agent 协作（用#claude-code把任务委派给 Claude Code）：README 中 Cross-Agent Collaboration 章节

需要自行构建时，可先克隆仓库：

git clone https://gitcode.com/gh_mirrors/co/codex-host

【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-host