OpenCode 是什麼、怎麼安裝：開源的終端 AI 編程智能體與桌面版入門

本文根據 OpenCode 官方 GitHub 倉庫 README 與官網整理，資料核對於 2026-10-11。開源項目變化快，以官方倉庫為準。

是什麼

OpenCode 是一個開源的 AI 編程智能體，倉庫現在位於 anomalyco/opencode（約 21.25 萬星標、2.84 萬次復刻），採用 MIT 許可。它和 Claude Code、Codex CLI 屬於同一類工具——在終端裏啟動，用自然語言讓它讀代碼、改文件、運行命令——區別在於它是社區驅動的開源項目，不屬於某一家模型廠商。

核心設計

README 介紹了它的智能體分工：

• build：預設智能體，擁有完整權限，可以修改文件、執行命令，用於實際開發；
• plan：只讀的規劃智能體，只分析代碼、給出方案，不動任何文件——適合先看清楚再動手，或在不熟悉的代碼庫裏探索；
• general：一個通用的子智能體，在對話裏用 @general 調用，處理需要多步搜尋的複雜問題。

介面是終端裏的交互式介面（TUI）；此外還有一個處於測試階段的桌面應用，支持 macOS、Windows 和 Linux。

怎麼上手

README 提供了很多安裝方式，常用的幾種：

bash
# 安裝腳本
curl -fsSL https://opencode.ai/install | bash

# npm
npm i -g opencode-ai@latest

# macOS / Linux 的 Homebrew
brew install opencode

Windows 用戶還可以用 Scoop 或 Chocolatey。安裝後：

1. 進入項目目錄，運行 opencode；
2. 按提示配置模型服務（登入或填入 API Key，支持的服務商以官方文檔為準）；
3. 先切到 plan 智能體，讓它說明項目結構和改動方案；
4. 確認方案後切回 build 執行，逐步檢查它的修改。

免費與付費

OpenCode 本身免費開源。使用成本取決於你接入的模型：按 API 用量付費，或使用你已有的訂閱。搜尋下拉里常見的「OpenCode Zen」「OpenCode Go」是官方圍繞模型用量提供的付費服務，具體內容和價格以官網為準，本文未逐項核對。

適合誰 / 不適合誰

適合：

• 習慣終端、希望工具本身開源可審計的開發者；
• 想自由選擇模型、不被單一廠商綁定的人；
• 喜歡「先規劃、後執行」工作方式的工程師。

不適合：

• 不熟悉命令行的初學者；
• 想要編輯器內聯補全和圖形化 diff 的人，Cursor 等 IDE 類產品更合適；
• 需要廠商級服務支持和合規承諾的企業採購。

注意事項

• build 智能體權限很大：在 Git 倉庫裏使用，改動前提交乾淨，危險命令執行前仔細看確認提示。
• 認準倉庫：項目經歷過組織和倉庫地址的調整，網上還有名稱相同的其他項目，以官網 opencode.ai 指向的倉庫為準。
• 模型費用：長對話和大倉庫會消耗大量 Token，留意帳單。
• 桌面版仍是測試版，穩定性不如命令行版本。