Symbioza

Symbioza

**在 Claude Code 中使用云端 GPU 运行微调、评估和批量推理任务，并设置严格的支出上限。**你的 Agent 会准备任务、显示免费估算，并仅在你确认后提交。Symbioza 会选择机器、运行任务并返回生成的文件。你的费用绝不会超过所设的支出上限。

插件提供的功能

Symbioza 会在租用的云端机器上运行容器化 GPU 任务，并严格控制在美元支出上限内，同时收集可用的产物。Agent 通过一个 MCP 连接器提交镜像、命令和预算。Symbioza 会选择计算资源、运行任务，并分别报告输出交付情况和费用。恢复能力取决于任务策略、可用计算资源、剩余预算以及兼容的检查点支持。

• 托管的 MCP 服务：位于 https://symbioza.dev/mcp（可流式传输的 HTTP，通过 OAuth 登录，无需 API 密钥）。包含 九个工具：estimateExecution、submitJob、getStatus、inspectRun、getArtifact、listJobs、listSecrets、 describeDataset、cancelJob。
• **一个技能，/symbioza:run-on-symbioza。**它会告诉你的 Agent 何时适合使用 Symbioza、需要询问你哪些信息，以及从任务规格到文件的 四次调用：估算、提交、状态、产物。

Agent 可访问 https://symbioza.dev/agent，判断任务是否适用。

VS Code、GitHub Copilot 和其他 MCP 客户端

使用 Symbioza 无需安装插件：服务使用相同的远程 MCP 端点 https://symbioza.dev/mcp。任何支持远程 Streamable HTTP MCP 并可通过 OAuth 登录的客户端都能连接。如果客户端要求填写请求头或 API 密钥，请留空：客户端首次连接时，你会在浏览器中登录。

在 VS Code 中，从命令面板运行 MCP: Add Server，或将以下内容添加到 .vscode/mcp.json：

{
  "servers": {
    "symbioza": { "type": "http", "url": "https://symbioza.dev/mcp" }
  }
}

然后请求免费估算（第 4 步）。ChatGPT、Claude.ai 和其他客户端的设置说明： https://symbioza.dev/plugins

Cursor

二选一，不要同时使用，否则你的 Agent 会看到每个工具两次。

直接连接。 将服务添加到 ~/.cursor/mcp.json（适用于所有项目）或某个项目中的 .cursor/mcp.json， 并将其合并到已有的 mcpServers 块中：

{
  "mcpServers": {
    "symbioza": { "url": "https://symbioza.dev/mcp" }
  }
}

在侧边栏中打开 Customize，在 MCP 下启用 symbioza，然后在浏览器中完成登录。这样你的 Agent 就能使用这九个工具；但不会安装 run-on-symbioza 技能，也不需要在市场中上架。

安装插件。 将此仓库复制到 ~/.cursor/plugins/local/symbioza（必须实际复制：Cursor 会跳过指向此目录 之外位置的符号链接），然后重启 Cursor 或运行 Developer: Reload Window，再在 Customize 中确认 已列出 run-on-symbioza 技能和 symbioza MCP 服务。启用该服务并在浏览器中完成登录；使用 /run-on-symbioza 调用此技能。团队策略可能会阻止导入本地插件。 登录、使用、费用和测试清单：docs/cursor.md。

1. 安装

步骤 1 至 3 以及更新命令适用于 Claude Code。Cursor：请参阅上文。

claude plugin marketplace add symbioza/claude-plugin
claude plugin install symbioza@symbioza

或者在 Claude Code 会话中一次完成这两项操作（Claude Code v2.1.275 或更高版本）： /plugin install symbioza --marketplace symbioza/claude-plugin。已在 Claude Code 2.1.283 中测试。

在 shell 中安装完成后，会显示 Successfully installed plugin: symbioza@symbioza：启动新的 Claude Code 会话即可使用。在会话中安装后，Claude Code 会显示 Plugin is now active. 或 Run /reload-plugins to activate.（此时运行 /reload-plugins）。

2. 登录

