建立 2026-09-15 更新 2026-09-15

安裝與連線

把 OpenCode 裝到機器上，接好 LLM provider（大型語言模型供應商），再對專案做一次初始化。沒有模型金鑰，TUI 開得起來，但 agent 無法真正工作。

準備環境

終端機 TUI 對模擬器品質比較敏感。官方建議使用 WezTerm、Alacritty、Ghostty 或 Kitty。macOS 內建 Terminal 勉強能用，顯示與快捷鍵體驗通常較差。

Windows 可以原生安裝，但真實專案（shell、Git、語言工具鏈）較接近 Linux。第一次上手，官方建議用 WSL。

另外準備至少一個 LLM 的 API key，或使用 OpenCode Zen 的金鑰。OpenCode 本身免費開源；費用來自你選的模型。

最直接的方式是官方安裝腳本：

curl -fsSL https://opencode.ai/install | bash

其他常見方式：

npm install -g opencode-ai

macOS／Linux 也可用 Homebrew。請用 OpenCode tap，更新較勤；Homebrew 官方 formula brew install opencode 會慢一拍：

brew install anomalyco/tap/opencode

Windows 優先在 WSL 裡跑安裝腳本。原生環境可用 Scoop、Chocolatey 或 npm：

scoop install opencode
choco install opencode
npm install -g opencode-ai

安裝後開一個新的終端機視窗，確認指令找得到：

opencode --version

進到你要處理的專案：

cd /path/to/project
opencode

在 TUI 輸入：

/connect

新手可先選 OpenCode Zen：到 opencode.ai/auth 登入、複製 API key，貼回 TUI。Zen 是官方整理過、針對 coding agent 測過的模型閘道，採用量計費，不是使用 OpenCode 的必要條件。

你也可以接 Anthropic、OpenAI、Google、GitHub Copilot、ChatGPT Plus／Pro，或本機模型（例如 Ollama）。完整清單見 Providers。接好後用 /models 挑選模型。

免費模型可以試，正式專案要小心

Zen 有時會提供免費模型方便試用。免費期間，部分模型可能把資料拿去改進模型。正式或機密專案請改用零保留（zero-retention）政策的付費端點，細節見 Zen 隱私說明。

CLI 也可以登入：

opencode auth login

憑證存在 ~/.local/share/opencode/auth.json。

仍在 TUI 裡執行：

/init

OpenCode 會分析 repo，在專案根目錄寫出 AGENTS.md。這個檔案是給 agent 看的專案說明：結構、慣例、測試指令、不要碰的目錄。請把它提交到 Git，團隊才會共用同一套規則。

接著可以直接問問題，例如「這個專案的進入點在哪裡？」。更完整的日常流程見日常用法；AGENTS.md 怎麼寫見專案規則。