DEV Community

韩
韩

Posted on

OpenCode 的 5 个隐藏用法：17.8 万 Star 终端 AI 代理，会话中随意切换提供商

#ai #llm #agents #opensource

你知道吗？你的终端 AI 代理其实可以无缝切换 30+ 个 LLM 提供商、运行隔离的后台任务、从 npm 加载自定义插件，还能通过 OAuth 认证连接 GitHub 和 Slack —— 这一切只需一次 npm install。

OpenCode 是一个拥有 178,218 Stars 的开源 AI 编程代理，用 TypeScript 构建。它在 2026 年 3 月突破了 1,274 票的程序员新闻（Hacker News）讨论度，最新版本（v1.17.10，2026 年 6 月 24 发布）新增了 MCP 资源模板、OAuth 绑定回调和新版 --mini CLI 模式。大多数人把它当作终端里的 Claude Code 替代品 —— 但深入了解后你会发现，它的插件生态、多代理架构和提供商抽象层远超普通自动补全工具。

在 2026 年 AI 编程工具的格局中，Cursor、Claude Code、Codex CLI 和 Goose 都在争夺开发者的注意力。OpenCode 之所以脱颖而出，是因为它采用 MIT 完全开源、提供商无关（支持 30+ 提供商包括自托管）、并围绕可扩展的插件 + 技能 + MCP 架构搭建。以下是大多数人忽略的五个隐藏用法。

隐藏用法 #1：多提供商故障转移 + 自定义提供商

大多数人的用法： 只用单个 API 密钥 —— Anthropic 或 OpenAI。

隐藏技巧： OpenCode 的提供商插件系统原生支持 30+ 提供商，包括 Anthropic、OpenAI、Google、DeepSeek、Mistral、Groq、TogetherAI、OpenRouter、GitHub Copilot、GitLab、Snowflake Cortex 等。你可以配置多个提供商和不同模型，用 /model 命令在会话中随时切换。更妙的是，你可以添加指向自托管模型的自定义 OpenAI 兼容提供商（Ollama、vLLM、LM Studio）。

# 配置 OpenCode 连接本地 Ollama 提供商
opencode config set providers.ollama.baseUrl "http://localhost:11434/v1"
opencode config set providers.ollama.models '[{"id":"llama3.3","name":"Llama 3.3 70B"}]'

# 在会话中切换提供商
# 输入: /model ollama/llama3.3
# 或者: /model anthropic/claude-sonnet-4-20250514
Enter fullscreen mode Exit fullscreen mode

效果： 你的编程代理变成了提供商无关的。当 Anthropic 触发速率限制时，切换到 DeepSeek。需要便宜的探索模型时，用 Groq。需要在本地部署时，指向 Ollama 实例 —— 所有操作都不需要离开当前会话。

