
如何在Codex Desktop中使用Claude CodeCodexHost审批、Plan Mode与后台终端实战【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-hostCodexHost是一个让你在 Codex Desktop 中直接运行 Claude Code、Pi 等多个 Agent Harness 的开源工具它保留 Codex Desktop 原生交互体验让 Claude Code 会话以独立线程的形式跑在同一个窗口里。本文带你完整实战三大核心能力 工具审批Tool Approval、 Plan Mode 规划模式、⚙️ 后台终端Background Terminals。快速上手在 Codex Desktop 中选择 Claude Code只需两步即可开始安装并启动 CodexHostmacOS / Windows / Linux 均支持npm install -g codexhost/cli codexhost在 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 审批卡片而不是自动放行。你会看到三种可选动作审批选项行为允许一次Allow once仅放行本次调用不改变权限策略本会话允许Allow for session应用 SDK 建议的本会话级授权始终允许Allow always应用 SDK 建议的持久化授权项目/用户设置拒绝Deny拒绝该次调用不会中断整个回合几个关键设计保证了审批的“精准对应”只有当 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.mdClaude Code 适配器源码packages/adapters/claude-code/编辑历史恢复机制claude-code-edit-recovery.md跨 Agent 协作用#claude-code把任务委派给 Claude CodeREADME 中 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考