2026年【OpenCode 】技术解析与使用教程：100% 开源的 AI 编程 Agent 全景剖析

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

亲爱的朋友们，创作不容易，若对您有帮助的话，请点赞收藏加关注哦，您的关注是我持续创作的动力，谢谢大家！有问题请私信或联系邮箱：

2025 年，AI 编程助手赛道涌现出众多产品，却几乎全部被“厂商绑定”困扰：Claude Code 依赖 Anthropic API，Cursor 绑定特定订阅，Copilot 深度嵌入 GitHub 生态。OpenCode 正是在这一背景下诞生的彻底另类——由 terminal.shop 创建者与 Neovim 爱好者主导，以 100% 开源、完全模型无关、终端优先 为核心理念，打造一款真正属于开发者社区的 AI 编程 Agent。

项目当前版本 v1.1.36，MIT 许可，托管于 GitHub，支持从 Claude、GPT-4 到本地模型的任意切换，并内置 LSP、MCP、Skills、自定义工具等企业级扩展能力。

在这里插入图片描述

OpenCode 官方 FAQ 直接对标 Claude Code，两者功能相近，差异鲜明：

维度 Claude Code OpenCode 开源程度 闭源（Agent Harness 曾泄露） ✅ 100% 开源，MIT 许可 模型绑定 绑定 Anthropic API ✅ 完全 Provider-Agnostic LSP 支持 ❌ 无内置 LSP ✅ 原生 LSP 集成 界面形态 TUI + IDE 插件 ✅ TUI 优先，客户端/服务器架构 远程驱动 不支持 ✅ 本机运行，移动端远程驱动 桌面应用 无独立桌面版 ✅ Desktop App（Beta） 插件生态 Hooks + MCP ✅ Plugin + MCP + Skills + 自定义工具 定价按 API 用量计费 ✅ 开源自部署，或用 OpenCode Zen

OpenCode 最具前瞻性的设计是客户端/服务器解耦架构，这使得 TUI 仅是众多潜在客户端之一：

层次组件技术栈职责 服务端 opencode server TypeScript + Bun + Hono AI 推理、工具调用、会话管理、文件操作 TUI 客户端 Terminal UI SolidJS + OpenTUI 本机终端交互界面 桌面客户端 Desktop App Electron / Tauri（Beta）跨平台 GUI 封装 移动客户端 远程驱动（规划中） — 手机端下达指令，控制本机 Server IDE 插件 VSCode Extension — 编辑器内嵌入（通过工作流集成）

服务器与客户端通过本地 HTTP + WebSocket 通信，未来可扩展为远程驱动模式——手机发指令，电脑执行，与 OpenClaw 的 ClawBot 理念一脉相承。

核心依赖技术

技术用途 Bun 运行时 + 包管理器，替代 Node.js，速度更快 SolidJS TUI 渲染框架（响应式，非 React） Hono 轻量级 HTTP 框架，构建本地 Server tree-sitter 多语言 AST 解析，支持精准代码理解 Vercel AI SDK 统一多模型调用层（ai 包） MCP SDK Model Context Protocol，工具扩展协议

OpenCode 通过 Vercel AI SDK 统一封装了业内几乎所有主流 LLM Provider：

4.1 支持的模型提供商

类别 Provider 代表模型 Anthropic @ai-sdk/anthropic Claude Opus / Sonnet / Haiku OpenAI @ai-sdk/openai GPT-4o、o1、o3 Google @ai-sdk/google / Vertex Gemini 2.5 Pro/Flash Amazon @ai-sdk/amazon-bedrock Claude on Bedrock、Titan xAI @ai-sdk/xai Grok-3 Groq @ai-sdk/groq LLaMA 3.3 70B（极速推理） Mistral @ai-sdk/mistral Mistral Large / Codestral Cohere @ai-sdk/cohere Command R+ Cerebras @ai-sdk/cerebras LLaMA 3.1（芯片加速） Together AI @ai-sdk/togetherai 多款开源模型托管 Perplexity @ai-sdk/perplexity 联网搜索增强模型 OpenRouter @openrouter/ai-sdk-provider 聚合多百款模型 GitLab @gitlab/gitlab-ai-provider GitLab Duo 本地模型 OpenAI-Compatible 接口 Ollama、LM Studio 等 OpenCode Zen 官方托管服务精选高性价比模型

