---
title: Codex
description: 在 LobeHub 中委派 OpenAI Codex —— 通过桌面应用与 Codex CLI 对话，实时查看文件变更、待办与命令输出，并跨轮次恢复会话。
tags:
  - LobeHub
  - Codex
  - 编程助理
  - 桌面端
  - CLI
  - OpenAI
---

# 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 安装指南](https://github.com/openai/codex#installing-and-running-codex-cli)。

若 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 助理** —— 每个助理绑定一个仓库，会话更整洁也更容易恢复。

<Cards>
  <Card href={'/zh/docs/usage/agent/claude-code'} title={'Claude Code'} />

  <Card href={'/zh/docs/usage/agent/agent-team'} title={'群组'} />

  <Card href={'/zh/docs/usage/agent/sandbox'} title={'云沙箱'} />
</Cards>
