第2章 Cursor 宏观指南:连接 Cursor 云代理至 Macro
连接 Cursor,让您的编程代理作为 Cursor 云代理运行在您自己的 Cursor 套餐上。您在 Macro 中启动并跟进会话,实际工作在 Cursor Cloud 中执行,并实时流式传输到 Macro 的会话中。
连接 Cursor 在 Cursor 中创建 API key在 Cursor 控制台中,打开 API & SSH Keys,点击 New API Key。粘贴到 Macro 中打开 Settings → Machines,选择 Cursor 并粘贴 key。Macro 会加密存储,且仅用于启动和跟进您的 Cursor 会话。选择默认模型新建的 Cursor 代理将以该模型启动,之后可按代理单独修改。 要移除连接,在同一页面点击 Disconnect。这会删除 Macro 存储的 key 副本;如果不再需要,请到 Cursor 控制台撤销该 key。
运行 Cursor 代理 在 Settings → Agents 中创建(或编辑)一个代理,将其运行位置设为 In Cursor。然后:
在 Agents 中,切换到 Code,选择该代理,挑选代码库和分支,发送您的 prompt。 在频道中 @提及 该代理。会话会在该话题线程中打开,后续在该线程中的提及都会发往同一会话。
会话需要两侧都能访问其代码库。Macro 会列出您的 GitHub 连接覆盖的代码库,同时 Cursor 也需要为该代码库连接 source control。任一侧单独连接不会自动连通另一侧,因此任何一侧缺失的代码库都无法启动会话。
每个会话与 Macro 中其他编程会话一样:您可以查看其进度、工具调用和关联的 pull request,并发送后续指令或停止它。
在 Cursor 中查看 Macro 的会话 Macro 启动的会话是您 Cursor 账户上的常规云代理,因此可以从 Cursor Web 或 Cursor agents 窗口打开。在那里发送的后续指令也会同步显示在 Macro 会话中。 Cursor 默认会在代理列表中隐藏通过其 API 启动的代理,Macro 启动的所有会话都在此列。如果不想逐个从 Macro 打开查看,可以这样列出它们: 在 Cursor 中打开您的代理列表访问 cursor.com/agents,或在 Cursor 中打开 agents 窗口。按来源筛选点击 Filter,选择 Source,再选 API。选择来源会覆盖 Cursor 的默认设置,Macro 启动的会话就会出现在列表中。