数据来源： OpenCode GitHub 178,218 Stars，HN 1,274 pts/618 评论（story 47460525），30+ 提供商插件从仓库目录树确认（packages/core/src/plugin/provider/*.ts）。

隐藏用法 #2：插件生态 —— 用 npm 包扩展代理能力

大多数人的用法： 直接用 OpenCode 的内置功能。

隐藏技巧： OpenCode 拥有完整的插件系统。你可以从 npm 包安装插件，从目录加载自定义插件，或自己编写。插件可以添加自定义代理、命令、提供商、甚至注入系统上下文。插件生命周期支持安装、加载、热重载和沙箱隔离。

# 从 npm 安装插件
opencode plugin install @my-org/opencode-custom-agent

# 从本地目录加载插件
opencode --plugin ./my-custom-plugin/

# 列出已安装插件
opencode plugin list
Enter fullscreen mode Exit fullscreen mode

插件用 TypeScript 编写，可以注册：

  • 自定义代理（拥有独立系统提示和工具集）
  • 自定义斜杠命令（如 /review-pr、/deploy-staging）
  • 自定义 LLM 提供商（指向任意 OpenAI 兼容 API）
  • 自定义工具（通过 MCP 服务器集成）

效果： 你可以用领域特定能力扩展 OpenCode —— 一个了解数据库架构的 /run-migrations 命令、一个针对你团队规范调整过的代码审查代理、或一个封装 CI/CD 工具的部署插件。

数据来源： OpenCode v1.17.10 发布说明（2026-06-24），插件系统从仓库目录树确认（packages/plugin/src/v2/, packages/core/src/plugin/）。

隐藏用法 #3：MCP OAuth —— 与外部服务的认证工具调用

大多数人的用法： 使用没有认证或静态 API 密钥直接粘贴到配置的 MCP 服务器。

隐藏技巧： OpenCode 支持完整的 MCP OAuth 流程。当你连接需要 OAuth 的 MCP 服务器（如 GitHub、Slack、Jira）时，OpenCode 会打开浏览器进行 OAuth 认证，在 IPv4 回环服务器上处理回调（v1.17.10 中为安全起见绑定），并自动管理令牌刷新。这意味着你可以通过自然语言在终端中使用 GitHub 的 MCP 服务器来创建 Issue、阅读 PR 和管理仓库。

# 添加支持 OAuth 的 MCP 服务器
opencode mcp add github --url https://api.github.com/mcp

# OpenCode 会在浏览器中提示 OAuth 登录
# 认证后，你可以说：
# "从当前分支创建一个标题为 'Fix auth bug' 的 PR 到 main"
# "列出所有分配给我的未关闭 Issue"
Enter fullscreen mode Exit fullscreen mode

效果： 你的终端代理成为了连接外部服务的桥梁，拥有正确的认证机制。不再需要在配置文件中粘贴令牌 —— OAuth 安全地处理一切，并自动刷新。

数据来源： OpenCode v1.17.10 发布说明 —— "将 MCP OAuth 回调绑定到 IPv4 回环以提高本地认证可靠性"（@he-yufeng），MCP 认证系统见 packages/opencode/src/mcp/auth.ts。

隐藏用法 #4：规划/构建双代理架构 + 后台子代理

大多数人的用法： 一直用默认的 "build" 代理做所有事。

隐藏技巧： OpenCode 内置两个代理：build（完全访问权限，默认）和 plan（只读模式，运行命令前请求权限）。你可以用 Tab 键在它们之间切换。Plan 代理非常适合探索不熟悉的代码库、分析架构或规划重构 —— 而且不会有意外编辑的风险。此外，OpenCode 支持后台并行运行的子代理。你可以派一个 @general 子代理做复杂搜索，同时继续在主会话中写代码。

# 启动 OpenCode
opencode

# 按 Tab 切换 build 和 plan 代理
# 在 plan 代理中: "分析这个代码库的认证流程"
# 在 build 代理中: "重构 auth 模块使用新的 token 格式"

# 派后台子代理做并行工作
# 输入: @general 搜索所有与错误处理相关的 TODO 项
# 子代理工作时你继续写代码
Enter fullscreen mode Exit fullscreen mode

效果： Plan 代理充当安全的探索模式 —— 你可以把它交给初级开发者，或在 CI 管道中使用（只需要分析不需要修改）。后台子代理让你能并行进行研究和编码，有效地将终端变成多代理工作空间。

数据来源： OpenCode README（dev 分支）—— "build 代理（完全访问）/ plan 代理（只读，请求权限）"，HN 319pts 讨论 "Opencode: AI coding agent, built for the terminal"（id 44482504）。

隐藏用法 #5：技能系统 —— 用可复用的提示模板替代重复输入

大多数人的用法： 反复输入相同的指令（"写测试"、"审查这个 PR"、"检查安全问题"）。

隐藏技巧： OpenCode 拥有内置的技能系统。技能是存放在 .opencode/skills/ 中的 Markdown 文件（.md），定义可复用的提示模板。你调用 /skill-name 即可使用，它们支持前置元数据配置以便自定义。OpenCode 内置了 customize-opencode 和 effect 等技能，你也可以创建自己的。

# .opencode/skills/review-security.md
---
name: review-security
description: "安全导向的代码审查"
tools: [read, list, grep]
---

审查当前文件的安全漏洞：
1. 检查 SQL 注入模式
2. 查找硬编码的密钥或 API 密钥
3. 验证所有面向用户的端点的输入校验
4. 标记任何 eval() 或动态导入的使用
Enter fullscreen mode Exit fullscreen mode 
# 调用自定义技能
/review-security

# 或使用内置技能
/customize-opencode  # OpenCode 自己的配置向导
Enter fullscreen mode Exit fullscreen mode

效果： 技能将重复的指令变成可分享、版本控制的模板。你的团队可以在仓库中维护一套技能库，团队中的每个开发者都能获得一致的行为 —— 不再需要复制粘贴提示词或在代码审查中遗漏步骤。

数据来源： OpenCode 仓库目录树 —— .opencode/skills/effect/SKILL.md，packages/core/src/skill/*，packages/opencode/src/skill/discovery.ts，v1.17.10 发布说明中提到技能基础目录。

总结：OpenCode 的 5 个隐藏用法

  1. 多提供商故障转移 —— 在 30+ LLM 提供商之间随时切换，包括自托管模型
  2. 插件生态 —— 用 npm 包、自定义代理和领域特定命令扩展代理能力
  3. MCP OAuth —— 通过浏览器 OAuth 流程认证外部服务（GitHub、Slack、Jira）
  4. 规划/构建架构 —— 用只读规划代理安全探索，用后台子代理并行工作
  5. 技能系统 —— 创建可复用、版本控制的提示模板，实现团队一致的工作流

系列回顾

如果你喜欢这篇文章，欢迎阅读"5 个隐藏用法"系列的前作：

你有没有发现 OpenCode 的隐藏用法 —— 一个插件、技能或大多数人不知道的工作流？欢迎在评论区分享！

Top comments (0)