自带智能体

代理与运行时¶

代理将名称、说明、默认模型和运行时组合在一起。

运行时是为其提供支持的底层框架：Macro AI、内置编码框架，或运行在你自己机器上的代理，比如你自己的 Claude Code。

可在 设置 → 常规 → 代理 中管理两者。在 运行时 中连接你的机器，然后在 代理 中创建使用该运行时的代理。

在 Macro 桌面应用上¶

桌面应用内置了 macrod，因此无需下载任何内容。打开 设置 → 常规 → 代理 → 运行时，使用 此计算机 卡片：设置 会检测你机器上安装的编码代理，你选择一个代理和一个工作区文件夹，然后 开始在此处运行代理 会自动配置、配对并启动运行时——无需终端，也无需配对码。在代理运行期间请保持应用打开。

下面的手动 macrod 步骤适用于没有桌面应用的机器（服务器、另一台计算机），并且两种运行时都可以配对到同一个账户。

Macro 守护进程¶

通过 Macro 使用你的本地编码代理。macrod 运行在你的计算机上，将你的代理连接到 Macro，并保持其会话可从你的工作区访问。

在你的计算机或服务器上运行 Macro 守护进程（macrod）。

开始之前¶

你需要一台能够保持在线且运行 macOS、Linux 或 Windows 的计算机，以及一个已安装且已认证的编码代理。macrod 可识别 Claude Code、Codex、OpenCode、OpenClaw 和 Hermes。你也可以为 Agent Client Protocol (ACP) 代理配置自定义命令。

macrod 会主动连接到 Macro。你不需要公共 webhook 端点、端口转发或 HTTPS 隧道。

连接你的运行时¶

1. 安装 macrod

在终端中为你的计算机运行安装命令：

curl -fsSL https://raw.githubusercontent.com/macro-inc/macro/main/crates/coding_agent_worker/install/install.sh | sh

irm https://raw.githubusercontent.com/macro-inc/macro/main/crates/coding_agent_worker/install/install.ps1 | iex

2. 运行 macrod

在 `macrod` 应保存其配置的文件夹中打开终端，然后运行：

```bash
macrod
```

在使用运行时期间请保持终端打开。

首次启动时，**快速开始** 会列出你机器上可用的代理。选择一个代理，或选择 **自定义命令** 以输入 ACP 启动命令。

将 **工作区** 设置为你的代理应工作的目录。选择 **私有** 以创建只有你能启动的运行时，或选择 **团队** 让队友可以使用你的代理。如果运行团队模式，任何人都可以在你的计算机上创建代理会话。默认情况下，系统会根据你运行的框架弹出权限请求，例如访问工作区之外的文件；如果你启用 **完全访问**，这些提示将自动获得批准。

在生成配对码之前，配置你的代理、工作区和访问权限。

选择 **创建并配对** 以生成你的设备代码。

3. 输入你的配对码

**配对 macrod** 面板会显示一个设备代码和一个指向 Macro 的链接。如果你已在终端概览中，按 <kbd>p</kbd> 打开配对。按 <kbd>c</kbd> 复制代码。

打开配对链接，或前往 **设置 → 运行时 → 新建运行时**。输入你的代码并点击 **查找**。

仅为示例——请输入来自你自己的 macrod 终端的代码。

确认代码和计算机与你的终端匹配。查看运行时名称、**私有** 或 **团队** 访问权限以及权限，然后点击 **批准**。

批准后，`macrod` 会自动连接。它会在你启动它的目录中的 `macrod.toml` 中保存配置和凭据。请将此文件保密；不要将其提交到仓库。

创建使用你的运行时的代理¶

返回 代理 选项卡，点击 新建代理。为你的代理指定名称和说明，在 运行时 下选择已连接的机器，并选择一个默认模型。

检查共享和频道访问权限，然后保存代理。在它可以访问的频道中 @提及它，即可在你的机器上启动会话。

保持你的运行时连接¶

在使用运行时期间，让 macrod 保持运行并让计算机保持唤醒。其终端会显示你的会话、配置和日志。你也可以在 设置 → 运行时 中查看运行时。

之后要重新连接，请从同一目录运行 macrod，以便加载已保存的配置。如果你撤销了运行时，请在使用前重新配对。

更新 macrod¶

再次运行安装命令。它会将 macrod 替换为最新版本，并保留你的 macrod.toml。正在运行的 macrod 会一直保留旧版本，直到你重启它。

如需安装特定版本，请在运行安装命令之前，将 MACROD_VERSION 环境变量设置为其标签，例如 v2026.10.18.0。

故障排除¶

• 你的代理未出现在 Quickstart 中： 请检查它是否已安装，并且其命令在启动 macrod 的终端中可用。如需使用其他 ACP 代理，请使用 自定义命令。
• 你的代码无效或已过期： 从终端开始新的配对，并输入新代码。截图中的代码仅供示例。
• 你的运行时处于离线状态： 请检查电脑是否处于唤醒状态、macrod 是否正在运行，以及它能否连接到 Macro。查看终端的 日志 选项卡以了解错误。

要了解有关在工作区中使用代理的更多信息，请参阅 代理。