OpenCode 中文教學

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
OpenCode 教學	tutorial	從原理到官方手冊全套。
兩條線	two tracks	理解篇打底，官方篇查細節。
按需進入	entry	按目標選先讀哪條線。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按目標決定先讀 OpenCode 的理解篇還是官方篇。

你是 OpenCode 教學導航顧問。

【角色】
OpenCode 教學導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的步驟或示例，不停留在空泛建議。

【輸入】
- 我的目標：___
- 對 OpenCode 的瞭解：___
- 最想解決的問題：___
- 可投入時間：___
- 經驗水平：___

【工作流程】
1. 按目標區分兩條線用途
2. 給先讀哪條的建議
3. 排推薦順序
4. 標出可跳讀的
5. 給第一步

【輸出規範】
▌一、兩條線用途
▌二、先讀哪條
▌三、推薦順序
▌四、按需跳讀 + 第一步

【硬約束】
- 按目標選線不強行通讀
- 先理解後查手冊
- 貼合經驗水平
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法

OpenCode 是一個開源 AI coding agent。它可以跑在終端 TUI、CLI、桌面應用、IDE 擴充套件和 Web/server 裡，也可以透過 SDK、GitHub/GitLab 整合、ACP、MCP、LSP、Plugin 和 Skill 接到更大的開發流程裡。

這個中文教學解決兩個問題：第一，幫你快速查到官方功能怎麼用；第二，幫你理解 OpenCode 適合放在什麼工作流裡。讀完以後，你應該能判斷什麼時候用 OpenCode、怎麼連線模型、怎麼設定專案規則、哪些能力可以交給 agent，哪些動作必須繼續人工確認。

先給結論：如果你只是第一次開啟 OpenCode，先走“官方教學中文版”；如果你已經能跑起來，但不知道怎麼把 rules、commands、agents、skills、MCP 和許可權體系連成長期工作流，再讀“從原理到實戰”。

兩條互補路徑

flowchart LR
    Start["OpenCode 中文教學"] --> Official["官方教學中文版"]
    Start --> Understanding["從原理到實戰"]
    Official --> Lookup["安裝 / CLI / TUI / 設定 / 工具 / 許可權"]
    Understanding --> Judgment["定位 / 工作流 / 模型策略 / 團隊邊界"]

    style Start fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Official fill:#dcfce7,stroke:#22c55e
    style Understanding fill:#fef3c7,stroke:#f59e0b

接下來去哪

官方教學中文版

按官方文件功能分類，適合查命令、設定項和入口位置。

從原理到實戰

8 篇中文講解，理解 OpenCode 的定位、設定體系和團隊使用邊界。

安裝、連線模型與第一次執行

第一次使用時，先跑通安裝、provider、只讀和低風險寫入。

安全、分享與團隊使用

進入真實專案或團隊流程前，先收緊許可權、金鑰、分享和網路邊界。

怎麼選擇閱讀路徑

第一次接觸 OpenCode，不要從複雜設定開始。先把安裝、模型連線和第一輪只讀任務跑通，再進入 agent、skill、plugin、MCP、LSP 和團隊設定。

你的狀態	先讀什麼	目標
還沒安裝	官方教學中文版	找到安裝方式、啟動 TUI、完成 provider 連線
能開啟 TUI，但不會穩定使用	安裝、連線模型與第一次執行	跑通一個低風險任務，確認能讀專案、能解釋、能受控修改
已經日常使用，但設定很散	設定、Rules 與自定義命令	把重複提醒沉澱成專案規則和 slash command
想接更多工具	工具、MCP、LSP 與格式化器	判斷什麼應該用內建工具，什麼才值得接 MCP 或 LSP
準備團隊使用	安全、分享與團隊使用	控制許可權、分享、金鑰、網路和專案級設定邊界