文章目录OpenCode 技术解析与使用教程100% 开源的 AI 编程 Agent 全景剖析一、引言二、核心定位与 Claude Code 的关键差异三、技术架构客户端 / 服务器解耦设计核心依赖技术四、多模型支持真正的 Provider-Agnostic4.1 支持的模型提供商4.2 配置方式五、Agent 系统三种内置 Agent六、扩展体系四层可定制能力6.1 Skills 与 Claude Code Skills 的对比6.2 MCPModel Context Protocol集成七、安装与快速上手7.1 安装方式7.2 桌面应用Beta7.3 核心使用流程八、总结OpenCode 技术解析与使用教程100% 开源的 AI 编程 Agent 全景剖析一、引言亲爱的朋友们创作不容易若对您有帮助的话请点赞收藏加关注哦您的关注是我持续创作的动力谢谢大家有问题请私信或联系邮箱jasonai.fngmail.com2025 年AI 编程助手赛道涌现出众多产品却几乎全部被厂商绑定困扰Claude Code 依赖 Anthropic APICursor 绑定特定订阅Copilot 深度嵌入 GitHub 生态。OpenCode正是在这一背景下诞生的彻底另类——由 terminal.shop 创建者与 Neovim 爱好者主导以100% 开源、完全模型无关、终端优先为核心理念打造一款真正属于开发者社区的 AI 编程 Agent。项目当前版本v1.1.36MIT 许可托管于 GitHub支持从 Claude、GPT-4 到本地模型的任意切换并内置 LSP、MCP、Skills、自定义工具等企业级扩展能力。二、核心定位与 Claude Code 的关键差异OpenCode 官方 FAQ 直接对标 Claude Code两者功能相近差异鲜明维度Claude CodeOpenCode开源程度闭源Agent Harness 曾泄露✅100% 开源MIT 许可模型绑定绑定 Anthropic API✅完全 Provider-AgnosticLSP 支持❌ 无内置 LSP✅原生 LSP 集成界面形态TUI IDE 插件✅TUI 优先客户端/服务器架构远程驱动不支持✅本机运行移动端远程驱动桌面应用无独立桌面版✅Desktop AppBeta插件生态Hooks MCP✅Plugin MCP Skills 自定义工具定价按 API 用量计费✅开源自部署或用 OpenCode Zen三、技术架构客户端 / 服务器解耦设计OpenCode 最具前瞻性的设计是客户端/服务器解耦架构这使得 TUI 仅是众多潜在客户端之一层次组件技术栈职责服务端opencode serverTypeScript Bun HonoAI 推理、工具调用、会话管理、文件操作TUI 客户端Terminal UISolidJS OpenTUI本机终端交互界面桌面客户端Desktop AppElectron / TauriBeta跨平台 GUI 封装移动客户端远程驱动规划中—手机端下达指令控制本机 ServerIDE 插件VSCode Extension—编辑器内嵌入通过工作流集成服务器与客户端通过本地 HTTP WebSocket通信未来可扩展为远程驱动模式——手机发指令电脑执行与 OpenClaw 的 ClawBot 理念一脉相承。核心依赖技术技术用途Bun运行时 包管理器替代 Node.js速度更快SolidJSTUI 渲染框架响应式非 ReactHono轻量级 HTTP 框架构建本地 Servertree-sitter多语言 AST 解析支持精准代码理解Vercel AI SDK统一多模型调用层ai 包MCP SDKModel Context Protocol工具扩展协议四、多模型支持真正的 Provider-AgnosticOpenCode 通过Vercel AI SDK统一封装了业内几乎所有主流 LLM Provider4.1 支持的模型提供商类别Provider代表模型Anthropicai-sdk/anthropicClaude Opus / Sonnet / HaikuOpenAIai-sdk/openaiGPT-4o、o1、o3Googleai-sdk/google/ VertexGemini 2.5 Pro/FlashAmazonai-sdk/amazon-bedrockClaude on Bedrock、TitanxAIai-sdk/xaiGrok-3Groqai-sdk/groqLLaMA 3.3 70B极速推理Mistralai-sdk/mistralMistral Large / CodestralCohereai-sdk/cohereCommand RCerebrasai-sdk/cerebrasLLaMA 3.1芯片加速Together AIai-sdk/togetherai多款开源模型托管Perplexityai-sdk/perplexity联网搜索增强模型OpenRouteropenrouter/ai-sdk-provider聚合多百款模型GitLabgitlab/gitlab-ai-providerGitLab Duo本地模型OpenAI-Compatible 接口Ollama、LM Studio 等OpenCode Zen官方托管服务精选高性价比模型4.2 配置方式通过项目根目录的.opencode/opencode.jsonc声明 Provider 与模型字段说明provider声明使用的 Provider 及配置选项mcp挂载 MCP 远程/本地工具服务tools启用或禁用特定工具model默认使用的模型 IDplugin加载扩展插件五、Agent 系统三种内置 AgentOpenCode 内置三种 Agent按Tab键快速切换Agent模式权限适用场景build默认完整执行模式读写文件 执行命令日常编码、功能实现、Bug 修复plan只读分析规划模式只读执行前询问探索陌生代码库、规划改动方案general子 Agent通用搜索模式按需复杂搜索与多步任务general调用planAgent 的设计哲学值得关注它默认拒绝文件修改执行 Bash 命令前必须经用户确认是处理不熟悉代码库时的安全探索模式避免意外改动。六、扩展体系四层可定制能力OpenCode 在项目级.opencode/目录下提供四层扩展机制扩展类型目录路径功能Skills.opencode/skill/name/SKILL.md领域知识封装注入 Agent 上下文Custom Commands.opencode/command/name.md自定义/命令支持动态上下文注入Custom Agents.opencode/agent/name.md定制 Agent 行为规范与工具权限Custom Tools.opencode/tool/name.tsTypeScript 实现的自定义工具函数6.1 Skills 与 Claude Code Skills 的对比维度OpenCode SkillsClaude Code Skills格式Markdown YAML FrontmatterMarkdown YAML Frontmatter触发方式Agent 根据 description 自动判断同左或/skill-name主动调用工具限制通过 Agent 配置控制Skill 内白名单声明模型指定✅ Frontmatter 可指定model❌ 不支持子任务标记✅subtask: true❌6.2 MCPModel Context Protocol集成OpenCode 完整支持 MCP可挂载本地或远程 MCP 服务扩展工具能力MCP 类型配置方式示例远程 MCPtype: remote URLContext7 文档服务本地 MCPtype: local 命令自定义数据库查询工具stdio 进程type: stdio 启动命令Playwright 浏览器控制七、安装与快速上手7.1 安装方式方式命令适用平台一键脚本curl -fsSL https://opencode.ai/install | bashmacOS / LinuxHomebrew推荐brew install anomalyco/tap/opencodemacOS / Linux始终最新npmnpm i -g opencode-ailatest全平台Scoopscoop install opencodeWindowsNixnix run nixpkgs#opencodeNixOS / 任意misemise use -g opencode全平台版本管理器7.2 桌面应用Beta平台安装包macOS Apple Siliconopencode-desktop-darwin-aarch64.dmgmacOS Intelopencode-desktop-darwin-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.deb/.rpm/ AppImage7.3 核心使用流程步骤操作说明① 启动项目目录下运行opencode自动读取.opencode/opencode.jsonc② 选 AgentTab切换 build / plan开发用 build探索用 plan③ 对话自然语言描述任务支持general调用子 Agent④ 调用命令/commit、/spellcheck等执行.opencode/command/中定义的命令⑤ 查看工具调用实时 TUI 展示工具执行过程文件读写、命令执行全程透明八、总结维度核心要点定位100% 开源、模型无关的 AI 编程 Agent终端优先架构客户端/服务器解耦TUI 是首个客户端支持远程驱动模型生态15 Provider覆盖 Claude / GPT / Gemini / Groq / 本地模型Agent 体系build执行/ plan只读/ general子任务三模式扩展能力Skills / Commands / Agents / Tools 四层定制 MCP 协议适用人群重视数据主权、厌倦厂商锁定、热爱终端的开发者OpenCode 代表了 AI 编程工具的另一种可能不靠生态锁定靠开放赢得开发者。在 Claude Code 凭借 Anthropic 光环席卷市场之时OpenCode 用你可以换任何模型、自己托管、自己改代码的彻底开放性吸引了数以万计的开发者贡献与使用。对于追求掌控感与灵活性的工程师OpenCode 值得深度体验。参考资料OpenCode 官方网站 — opencode.aiOpenCode GitHub 仓库 — anomalyco/opencodeOpenCode 官方文档 — opencode.ai/docsOpenCode Zen 模型服务 — opencode.ai/zenModel Context Protocol 规范 — modelcontextprotocol.ioVercel AI SDK 文档 — sdk.vercel.ai