LCU

LCU 是一套把 Codex Computer Use 能力和 Codex 应用本身解耦的工具。它可以将 Codex 原生的电脑操作运行时暴露给你自己的智能体框架（harness），不再需要 Codex 账号认证。

前提依然需要本地安装官方 ChatGPT 桌面客户端：ChatGPT桌面应用负责底层运行时与基础指令，LCU 负责环境配置、权限管理以及和你的智能体框架集成。

快速开始

直接发给你的AI智能体执行：

使用最新发布为此 harness 安装和配置 LCU。
遵循 https://raw.githubusercontent.com/amontlabs/lcu/main/docs/INSTALLATION.md
检查我的操作系统、架构和先决条件，然后指导我完成任何必需的权限。

核心功能

• 桌面操控：读取窗口信息、鼠标点击、键盘输入、屏幕截图
• Chrome浏览器控制（可选开启）：依托官方扩展读取/操作标签页，网站访问需要单独审批
• 多智能体框架适配：内置适配器支持 Pi、Codex CLI、Claude Code；实验性支持 Oh My Pi、Hermes

系统前置要求

必须预先安装：官方 ChatGPT 桌面应用、Python3.12+，以及你要使用的智能体harness。

使用Codex CLI的用户，需要提前更新CLI版本，保证hook支持。

⚠️ Windows11 x64 仍为候选支持；Intel Mac、原生Wayland、musl Linux暂不支持。

手动安装流程

从项目Release下载对应压缩包与sha256校验文件：

• Apple Silicon macOS：lcu-<version>-darwin-arm64.tar.gz
• Linux ARM64：lcu-<version>-linux-arm64.tar.gz
• Linux x86-64：lcu-<version>-linux-x64.tar.gz

按文档校验哈希、解压，在harness中注册LCU。配置界面提供智能体选择器，引导桌面权限设置。Chrome控制、电脑音频录制均为可选，需要手动开启。
开发者可阅读文档从源码编译。

开启Chrome浏览器控制

发给智能体的指令模板：

使用安装指南在我的 LCU 设置中启用 Chrome 控制：
https://raw.githubusercontent.com/amontlabs/lcu/main/docs/INSTALLATION.md#desktop-and-browser

在Chrome配置文件安装官方扩展，重启harness。之后可调用LCU列出浏览器标签页；访问网站仍需人工批准。

提示：Claude Code的Chrome支持属于实验功能，部分异常场景不会自动清理标签页，存在适配器限制。

开启电脑音频录制

setup命令增加--audio参数：

~/.local/share/lcu/current/bin/lcu setup --agent pi --audio

LCU不会自动添加到系统PATH，Linux下默认路径：/opt/lcu/current/bin/lcu。
开启后调用底层运行时的音频录制API，LCU本身不额外处理音频指令；录音文件不会直接送入模型。音频功能属于可选加入项。

Pi交互专用指令

在Pi交互环境内：

• /lcu stop：在LCU任务运行中，触发原生Computer Use停止指令（仅macOS）
• /lcu pick：选择目标窗口/浏览器标签，附加到草稿，等待人工审阅提交

核心要点

1. 核心定位：LCU剥离Codex应用绑定，复用本地ChatGPT桌面App的Computer Use运行时，自定义智能体无需Codex认证。
2. 能力范围：桌面键鼠/截图 + 可选Chrome标签操控，支持音频录制。
3. 适配框架：Pi、Codex CLI、Claude Code；支持Apple Silicon Mac、X11 Linux；Windows尚在候选，Intel Mac/Wayland不支持。
4. 安全机制：屏幕录制、辅助权限、网站访问都需要人工审批。
5. 限制：音频录制文件不会直接喂给模型；Claude Code浏览器能力为实验版本。