OpenCode
bun add -g opencode-ai
bun全局安装在不同版本表现不一致,有时候会安装到~/.bun/bin有时候会安装到~/.cache/.bun/bin,建议手动设置$BUN_INSTALL。
全局配置 ~/.config/opencode/opencode.json 示例:
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@slkiser/opencode-quota"],
"agent": {
"general": {
"mode": "subagent",
"model": "openai/gpt-5.3-codex"
},
"explore": {
"mode": "subagent",
"model": "openai/gpt-5.1-codex-mini"
}
},
"mcp": {
"exa": {
"type": "remote",
"url": "https://mcp.exa.ai/mcp",
"enabled": true
},
"grep_app": {
"type": "remote",
"url": "https://mcp.grep.app",
"enabled": true
},
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}",
"Accept": "application/json, text/event-stream"
},
"enabled": true
},
"shadcn": {
"type": "local",
"command": [ "bunx", "shadcn@latest", "mcp" ],
"enabled": true
},
"nixos": {
"type": "local",
"command": [ "uvx", "mcp-nixos" ],
"enabled": true
}
}
}
agent部分没有配置主代理plan和build,这两个可以在tui里面自行切换,因此不太需要配置。 项目配置可以放在根目录的opencode.json中,会自动和全局配置合并。
Skills
可以通过 skills.sh 查询可用技能。
我在用的有:
bunx skills add vercel-labs/agent-skills
bunx skills add vercel-labs/agent-browser
bunx skills add supabase/agent-skills
bunx skills add anthropics/skills
bunx skills add nextlevelbuilder/ui-ux-pro-max-skill
另外,对于 superpowers 这类自带skill的插件,可以直接通过官方推荐的方式安装:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
MCP
可以通过 servers 项目查询可用MCP。
自用的一些:
- Exa: 实时网络搜索、代码搜索等
- grep_app: 直接搜索并提取 GitHub 仓库中的代码片段、模式或正则匹配结果
- Context7: 获取最新文档和代码示例
- ChromeDevTools: 相当于让 AI 可以使用 F12 开发者工具
- Supabase: 提供 PostgreSQL 数据库/向量数据库和鉴权服务,后端一条龙
- Shadcn: 浏览和搜索 shadcn/ui 的所有组件、blocks 和 templates
- NixOS: 提供“真实 NixOS 数据”,让模型查询官方包和配置,避免胡编乱造
其他工具
- AgentBrowser: 轻量级浏览器自动化工具,比较省 token
插件
bunx oh-my-opencode install --no-tui --claude=no --gemini=no --copilot=no
配置可以参考 opencodedocs。配置模型的时候可以通过 models.dev 查询供应商和模型 ID。这里提供一个 oh-my-opencode.jsonc 示例。不过自己体验下来 oh-my-opencode 在模型能力很强的情况下反而会起到副作用,是否启用见仁见智吧。
{
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
"agents": {
"sisyphus": {
// 主编排器:主动委托任务、调用其他代理协作
"model": "openai/gpt-5.3-codex"
},
"atlas": {
// 主控编排器:负责全生命周期管理(适合复杂长任务)
"model": "openai/gpt-5.3-codex"
},
"oracle": {
// 咨询/调试专家:复杂拆解、代码审查、架构建议
"model": "openai/gpt-5.3-codex"
},
"librarian": {
// 文档检索专家:文档搜索、依赖查找、资料整理
"model": "opencode/big-pickle"
},
"explore": {
// 快速探索代理:grep 扫项目结构、定位线索
"model": "opencode/gpt-5-nano"
},
"multimodal-looker": {
// 多模态分析代理:处理图片/PDF/视频输入
"model": "zhipuai-coding-plan/glm-4.6v"
},
"prometheus": {
// 战略规划代理:先澄清需求,再咨询其他代理验证计划
"model": "openai/gpt-5.3-codex"
},
"metis": {
// 前规划分析代理:识别隐含需求、风险点
"model": "opencode/kimi-k2.5-free"
},
"momus": {
// 规划审查代理:质疑现有计划、挑错补充改进
"model": "opencode/kimi-k2.5-free"
}
},
"categories": {
"visual-engineering": {
// UI / 前端布局 / 图形交互设计
"model": "openai/gpt-5.3-codex"
},
"ultrabrain": {
// 高强度推理:复杂架构设计、疑难 Debug
"model": "openai/gpt-5.3-codex"
},
"artistry": {
// 创意表达:审美导向设计、文案创作
"model": "opencode/kimi-k2.5-free"
},
"quick": {
// 快速响应:简单问答、小修小补(速度优先)
"model": "zhipuai-coding-plan/glm-4.7"
},
"unspecified-low": {
// 未指定类型的中等任务:格式转换、简单脚本
"model": "opencode/kimi-k2.5-free"
},
"unspecified-high": {
// 未指定类型的高质量任务:认真处理但暂时没明确分类
"model": "openai/gpt-5.3-codex"
},
"writing": {
// 写作类任务:说明文档、README、博客草稿
"model": "zhipuai-coding-plan/glm-4.7"
}
}
}