编码智能体
Pi
LinkCode 如何运行 Pi,包括其提供商认证模型、其上游的无沙箱设计,以及为何已停止的线程无法恢复。
Pi 随 LinkCode 的 host(即 LinkCode daemon)一起内置,并在进程内运行——没有单独的二进制文件,没有子进程,无需安装。
登录
LinkCode 自身没有针对 Pi 的登录流程。Pi 会自行为大约二十多家提供商解析凭证,通过它自己的认证文件(~/.pi/agent/auth.json)或环境变量——无论你为想要使用的提供商已经配置好了哪一种,Pi 都会自动采用。
你也可以在设置 → 智能体中为所选模型的提供商设置 API 密钥。LinkCode 仅对该线程将其作为运行时覆盖来应用,优先级高于 Pi 自己的认证文件和环境变量——它绝不会写入磁盘。
无沙箱,出于设计
Pi 没有权限提示,也没有沙箱。这是上游 Pi 自己的设计,而非 LinkCode 的缺陷。Pi 自己的安全文档指出,它「以启动它的用户账户的权限」运行,并且「真正的隔离需要来自操作系统或虚拟化/容器边界」。LinkCode 中的每个 Pi 线程都会完全自主地执行工具。对于不受信任的仓库或无人值守的工作,请在容器或虚拟机中运行它,而不是针对真实的检出。
模型
Pi 在 LinkCode 中没有精选模型列表。在设置 → 智能体中以自由文本、按 provider/model-id 形式(例如 anthropic/claude-sonnet-5)设置一个。如果你不设置,Pi 会使用它可用的第一个模型。没有实时模型切换,也没有推理强度控制。
线程历史
已停止的 Pi 线程无法恢复。一旦线程发送过至少一次提示,尝试恢复它就会失败——如果你需要继续对话,请启动一个新线程。