Skip to content

安装 Agent

Agent(code-agent)装在放代码、装了 Claude Code 的那台电脑上。它只向服务器保持一条出站连接——你的电脑不开放任何端口。

前提

这台机器必须已经装好并登录了 Claude Code。Agent 驱动的是你本地的 claude,自己不带任何凭证。

macOS

bash
curl -fsSL https://16co.de/install_agent.sh | sh

脚本会按芯片类型(Apple Silicon 或 Intel)下载对应的 .dmg,把 Code Agent.app 拷进 /Applications 并启动。菜单栏会出现一个新图标——那就是 Agent。

手动安装 .dmg?先看这个

应用没有经过 Apple 公证,首次双击会提示"无法打开,因为它来自身份不明的开发者"。两种解决办法:

  • 右键(或按住 Control 点击)应用 → 打开 → 在弹窗里再点 打开。只需一次。
  • 或:系统设置 → 隐私与安全性 → 拉到底部 → 仍要打开

用安装脚本则完全没有这个问题——它会替你清除隔离标记。

Linux

bash
curl -fsSL https://16co.de/install_agent.sh | sh
  • 以 root 运行 → 系统级安装 deb/rpm 包(/usr/bin/code-agent)。
  • 以普通用户运行 → 解包到 ~/.local/bin,配一个用户级 systemd 服务。不需要 root。

Linux 上 Agent 是无界面的,没有托盘图标。下一步的 code-setup 会完成登录并启用对应的服务(root 用系统服务,否则用 systemctl --user + lingering),保证开机自启。

Windows

在 PowerShell 里:

powershell
irm https://16co.de/install_agent.ps1 | iex

脚本会把 Agent 下载到 %LOCALAPPDATA%\16code,解压并启动。

验证

  • macOS:菜单栏图标出现,登录前显示"未登录"。
  • Linux~/.local/bin/code-agent(或 /usr/bin/code-agent)存在;服务在 code-setup 之后启动。
  • Windows:任务管理器里能看到 code-agent

接下来把它连到服务器:登录并绑定机器