如何用CodexHost本地控制台排查启动故障：codexhost console诊断页实用指南

如何用CodexHost本地控制台排查启动故障codexhost console诊断页实用指南【免费下载链接】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、Claude Code 等 Agent Harness 的开源工具。当它无法正常注入 Codex Desktop 时你不需要翻日志、猜原因——打开CodexHost 本地控制台codexhost console地址http://127.0.0.1:26339/它不依赖 Codex Desktop 启动成功就能工作总览页会直接告诉你启动卡在哪一步、错误原文是什么还能一键导出诊断包。本文用 5 个小节带你把 CodexHost 控制台诊断页用起来。1️⃣ 认识 CodexHost 本地控制台正常情况下CodexHost 会把 Pi、Claude Code、Grok 等十多个 Harness 会话整合进同一个 Codex Desktop 窗口而控制台是一个只监听本机127.0.0.1的本地网页左侧导航分为总览 / 设置 / 其他三板块。它的设计目标是即使 Codex 启动资源缺失、启动失败也能提供故障恢复入口。完整说明见 docs/operations/codexhost-console.md。2️⃣ 5 种打开控制台的方式方式说明安装包启动macOS 打开应用 / Windows 开始菜单会先开控制台再启动 Codex Desktop终端命令npm start、codexhost launch结束时输出控制台地址codexhost console安装包与 npm 均可用最直接的排查入口Windows 开始菜单codexhost console 快捷方式Codex 设置页关于页 → 打开控制台远程 Host 不支持几个实用参数默认端口26339可用环境变量CODEXHOST_CONSOLE_PORT修改1024–65535端口被占用时直接报错不会自动换端口。设置CODEXHOST_CONSOLE0可完全关闭控制台的自动启动行为。控制台只在本机运行、不设登录浏览器直接访问即可。3️⃣ 读懂总览页5 种状态对照总览页顶部的状态卡会展示当前状态与下一步操作、三个信息框codexhost 版本 / Codex Desktop 版本 / 安装方式以及最近一次启动的结果。状态判断逻辑在 packages/console-server/src/diagnostics.ts 中页面渲染见 packages/renderer-extension/src/console/pages/overview.ts。状态含义与处理⏳ 正在启动本次 Launcher 仍存活稍等即可不会误报重复启动✅ 正常运行codexhost 已成功注入无需操作⚠️ codexhost 功能未能加载Codex Desktop 打开了但没有 codexhost 功能页面会给出失败原因❌ 启动失败说明卡在哪一步 错误原文阶段时间线折叠在详细信息中⛔ 未找到 Codex DesktopdesktopError里说明原因如路径不对可检查安装其中启动失败的阶段时间线来自 Launcher 的启动记录crates/launcher/src/startup_record.rs保留最近 10 次每步带耗时定位慢在哪一步非常直观。常见陷阱Codex 打开了但没有 codexhost 功能时启动记录显示的是成功——因为注入失败时 Desktop Controller 会保持 Codex 正常运行并在后台重试真正原因要看注入状态见下节。首次注入若因页面还在加载而失败一次属正常现象Controller 下一次尝试会自动恢复只有连续失败 2 次及以上、或失败持续超过 1 分钟才会在总览页报警。4️⃣ 深入排查3 个诊断文件 日志控制台读取的数据都存放在数据目录CODEXHOST_DATA_DIR未设置时为~/.codexhost文件内容排查用途diagnostics/launcher-startup-v1.json最近 10 次启动的阶段时间线、Codex 版本、结果与错误启动失败时看卡在哪一步diagnostics/desktop-controller-v1.jsonRenderer 注入状态、当前失败原因、失败次数功能缺失类问题的关键证据logs/host-runtime-*.logHost Runtime 诊断输出与崩溃堆栈运行时异常见 docs/operations/host-runtime-log.md日志始终开启、自动轮转单文件 5 MiB 上限无需任何配置。控制台自身对这些文件的读取与解析实现在 packages/console-server/src/diagnostics.ts。5️⃣ 一键导出诊断包快速求助总览页的快速操作区提供两个按钮导出诊断包含日志下载一份 JSON包含状态、Codex 与 codexhost 版本、最近 5 次启动记录、注入状态以及最新两个 Host Runtime 日志的末尾 32 KiB。用户主目录会被替换为~但日志中可能含项目路径分享前请自行检查实现见 packages/console-server/src/diagnostic-report.ts。提交 Issue自动预填版本、系统、状态和错误不含日志省去手动整理环境的麻烦。补充codexhost inspect --json可在终端输出 Codex Desktop 安装信息与 Launcher 运行状态适合脚本化排查。总结CodexHost 控制台诊断页的排查思路其实很直白先看总览页状态卡 → 失败就看阶段时间线和错误原文 → 功能缺失查注入状态文件 → 搞不定就导出诊断包。它随 codexhost 启动而常驻30 分钟无请求自动退出是启动故障排查时最顺手的第一站。【免费下载链接】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），仅供参考