在 Linux 上安装

一条命令安装，一条命令检查，一条命令接上你的 agent。

在 Linux 上不需要单独构建安装程序。命令行工具直接发布在 PyPI 上，安装就是一条命令的事。这篇假设你对终端操作比较熟悉。

1. 安装

sudo apt install -y pipx   # 如果还没有 pipx，先装一下
pipx install andon-light

不需要克隆项目仓库。这条命令直接安装已发布的包。

2. 检查是否成功

andon-light doctor

确认工具真的能找到你的设备。如果提示权限错误，需要把你的用户账号加入 dialout 用户组。具体步骤参见故障排查页面的 Linux 专属说明。

3. 接上你用的 agent

andon-light install-hooks                 # Claude Code
andon-light install-hooks --agent codex   # Codex CLI

不管哪一个，在做任何改动之前都会先完整展示即将写入的内容，并等你确认。你可以选择应用范围是全局还是单个项目。具体设置了什么、为什么这么设计，参见 Claude Code Hook 集成或 Codex CLI Hook 集成。如果你用的是 Codex CLI，hook 要真正生效还需要多一步，参见运行前先信任它。