lfg：把AI编程代理变成你的私有远程控制台

lfg是什么

lfg 是一套把 AI 编程代理运行在本机上的控制工具。它支持在 Linux 盒子或 macOS 工作站上启动 Claude Code、Codex、opencode 等代理，并通过网页界面远程查看、接管和继续任务。

简单说，它把“本地跑代码”和“远程看进度”连在了一起。开发者不必一直守在电脑前，也能从手机或笔记本上查看会话状态、回复提示、切换项目。

lfg的核心特点

lfg 的设计重点很清晰：让 AI 编程代理尽量贴近代码所在环境，同时保持控制方式足够灵活。

• 私有控制面板：会话默认运行在本机，控制更集中，适合个人开发环境。
• 真实会话流：每个代理都在长期存在的 tmux 会话中运行，方便持续跟踪。
• PWA网页控制：网页端可直接打开、安装、继续使用，移动端体验也比较顺手。
• 多代理支持：可接入 Claude Code、Codex、opencode，便于按习惯选择工具。
• Tailscale内网访问：默认更偏向内网私用，而不是直接暴露到公网。
• 仓库自动检查：支持基于 markdown 的检查代理，自动收集仓库、Git、模型或安全上下文。

适合哪些人用

lfg 更适合下面几类场景：

• 本地有代码仓库，希望 AI 直接在自己的环境里运行。
• 经常需要在外面查看代理输出，或者临时回复权限提示。
• 想把多个 AI 编程工具统一到一个入口管理。
• 希望保留本机凭据、CLI 和工作流，不想迁移到纯云端环境。

安装和快速启动

lfg 的上手方式比较直接。官方推荐在 Ubuntu/Debian VPS 或 macOS 工作站上执行安装脚本。

curl -fsSL https://raw.githubusercontent.com/BennyKok/lfg/main/scripts/setup.sh | bash

如果需要无交互方式接入 Tailscale，也可以在执行时带上授权密钥：

curl -fsSL https://raw.githubusercontent.com/BennyKok/lfg/main/scripts/setup.sh \n  | TS_AUTHKEY=tskey-auth-xxxx bash

安装过程会自动完成几个关键动作：

• 下载最新发布版本。
• 安装生产依赖。
• 写入 .env 配置。
• 以用户服务方式启动服务。
• 在可用时配置 tailscale serve。

本地开发怎么跑

如果想先在本机试用，可以直接按开发模式启动。流程也很简单：

git clone https://github.com/BennyKok/lfg.git
cd lfg
bun install
cp .env.example .env
bun run serve

启动后打开 http://127.0.0.1:8766 即可。随后再完成对应代理的认证，比如运行一次 claude 完成授权，或者在 .env 中配置需要的 API key。

常用命令与配置

lfg 提供的命令比较聚焦，主要围绕服务、代理、辅助功能展开。

• bun run serve：启动网页 UI 和控制服务。
• bun run agents -- list：查看 markdown 定义的代理。
• bun run agents -- run <name>：运行某个检查代理。
• bun run whatsapp -- run：启动可选的 WhatsApp sidecar。
• bun run setup：重新执行安装或更新流程。

配置主要集中在 .env 中，常见项包括：

• LFG_HOST：绑定地址，默认建议保持 127.0.0.1。
• LFG_PORT：端口，默认是 8766。
• LFG_REPOS_ROOT：扫描仓库的目录。
• LFG_CLAUDE_PATH、LFG_CODEX_PATH、LFG_OPENCODE_PATH：代理二进制路径覆盖。
• ANTHROPIC_API_KEY：可选的 Claude 相关 API key。

安全性要特别注意

lfg 运行的是带 shell 权限的 AI 代理，这意味着它能直接操作你的机器和仓库。所以它的默认设计是面向本机或私有网络使用，而不是公开互联网。

比较稳妥的做法是：

• 保持监听在本地回环地址。
• 通过 Tailscale 之类的私有网络远程访问。
• 不要把控制端直接暴露到公网。
• 共享前先认真阅读安全说明，确认权限边界。

为什么它值得关注

很多 AI 编程工具的问题，不是能力不够，而是“运行环境”和“控制方式”割裂。lfg 的思路很实用：让代理留在代码所在机器上执行，再用一个清晰的网页控制台把结果和交互整理出来。

这样做的好处很直接：上下文更完整、权限更可控、切换设备更方便。对于经常需要远程跟进代码任务的人来说，lfg 提供了一种更接近真实工作流的方案。

总结

如果你正在寻找一个能把 AI 编程代理、本地仓库、tmux 会话和网页控制统一起来的工具，lfg 是一个很有特色的选择。它适合想保留本地开发环境、又希望随时远程接管任务的用户。

一句话概括：lfg 不是单纯的 AI 工具，而是一个面向私有开发场景的远程控制台。