如何在Codex Desktop中使用PiCodexHost模型选择、Thinking控制与Subagent完整指南【免费下载链接】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中直接运行Pi这款 Agent Harness并且原生支持Pi 模型选择、Thinking 深度控制与 Subagent 子任务协作。它通过 CDP 扩展官方 Codex Desktop再经由 Pi Adapter 与原生 Pi 进程通信因此 Pi 的流式输出、工具调用、Diff 审查、Subagent 状态都能显示在 Codex Desktop 的原生界面里。本指南面向新手覆盖从安装、模型选择到 Thinking 档位与 Subagent 可视化的完整操作路径。一、快速开始3步在Codex Desktop中启动Pi1. 安装 CodexHostCodexHost 支持 macOS / Windows / LinuxLinux 含 x64 与 ARM64两种方式任选npm install -g codexhost/cli codexhost也可以从 Releases 页面下载对应平台的安装包macOS / Windows。启动后Codex Desktop 会在原有界面上扩展出 CodexHost 能力如果启动异常可运行codexhost console打开本地控制台查看诊断信息详见 docs/operations/codexhost-console.md。2. 在 Composer 中选择 Pi Agent打开 Codex Desktop 后在输入框Composer右下角的 Agent 选择器中选择Pi。CodexHost 会自动发现本机安装的 Pi CLI并通过 RPC 与原生 Pi 进程建立连接。3. 直接发起对话选择 Pi 后像使用 Codex 一样输入需求即可。Pi 的回复流式渲染在原生对话区文件编辑会显示在 Diff 审查面板中工具调用步骤可以逐条展开查看详情。 小贴士同一窗口中还可以选择 Claude Code、Grok 等十多个 Harness它们的会话共享同一个侧边栏方便来回切换。二、Pi模型选择指南如何挑选合适的Model模型目录从哪来CodexHost 的 Pi Adapter 会启动一次临时 RPC 进程读取 Pi 原生的get_available_models得到当前账号可用的完整Pi 模型目录再映射成浏览器安全的 Model Catalog。选择模型时Adapter 通过原生set_model写入并用get_state回读确认生效——每一步都以 Pi 原生状态为准不会猜测。核心逻辑可见Pi 适配器主入口pi-adapter.ts模型目录映射pi-model-catalog.ts插件清单manifest.json新线程 vs 已有线程场景行为新建 Pi 线程Composer 中的 Model 选择会随创建请求绑定第一次 Agent Loop 前应用所选模型已打开的 Pi 线程在 Idle 状态下可直接切换模型切换后立即回读确认当前生效模型Fork / 恢复线程沿用原生会话状态重新打开时以 Pi Session 实际状态为准三、Thinking控制教程调节Pi的思考深度档位有哪些Pi 原生提供统一的 Thinking 档位CodexHost 在 Draft Catalog 中把它们规范化为一组请求档位Reasoning 模型off / minimal / low / medium / high / xhigh / max非 Reasoning 模型仅offComposer 中的控件采用 Codex 风格的Model/Thinking 组合菜单先选模型再选该模型实际支持的 Thinking 档位。关键机制新手了解即可Thinking 切换通过 Idle 状态的thinking.select命令发给 Pi档位回退与 Provider 参数映射全部由 Pi 自己完成CodexHost 只发送请求并投影状态切换模型后若新模型不支持已选档位Pi 会按自身规则内部回退界面上展示的是 Pi 报告的实际档位若本机 Pi 版本缺少对应 RPC 命令控件会明确降级不会静默失败。设计细节可参考 proposal.md。闪电按钮Codex Fast 模式当 Pi 当前模型支持 Fast 时Composer 底部模型名称左侧会出现一个闪电按钮灰色描边为关闭实心表示开启。开启后请求会带上原生serviceTier: priority优先处理可能增加额度消耗。新线程默认关闭切换模型会重置该开关。完整规则见 docs/harnesses/pi/pi-fast.md。四、Pi Subagent完整用法把大任务拆给子Agent工作原理Pi 的 Subagent 能力来自社区插件pi-subagents的异步 Host 协议与同步 workflow 子任务摘要。CodexHost 的 Pi Adapter 接入这条协议后异步 Subagent 的状态帧被识别为公共subagentDelegation在父对话中生成委派卡片实时显示每个子任务的状态同步 workflow 的每个实际子任务会映射为独立的接收 Thread每个 Subagent 拥有自己的图标点击即可在右侧展开其完整对话父回合取消或父工具返回都不会伪造子任务结束——后台子任务继续独立运行状态变化通过事件持续更新。能做什么并行拆分任务让 Pi 把「调研 实现 测试」拆给多个子 Agent 并行执行随时查看进度主对话中的卡片实时反映每个 Subagent 的运行状态回看子会话子会话通过原生有界转写窗口读取最多 200 条消息以只读方式展示不会误触模型。相关实现与限制说明异步状态接入pi-subagent-rpc.ts委派与子线程映射pi-subagents.ts能力边界文档docs/harnesses/pi/pi-subagents.md⚠️ 注意这是针对pi-subagents插件协议版本化字段的接入不是对所有同名 Subagent 工具的通用支持任务工件被清理或格式不匹配时CodexHost 不会伪造历史卡片。五、进阶实用技巧用量与额度一目了然Pi 会话支持实时用量面板上下文占用、缓存命中率、Token 总量与成本估算都会随对话更新。账号方面CodexHost 支持把本地已登录的 Codex 凭据一键导入 Pi并显示剩余额度详见 docs/product/codex-accounts.md。跨Agent协作用 # 把任务委派给其他Harness在输入框输入#可以选择其他 Agent 协作例如让#pi排查 flaky 测试同时你继续在当前 Agent 上开发。委派会为目标 Harness 创建一个独立原生会话出现在 Codex Desktop 的会话列表中可随时打开查看进度。从任意消息Fork对历史消息点击 Fork可以在当前工作区或新的 Worktree 中分叉出新的 Pi 会话适合并行尝试不同方案。Pi 空历史编辑与恢复的机制见 docs/harnesses/pi/pi-edit-recovery.md。六、架构速览CodexHost如何运行Pi如果你好奇底层实现Pi 的一次请求链路是Codex Desktop → 共享层 → Pi 插件 → 原生 Pi 进程。Renderer 扩展负责界面控件Host Runtime 负责会话编排与协议翻译Pi Adapter 封装全部 Pi 特有的 RPC 语义模型目录、Thinking 回退、Subagent 协议等各层职责严格分离。插件加载与安全边界docs/architecture/harness-plugin-runtime.md领域术语表Harness / Model / Provider / Threaddocs/project/领域术语表.md中文项目介绍docs/project/README.zh-CN.md总结用 CodexHost 在 Codex Desktop 中使用 Pi 的要点安装npm install -g codexhost/cli后运行codexhostComposer 中选择 Pi Agent模型选择从 Pi 原生目录中选择模型新线程选择会在首个回合前生效已有线程在 Idle 时可直接切换Thinking 控制在 Model/Thinking 组合菜单中调节off到max的深度由 Pi 自行完成档位回退与映射Subagent委派卡片实时显示子任务状态点击即可在右侧查看子会话完整对话加分项闪电 Fast 开关、用量面板、#跨 Agent 协作与消息 Fork让 Pi 在 Codex Desktop 里获得接近原生的完整体验。【免费下载链接】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），仅供参考