OpenAgentsControl

环境要求

• OpenCode CLI（免费开源，安装脚本可自动安装）
• Bash 3.2+（macOS 默认即可）
• Git
• Windows 用户需使用 Git Bash 或 WSL

安装与启动步骤

1. 1检查环境依赖

   确认已具备 Bash 3.2+ 与 Git；可运行兼容性脚本自检（需已克隆仓库）。

   bash scripts/tests/test-compatibility.sh

   复制

2. 2一键安装

   官方一条命令安装 developer 配置，若本机没有 OpenCode CLI，安装器会自动装好。

   curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer

   复制

3. 3或交互式安装

   先下载安装脚本再运行，过程中可自行选择安装方式与全局/项目级安装。

   curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o install.sh
   bash install.sh

   复制

4. 4选择安装位置

   安装器会让你选：项目内 .opencode/ 便于随 git 共享给团队；~/.config/opencode/ 适合个人全局默认。

5. 5（可选）配置模型

   默认所有智能体沿用 OpenCode 默认模型；如需不同智能体用不同模型，直接编辑对应 md 文件。

   nano .opencode/agent/core/opencoder.md

   复制

6. 6（可选）全局配置模型

   全局安装时改为编辑用户目录下的同一文件，修改 frontmatter 里的 model 字段。

   nano ~/.config/opencode/agent/core/opencoder.md

   复制

7. 7查看可用模型

   可通过命令行列出所有可用模型，或在 models.dev 网站浏览后填入 frontmatter。

   opencode models

   复制

关键配置

如何确认成功

安装完成后在 OpenCode 中确认智能体已可用；可运行 opencode models 检查模型是否正确识别。

常见问题

注意事项

• 推荐按项目本地安装（.opencode/），模式可提交到 git 与团队共享。
• 全局安装（~/.config/opencode/）适合跨项目的个人默认配置。
• 不修改任何配置也能开箱使用，但加上自己的代码模式后收益最大。