Codex

Codex 是 OpenAI 推出的编程助理，能在终端中编辑文件、运行命令、提交改动。在 LobeHub 中，你可以通过桌面应用委派 Codex —— 保留熟悉的对话界面，让 Codex 在本地完成实际工作，并完整访问你的项目。

发送一条提示，Codex 会打开文件、修改代码、运行测试，并把过程反馈给你。文件变更、待办列表、命令输出会随着助理推进实时进入聊天；会话能跨轮次恢复，一项长任务可以分布在多条消息中持续推进。

什么是 LobeHub 中的 Codex？

它是 LobeHub 对话界面与本地 Codex CLI 之间的桥梁。LobeHub 在本地以子进程形式启动 Codex CLI，把它的事件流接入聊天会话，并将 Codex 的工具输出 —— 文件变更、待办列表、命令执行 —— 渲染为一等公民的聊天块。你用自然语言指挥助理，Codex 在本地用你的环境、凭据与项目上下文执行。

使用条件

LobeHub 桌面应用 —— Codex 助理只在桌面版可用，Web 端无法启动本地进程。
已安装 Codex CLI —— codex 命令需要在你的 PATH 中可用。
已登录 —— 在 LobeHub 调用前，需在终端中先运行一次 codex 完成认证。

安装 Codex CLI

任选一种方式：

推荐（npm）

bash

npm install -g @openai/codex

Homebrew（macOS）

bash

brew install --cask codex

安装完成后，在终端中运行一次 codex 完成登录。详情见 Codex 安装指南。

若 LobeHub 未能检测到 CLI，会弹出安装 Codex CLI 引导，并提供打开系统工具按钮 —— 安装完成后点击即可重新检测。

在 LobeHub 中添加 Codex

当 LobeHub 检测到本机已安装 Codex CLI，首页会出现一张标记为「编程助理」的添加 Codex 推荐卡片，点击即可一步创建 Codex 助理。

你也可以手动创建：从创建助理菜单中选择 Codex 类型即可。

每个助理彼此独立，可以分别绑定到不同的项目或工作流。

工作目录

每个 Codex 会话都绑定一个工作目录 —— 即 Codex 视为项目根的文件夹。在发出第一条消息前，先在聊天输入区域设置工作目录。会话进行中切换目录会为该话题开启一个新的 Codex 会话；聊天记录会保留，但旧会话的上下文无法恢复。

如果切换目录后，已保存的 Codex 线程无法安全恢复，LobeHub 会提示：「已保存的 Codex 线程无法安全恢复，已为该话题开启新的会话。」

聊天中会渲染什么

LobeHub 不会把 Codex 的工具调用渲染成原始 JSON，而是用专用区块呈现：

文件变更 —— Codex 对文件的修改会展示为可展开的列表，包含操作类型（新增、删除、修改、重命名）、文件路径，以及每个文件的行数变化（+/−）。点击可查看改动详情。

待办列表 —— Codex 规划多步任务时，待办会渲染为进度卡片，列出已完成、进行中和待办项，并显示完成进度（如「3/5 已完成」）。Codex 完成任务时，待办会自动勾选。

命令执行 —— Codex 运行的 shell 命令会显示命令本身、退出码以及 stdout / stderr 输出。成功与失败状态一目了然。

子助理 —— Codex 可以派生子助理并行工作。它们的输出在会话中以独立线程呈现，不会污染主对话气泡。

会话与恢复

Codex 会话在同一话题中跨消息持续。你可以发出追问，例如「顺便也更新一下测试」，Codex 会接着上一次的进度继续 —— 同样的文件、同样的上下文、同样的计划。

下列情况下，会话无法恢复：

自上次保存以来工作目录被更改
原始 Codex 线程已不存在
CLI 报错「no conversation found」或「thread not found」

任一情况发生时，LobeHub 都会自动开启一段新会话。

它在哪里运行

执行设备选择器让你决定 Codex 助理在哪里运行：

本机 —— Codex 在桌面应用内作为本地进程运行，默认选项。
云沙箱 —— Codex 在临时云沙箱中运行。当你不希望助理触碰本地文件时适用。
远程设备 —— 驱动你通过 lh connect 接入的另一台机器。当项目位于另一台设备上时适用。

限制

仅桌面端 —— Codex 助理只在 LobeHub 桌面应用中可用，Web 端无法启动 CLI。
每台机器一次登录 —— Codex 与全局 CLI 共享认证。终端里 codex 能用，LobeHub 里就能用。
绑定工作目录 —— 会话不会跨文件夹或机器跟随你。

使用技巧

先在终端中运行一次 codex —— 登录在 CLI 层面完成，不在 LobeHub 里。
第一条消息前先选好工作目录 —— 之后切换会开启新会话。
多关注待办卡片 —— 这是了解 Codex 还剩什么任务的最快方式。
一个项目用一个 Codex 助理 —— 每个助理绑定一个仓库，会话更整洁也更容易恢复。