文档

快速上手

安装 LinkCode 桌面应用,从源码运行 host(即 LinkCode daemon),并用 Claude Code、Codex、OpenCode 或 Pi 启动你的第一个线程。

host 暂无安装包

桌面应用是打包好的下载包,但它连接的 host 不是——目前没有安装程序、安装包,也没有随附的副本。本指南改为从源码运行它,大约需要 15 分钟,并需要 git、Node.js 和 pnpm。打包版 host 正在开发中。

开始之前

  • 支持的操作系统:桌面应用支持 macOS 或 Windows。Linux 支持正在开发中。
  • 一个你能完成认证的智能体:可以是已在本机通过 claude CLI 登录的 Claude 账户,或一个 Anthropic API key。API key 这条路径目前需要额外设置——见设置
  • 可选——拉取请求状态:如果你想让拉取请求状态显示在 Git 面板中,请安装并登录 GitHub CLIgh 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

后续步骤

本页目录