OpenCode 完全教學指南

從入門到進階,系統性學習 AI 編碼代理工具 opencode 的所有功能與實戰技巧

初/中/高三級路徑 13 章完整內容 實戰範例驅動 繁體中文

學習路徑

按照你的程度選擇適合的起點,逐步掌握 opencode 的所有面向

初級 Beginner

入門指南

適合第一次接觸 opencode 的使用者。從安裝設定到基本操作,快速上手。

  • opencode 是什麼?安裝與環境設定
  • TUI 基本操作:啟動、提問、@ 參考
  • 認識斜線指令:/init、/undo、/redo
  • 選擇模型與提供商
  • AGENTS.md 基礎撰寫
  • Plan vs Build 模式切換
中級 Intermediate

進階應用

適合已能基本操作,想深入客製化與提升效率的使用者。

  • opencode.json 深度設定
  • 自訂指令(Commands)
  • 內建代理深入:Build / Plan / Explore
  • 自訂代理(Agents)
  • 權限管理(Permissions)
  • 工具啟用/停用管理
  • 工作階段管理
高級 Advanced

專家擴展

適合開發者與進階使用者,將 opencode 整合到完整工作流程中。

  • MCP 伺服器:本地與遠端
  • 外掛系統(Plugins)
  • 代理技能(SKILL.md)
  • 自訂工具(Custom Tools)
  • LSP 伺服器設定
  • 多代理協作
  • SDK 與 GitHub/GitLab 整合

章節總覽

13 個章節,從基礎到進階,全面涵蓋 opencode 的所有功能

第 1 章

opencode 簡介與安裝

了解 opencode 是什麼、安裝方式、系統需求與初始化流程

初級
第 2 章

TUI 基礎操作

啟動、提問、@ 檔案參考、!bash 指令、斜線指令總覽

初級
第 3 章

AGENTS.md 與規則系統

撰寫專案規則、全域規則、Claude Code 相容性

初級
第 4 章

模型與提供商設定

75+ 提供商、OpenCode Zen、自訂提供商、模型變體

初級
第 5 章

進階設定(opencode.json)

設定檔格式、位置優先順序、Schema 完整選項

中級
第 6 章

自訂指令

JSON/Markdown 定義、參數注入、Shell 輸出、檔案參照

中級
第 7 章

代理系統

主代理 vs 子代理、內建代理、自訂代理設定

中級
第 8 章

權限與工具管理

內建工具、allow/ask/deny、bash 指令層級權限

中級
第 9 章

MCP 伺服器

本地/遠端 MCP、OAuth 認證、Sentry/Context7 範例

高級
第 10 章

外掛與自訂工具

外掛系統、npm 外掛、自訂工具開發

高級
第 11 章

代理技能(SKILL.md)

SKILL.md 格式、發現機制、權限設定

高級
第 12 章

企業應用與整合

GitHub Actions、GitLab CI、網路、企業版、分享

高級
第 13 章

SDK 與開發者擴展

JS/TS SDK、伺服器 API、ACP 協議、生態系統

高級