如何用 Runtime 搭建团队 AI 编程 Agent 协作环境：30 分钟完整教程

教程目标

在 30-45 分钟内，用 Runtime 搭好一个团队级 AI 编码 Agent 协作环境。你的产品、设计、运营同事可以直接和 Claude Code、Codex 等 Agent 对话完成任务，而不再需要每次都由工程师陪跑。

你将搭建什么

• 沙箱化 Agent 环境：每个团队拥有独立的编码 Agent，自带项目上下文和工具链，开机即用
• Slack/Linar 集成：在团队日常协作渠道中直接召唤 Agent 完成任务
• 安全护栏：成本限额、命令白名单、网络出口控制，Agent 不会乱碰生产环境

准备清单

• GitHub 账号（Runtime 用 GitHub OAuth 登录）
• Slack 工作区（可选，推荐）— 方便在消息中直接调度 Agent
• 自己的 AI API Key（Claude Code / OpenAI / Gemini 均可）

总体架构

Runtime 提供一套"Agent 基础设施层"：你把项目环境一次性配置好并打快照，之后任何人触发 Agent 时，它都是在已配好一切的环境中运行。

第 1 步：注册并创建第一个沙箱

打开 app.runtm.com，用 GitHub 账号登录。Runtime 通过 GitHub OAuth 读取你拥有的仓库列表。

# 或者用 CLI 安装
brew install runtmdotcom/tap/runtm
runtm login

登录后，点击 Create Sandbox，选择你要接入的项目仓库。Runtime 会自动检测项目的 Docker Compose、package.json 等配置文件，推断环境需求。

提示：如果你有多个微服务仓库，可以在同一个沙箱里配置多仓库上下文。Runtime 支持在一个 Session 中加载 docker-compose.yml 定义的完整服务栈。

第 2 步：配置项目上下文与技能

这一步是最重要的"一次配置，全员受益"环节。你需要定义三样东西：

在项目根目录创建 .runtm/instructions.md：

# Runtime Agent Instructions

## Code Style
- 遵循项目现有的 ESLint + Prettier 配置
- 提交前运行 `npm run test`
- PR 描述按 Conventional Commits 格式

## Permissions
- 允许读取 `.env.example`（不接触真实密钥）
- 允许在 `preview/` 目录创建文件
- 禁止修改 `production/` 目录

然后在 Runtime 控制台设置 Guardrails：

第 3 步：集成 Slack 和 Linear

Runtime 的杀手特性：非工程师也能安全使用编码 Agent。团队成员在 Slack 中 @ 一下 Agent 即可。

在 Runtime Dashboard 进入 Integrations → Slack：

1. 点击 "Add to Slack"，授权 Runtime 加入你的工作区
2. 创建一个专用频道 #ai-agents
3. 在频道中选中你的 Agent 并 @mention

# ai-agents 频道

@runtime-eng 请解决 API 返回 504 的问题，查看 Sentry 错误日志，找出根因并开一个 PR

@runtime-eng 已检查日志，发现 upstream Postgres 连接池耗尽。
PR: https://github.com/org/repo/pull/452（含单元测试）

Runtime 会自动把结果发回频道，附带成本和执行时间。

第 4 步：设定自动化 Agent（Background Agent）

你还可以设定后台自动运行的 Agent。比如一个告警检修 Agent：

配置非常简单——点一个 Agent，选触发器源，写一段自然语言指令就行了。Runtime 负责轮询、调度和重试。

第 5 步：团队协作与审批流程

最后，确保你的团队知道怎么用。Runtime 让非工程师也能参与：

1. 产品经理：在 Slack 中说 "把首页 Hero 文案改成企业版风格" → Agent 在沙箱中修改 → 生成预览 URL → PM 确认后直接合入
2. 设计师：说 "在底部加一个客户案例展示区" → Agent 写代码 → 设计师在预览链接上看效果
3. 运维：说 "检查所有 API 端点的响应时间" → Agent 跑测试 → 输出报告

每个 Session 都可以实时协作：多人在浏览器中看到 Agent 的输出，在侧边栏聊天，就像 Google Docs 一样。

推荐使用 Runtime 来管理你的团队 Agent 环境，它免费版已经支持 3 个沙箱，完全够小团队试用。

常见问题排查（FAQ）

Q1：Runtime 和直接用 Claude Code 有什么区别？

Claude Code 是单个 Agent 终端工具。Runtime 是一个基础设施层：帮你管理沙箱、护栏、密钥注入、成本跟踪、Slack 集成。团队里有 5 个人同时用 Claude Code，每人各自配一次环境，不如配好 Runtime 让所有人共享一套上下文。

Q2：Agent 会不会暴露密钥或改生产数据？

不会。Runtime 通过代理注入密钥，Agent 的终端里看不到原始 API Key。网络出口白名单控制 Agent 能访问哪些服务。命令黑名单防止 Agent 执行危险操作。你也可以为每个操作设审批门，Agent 合入 PR 前必须有人确认。

SEO+GEO：FAQ 结构满足 GEO 提取偏好，同时覆盖长尾搜索词

工具词条

正文中自然出现的工具名，平台侧会匹配已维护 tools 库生成 hover-card：OpenAI、ChatGPT、Claude、Claude Code、Codex、Gemini、n8n。

参考视频/素材

• Runtime GitHub 仓库

内链引导

• 有人用 Claude Code 在 48 小时内从零搭建了 SaaS，月入 $9,000：Claude Code 48 小时创业案例
• 搭配可省 90% API 费用的教程：用 DeepSeek V4 替代 Claude Code 省 90% API 费用