快速开始
Alpha 测试
Lody 目前处于 Alpha 测试阶段。Alpha 测试结束后，测试期间的所有用户数据将被清空。
桌面端方式
- 在下载页选择你的电脑平台对应的安装包，进行下载和安装
- 启动时会跳转至浏览器进行账号的注册和登录
- 桌面端启动时将自动启动 Lody 的 CLI 进程，界面最下方将显示对应的实时输出
- 你可以关联 GitHub 仓库到 Lody
- 或者直接点击我的项目进行本地工作目录的添加
登录方式
登录页支持四种身份提供方：
- GitHub
- Apple
- Discord
选择任何一种都可以。即使你用 Google、Apple 或 Discord 登录，依旧可以在 设置 → GitHub 单独关联 GitHub 仓库。
无头环境（CI runner、远程服务器、容器等）可以用 CLI Token 完成登录：lody login --auth <token> 或 lody start --auth <token>，详见 非交互式登录 --auth。
CLI 方式启动
前置条件
- Node.js 18 或更高版本
- 已安装并配置 Git
- 安装 GitHub CLI
- macOS:
brew install gh - Linux: 安装说明
- macOS:
网络环境要求
CLI 需要能够访问以下服务：
- 你的 Coding Agent（Claude Code / Codex）
- GitHub（用于 clone 仓库）
- npm registry
启动
bash
# 推荐：后台运行
npx lody daemon start
# 临时前台调试
npx lody startnpx lody daemon start 会在后台启动 Lody CLI，并在异常退出后自动恢复。CLI 会检测你当前机器上已安装的 Claude Code 和 Codex，并为其自动关联默认的 Agent Config，以便在对话界面可以选择对应的 CLI 类型。
如果你想直接看到实时日志，或临时排查启动问题，可以使用 npx lody start 在当前终端前台运行。
关联你的 GitHub 仓库
在 web 端的左下角点击 设置 → GitHub 集成 → 管理 按钮进行 GitHub 仓库的集成授权。完成后你将重定向回 Lody 将需要的仓库添加到 workspace 中来选择。更多说明
文件位置
| 内容 | 路径 |
|---|---|
| 仓库目录 | ~/.lody/repos |
| 日志文件 | ~/.lody/logs |
下一步
🎉 你已经完成了所有的基础配置，接下来可以了解更多 Lody 的功能