连接器需要先登录一次，其工具才会显示。运行 /mcp，选择 plugin:symbioza:symbioza 并选择 Authenticate：浏览器将打开，你可以使用 Google、GitHub 或电子邮件地址登录。无需生成密钥，也无需发送密钥。

3. 检查连接状态

满足以下三项即表示已就绪：

• /mcp 将 plugin:symbioza:symbioza 列为已连接，并显示九个工具。
• 输入 / 时会显示 /symbioza:run-on-symbioza。
• claude plugin list 显示 symbioza@symbioza 已启用。

已经通过 claude mcp add 添加了连接器？请移除该副本（claude mcp remove symbioza），以免你的 Agent 看到每个工具两次。

4. 获取免费估算

粘贴以下内容，或运行 /symbioza:run-on-symbioza：

帮我为 Symbioza 准备这个 GPU 作业。询问容器镜像、命令、输入数据和预期输出文件。检查工作负载是否符合当前服务限制。向我展示免费估算和任何缺失信息，然后询问我的总支出限额。暂时不要提交作业。

估算无需支出限额。它会先给出可能的费用、费用范围、预计运行时长和估算置信度——这是尽力而为的估算，并非报价；如果没有任何作业信息可用于预测其运行时长，则会改为给出每小时运行费用，不提供总费用。随后会说明费用包含的内容、仍缺少的信息，以及你账户中的余额。选定支出限额后，系统会据此重新运行估算：限额是硬性上限，费用卡片会显示作业将在何处停止，以及你的余额是否足以支付。微调、评估和批量推理的示例配置： https://symbioza.dev/examples

5. 充值并提交

需要满足两个条件：拥有账户，并且账户中有余额。新账户可以连接、估算费用并查看自己的任务列表；提交时则会被拒绝，并提示“预付余额：可用 $0.00……请充值或降低预算。”，直到账户中有余额。请登录 https://symbioza.dev/app/topup 并使用银行卡充值。在 Symbioza 的限额内，可以充值任意整数美元金额；充值套餐只是快捷选项。如果估算结果显示余额不足以支付任务费用，系统会指出差额，Agent 也会提供预填差额的充值链接。打开结账页面不代表已充值：付款后，请重新获取估算结果。充值套餐和账单详情： https://symbioza.dev/pricing

确认估算结果无误后，请让 Agent 提交任务。在此之前，不会预订资源，也不会扣费。

6. 获取文件

请让 Agent 查询任务状态（getStatus）。任务运行完成后，请让它获取任务文件（getArtifact）：每个交付文件都会附带下载链接和可供验证的哈希值。链接将在 24 小时后失效；如需新链接，请再次请求。

Agent 会向你询问的信息

• 受支持的容器镜像。 Symbioza 会在自己的机器上运行经过验证的镜像（目前支持 PyTorch 和 TensorFlow 镜像）。任何其他镜像都会被拒绝，并显示当前支持的镜像列表，且不会预订资源或扣费。标准镜像不包含你的代码，因此命令必须从 URL 等位置获取脚本及其所需的其他内容。
• 运行任务的命令，即你在容器中会输入的命令。
• 机器可访问的输入：由机器自行下载的 URL，而不是你笔记本电脑上的文件。请使用有效期尽可能短、但足以完成暂存的签名链接。
• 输出文件，写入 /workspace/artifacts/。该目录中的内容会被取回；写入其他位置的内容不会被收集。
• 任务的总支出上限，以美元计。

凭据：保存为 Secret，切勿在聊天中提供

需要 Hugging Face 令牌、存储密钥或其他凭据的任务，必须从已保存的 Secret 获取凭据，不能从聊天中获取。Agent 会遵循以下规则：

绝不要求用户在聊天中粘贴 API 密钥、访问令牌、密码或云凭据，也绝不将其放入 env——env 用于非敏感配置。

请在 https://symbioza.dev/app/secrets 保存凭据，Agent 随后会按名称将其附加到任务（secrets）。Agent 可以通过 listSecrets 列出你已保存的集合，但只会返回名称和类型——保存后，任何页面、API 或工具都不会显示凭据值。如果任务需要你尚未保存的访问权限，Agent 会提供 Symbioza 设置链接；打开链接，在那里保存凭据，然后告知 Agent 已完成。

