快速上手
安装 LinkCode 桌面应用,从源码运行 host(即 LinkCode daemon),并用 Claude Code、Codex、OpenCode 或 Pi 启动你的第一个线程。
host 暂无安装包
桌面应用是打包好的下载包,但它连接的 host 不是——目前没有安装程序、安装包,也没有随附的副本。本指南改为从源码运行它,大约需要 15 分钟,并需要 git、Node.js 和 pnpm。打包版 host 正在开发中。
开始之前
- 支持的操作系统:桌面应用支持 macOS 或 Windows。Linux 支持正在开发中。
- 一个你能完成认证的智能体:可以是已在本机通过
claudeCLI 登录的 Claude 账户,或一个 Anthropic API key。API key 这条路径目前需要额外设置——见设置。 - 可选——拉取请求状态:如果你想让拉取请求状态显示在 Git 面板中,请安装并登录 GitHub CLI(
gh auth login)。 - 可选——OpenCode:LinkCode 不随附 OpenCode CLI。如果你打算使用它,请自行安装
opencode,让它位于 host 运行时所用的同一个PATH上——见 OpenCode。
设置
安装桌面应用
从 GitHub releases 页面 下载适用于你平台的构建版本并安装。先别启动它——在 host 运行起来之前,它没有可连接的对象。
克隆仓库并安装依赖
host 作为 LinkCode 源码仓库的一部分发布。你需要 git、Node.js 24 或更新版本,以及 pnpm 11。
git clone https://github.com/arcboxlabs/linkcode.git
cd linkcode
pnpm install启动 host 并保持运行
可选:启用应用内终端
除非你需要 Terminal 面板,否则可以跳过这步。在 apps/daemon 目录下运行一次 pnpm run build:rust(需要带 cargo 的稳定版 Rust 工具链)——它会构建 host 打开终端所需的 sidecar。LinkCode 的其余功能没有它也能正常工作。
cd apps/daemon
pnpm run dev让它在自己的终端里保持运行——它就是桌面应用要通信的进程。成功启动后会打印出类似这样的一行:
[linkcode/daemon] listening on http://127.0.0.1:19523 (socket.io)启动桌面应用
打开你在第 1 步安装的应用。它会通过读取 ~/.linkcode/runtime.json 自动发现正在运行的 host,因此你应该无需做任何配置。如果它找不到 host,或者你要指向另一台机器上的 host,请在 Settings → Connection 下显式设置 URL。
桌面应用已连接到本地 host:侧边栏显示 Chats 栏目和一个 New Task 按钮
Screenshot coming soon
/images/docs/quickstart-connected.png如果你看到的是「Unable to connect to the host」错误,请参见疑难排查。
启动你的第一个线程
挑选一个智能体(从 Claude Code 开始——它无需单独安装),选择一个工作文件夹,或者如果你只想聊天而不关联某个项目,就选择 Chats。在 composer(线程底部的输入框)里输入你的提示词并发送。
如果你选的是 Claude Code,注意它工作时弹出的权限提示——它们会固定显示在 composer 上方,在做任何尚未获得许可的事情之前,它会等待你的回答。并非每个智能体都会先征询;各智能体如何处理审批,见智能体对比。
用 Claude Code 开启的第一个线程:智能体正在处理一条提示词,一个权限请求固定显示在 composer 上方
Screenshot coming soon
/images/docs/quickstart-first-thread.png