4.2 配置方式

通过项目根目录的 .opencode/opencode.jsonc 声明 Provider 与模型：

字段说明 provider 声明使用的 Provider 及配置选项 mcp 挂载 MCP 远程/本地工具服务 tools 启用或禁用特定工具 model 默认使用的模型 ID plugin 加载扩展插件

OpenCode 内置三种 Agent，按 Tab 键快速切换：

Agent 模式权限适用场景 build（默认）完整执行模式读写文件 + 执行命令日常编码、功能实现、Bug 修复 plan（只读）分析规划模式只读，执行前询问探索陌生代码库、规划改动方案 general（子 Agent）通用搜索模式按需复杂搜索与多步任务， @general 调用

plan Agent 的设计哲学值得关注：它默认拒绝文件修改，执行 Bash 命令前必须经用户确认，是处理不熟悉代码库时的“安全探索模式”，避免意外改动。

OpenCode 在项目级 .opencode/ 目录下提供四层扩展机制：

扩展类型目录路径功能 Skills

.opencode/skill/ 
         
           /SKILL.md

领域知识封装，注入 Agent 上下文 Custom Commands

.opencode/command/ 
         
           .md

自定义 /命令，支持动态上下文注入 Custom Agents

.opencode/agent/ 
         
           .md

定制 Agent 行为规范与工具权限 Custom Tools

.opencode/tool/ 
         
           .ts

TypeScript 实现的自定义工具函数

6.1 Skills 与 Claude Code Skills 的对比

维度 OpenCode Skills Claude Code Skills 格式 Markdown + YAML Frontmatter Markdown + YAML Frontmatter 触发方式 Agent 根据 description 自动判断同左，或 /skill-name 主动调用 工具限制 通过 Agent 配置控制 Skill 内白名单声明 模型指定 ✅ Frontmatter 可指定 model ❌ 不支持 子任务标记 ✅ subtask: true ❌

6.2 MCP（Model Context Protocol）集成

OpenCode 完整支持 MCP，可挂载本地或远程 MCP 服务扩展工具能力：

MCP 类型配置方式示例 远程 MCP type: “remote” + URL Context7 文档服务 本地 MCP type: “local” + 命令自定义数据库查询工具 stdio 进程 type: “stdio” + 启动命令 Playwright 浏览器控制

7.1 安装方式

方式命令适用平台 一键脚本 curl -fsSL https://opencode.ai/install | bash macOS / Linux Homebrew（推荐） brew install anomalyco/tap/opencode macOS / Linux，始终最新 npm npm i -g opencode-ai@latest 全平台 Scoop scoop install opencode Windows Nix nix run nixpkgs#opencode NixOS / 任意 mise mise use -g opencode 全平台版本管理器

7.2 桌面应用（Beta）

平台安装包 macOS Apple Silicon opencode-desktop-darwin-aarch64.dmg macOS Intel opencode-desktop-darwin-x64.dmg Windows opencode-desktop-windows-x64.exe Linux .deb / .rpm / AppImage

7.3 核心使用流程

步骤操作说明 ① 启动 项目目录下运行 opencode 自动读取 .opencode/opencode.jsonc ② 选 Agent Tab 切换 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.ai
OpenCode GitHub 仓库 — anomalyco/opencode
OpenCode 官方文档 — opencode.ai/docs
OpenCode Zen 模型服务 — opencode.ai/zen
Model Context Protocol 规范 — modelcontextprotocol.io
Vercel AI SDK 文档 — sdk.vercel.ai