已保存的 Secret 的处理方式：Symbioza 会对其加密存储，任何页面、API 或工具都不会返回其值；附加该集合的任务会在其环境中接收明文值，而运行该任务的机器在技术上可以读取这些值；任务输出中与长度不少于 4 个字符的凭据值完全相同的内容，或与长度不少于 8 个字符的凭据值的 Base64 或 URL 编码形式完全相同的内容，都会在输出存储前替换为 [redacted]——这是精确匹配，不能保证以其他形式打印的值会被屏蔽；任务写入的文件会按原样交付，不会经过扫描或屏蔽；此前通过 env 传入凭据的任务，其已存储的任务规范仍会保留该凭据——保存 Secret 不会将其移除。

运行、文件和取消的工作方式

• 时间。 每次运行都有时间限制：由你在机器上的支出限额所能购买的时长，以及你设置的任何上限决定，但绝不会超过平台的 48 小时上限。预估会在你花费任何费用前显示该上限；作业预订的机器可能会提前结束运行。超过 48 小时的上限会在预估和提交时被拒绝。
• 文件。 请单独查看文件交付状态和运行状态。可用的输出文件带有下载链接和可供验证的哈希值。运行完成本身并不能确认文件已交付或最终账单已结算。下载链接会在 24 小时后过期；文件不会过期。
• 恢复。 是否重试或迁移到另一台机器，取决于作业策略、可用算力以及你的支出限额剩余金额。检查点恢复需要你的代码中有兼容的保存和恢复逻辑。运行可能会在未完成时停止。
• 取消。 取消会停止你的作业并释放其机器。如果确认已停止，你只需支付截至停止时测得的用时；如果无法联系到机器，则只计费到你提出请求的时刻为止，且绝不会超过你的支出限额。

费用

• 预估、状态检查和你自己的作业列表均免费。
• 已提交的作业使用预付额度。
• 失败或由你取消的作业，按其使用的机器时间计费，且绝不会超过你设置的支出限额。
• 你的支出限额是硬性上限：向你收取的费用绝不会超过该金额。预订机器前以及每次重试前都会检查此限额。完成后显示的费用可能会在账单对账期间发生变化。

隐私

作业在第三方算力上运行。作业的镜像、命令、数据集链接、环境变量和日志尾部内容会在 Symbioza 的服务器上处理，并可能被存储，因此请勿在其中放入机密信息：切勿在作业规范或其环境变量中填写凭据，也不要发送 SSH 私钥。凭据应保存在已保存的 Secrets 中，这些内容会加密存储，并且仅在作业运行时注入。请仅提交你有权使用的代码和数据。

隐私政策：https://symbioza.dev/privacy · 条款：https://symbioza.dev/terms

更新和卸载

这些命令用于更新现有安装；首次安装请参阅第 1 步。此市场默认关闭自动更新。更新方法：

claude plugin marketplace update symbioza
claude plugin update symbioza@symbioza

更新完成时会显示 Restart to apply changes.：重启 Claude Code 以加载新版本。

卸载方法：

claude plugin uninstall symbioza@symbioza
claude plugin marketplace remove symbioza

卸载插件不会取消你已提交的作业，也不会关闭你的 Symbioza 账户。请先取消正在运行的作业（让你的 Agent 调用 cancelJob），并通过 https://symbioza.dev/app 管理账户。

获取帮助

• 安装或使用插件时遇到问题： 在 https://github.com/symbioza/claude-plugin/issues 提交问题。发布前请删去敏感信息：切勿粘贴令牌、密钥、账户详情或私人作业数据。
• 账户、付款、隐私或安全问题： 使用联系表单 https://symbioza.dev/contact。
• 其他客户端（ChatGPT、Claude、任何远程 MCP 客户端）：https://symbioza.dev/plugins

变更和许可证

发行说明：CHANGELOG.md。MIT 许可证，详见 LICENSE。该许可证仅适用于此插件的文件。