生态与集成平台
GitHub 集成
在 Issue/PR 评论中 @mention /opencode 或 /oc,即在你的 GitHub Actions runner 内执行任务。
- 能力:Triage issue(解释问题)、Fix and implement(新建分支实现并开 PR)、代码在你自己的 runner 里跑,相对安全可控
- 安装:
opencode github install交互式安装 GitHub App + 生成 workflow + 配置 secrets;也可手动安装 github.com/apps/opencode-agent + 手写.github/workflows/opencode.yml - 核心 Action 配置项:
model(必填,provider/model)、agent(必须是 primary agent)、share(公开仓库默认 true)、prompt(自定义覆盖默认行为)、token(默认用 App 的 installation token,也可用 workflow 内置GITHUB_TOKEN或 PAT) - 支持的触发事件:
issue_comment、pull_request_review_comment(带精确文件/行号/diff 上下文)、issues(需prompt)、pull_request(无 prompt 时默认做 review)、schedule(定时任务,需prompt)、workflow_dispatch(手动触发,需prompt) - 典型用法:
/opencode explain this issue、/opencode fix this、PR 内联评论/oc add error handling here(自动带上文件路径/行号/diff)
GitLab 集成
两条路径,均运行在你自己的 GitLab runner 上:
- GitLab CI Component:社区维护的 nagyv/gitlab-opencode,
.gitlab-ci.yml里include该 component,认证 JSON 存为 Masked File 类型 CI 变量 - GitLab Duo(原生 Agent 平台):评论中
@opencode(可配置触发词),需配置 CI/CD + AI Provider Key + Service Account + Flow config;工作流程本质是在 CI 容器里装opencode-ai+glabCLI,用opencode run执行任务后自动 push 变更
两者与 GitHub 集成的能力对等:解释 issue、修复问题开 MR、review MR。
生态项目(社区,节选,完整名单见官方 ecosystem.mdx 或 awesome-opencode)
值得关注的插件类别
| 类别 | 示例 |
|---|---|
| 认证/计费替代 | opencode-openai-codex-auth(用 ChatGPT Plus/Pro 代替 API 额度)、opencode-gemini-auth、opencode-antigravity-auth |
| 沙箱/隔离执行 | opencode-daytona(Daytona 沙箱跑 session)、opencode-devcontainers、opencode-worktree(零摩擦 git worktree) |
| 上下文/性能优化 | opencode-dynamic-context-pruning、opencode-morph-fast-apply(10x 快速编辑) |
| 安全 | opencode-vibeguard(LLM 调用前脱敏 secrets/PII) |
| 通知 | opencode-notificator/opencode-notifier/opencode-notify |
| 记忆/持久化 | opencode-supermemory(跨 session 持久记忆) |
| 编排/工作流 | opencode-conductor(Context→Spec→Plan→Implement 协议化流程)、opencode-scheduler(launchd/systemd 定时任务)、opencode-workspace(多 Agent 编排捆绑包)、micode(Brainstorm→Plan→Implement) |
| Claude Code 兼容/对标 | oh-my-opencode(预置 LSP/AST/MCP 工具,声称 Claude Code 兼容)、opencode-background-agents(Claude Code 风格后台 Agent 异步委派) |
客户端/前端类项目
opencode.nvim(两个不同实现,Neovim 前端)、portal(移动端 Web UI,走 Tailscale/VPN)、OpenChamber(Web/Desktop/VS Code 扩展)、OpenCode-Obsidian(嵌入 Obsidian)、CodeNomad(Desktop/Web/Mobile/Remote 全端客户端)、kimaki(Discord bot 控制 OpenCode session,基于 SDK)、OpenWork(号称 Claude Cowork 的开源替代)。
生态活跃度高、社区自建工具数量大,是 OpenCode 相较 Claude Code 的明显差异点——插件/MCP 生态因开源+多 Provider 中立而更早形成第三方繁荣。
自定义工具的跨语言能力(补充说明)
自定义工具定义文件本身必须是 TS/JS(放 .opencode/tools/ 或全局目录),但可以调用任意语言编写的脚本(示例:TS 包装器调用 Python 脚本用 Bun.$ 执行)。文件名即工具名;一个文件可 export 多个 tool,命名规则为 <文件名>_<导出名>。若自定义工具与内置工具同名,自定义工具优先(如可完全替换 bash 工具);若只想禁用内置工具而不替换,应使用 permission 而非同名覆盖。
关联
- 索引 — 返回总索引
- 工具与集成 — 自定义工具/Plugin 的基础机制
- 对比Claude-Code — GitHub/GitLab 集成模式与 Claude Code 的 GitHub Action 对比
来源
https://opencode.ai/docs/{github,gitlab,ecosystem,custom-tools}.mdx(dev 分支,生态列表随时间持续增长,请以官方页面为准)。整理:赵卫国 2026-07-07。