OpenCode安裝與設定教學：用AI逐步寫程式

目錄

• 兩個不能混為一談的名字
• 完整步驟

  • 1. 安裝OpenCode CLI
  • 2. 確認能正常執行
  • 3. 串接模型供應商
  • 4. 進入真實的repo
  • 5. 指派第一個任務
• 如果出了問題
• 常見問題

  • OpenCode和OpenCode Go是同一個東西嗎？
  • 可以用Homebrew或Scoop安裝嗎？
  • 需要強大的GPU嗎？
  • 怎麼拿到5美元額度？
• 重點整理

兩個不能混為一談的名字

• **OpenCode：**那個CLI。裝一次就好。是自由軟體，以opencode指令執行。
• **OpenCode Go：**訂閱方案（首月約5美元，之後10美元），附帶開放模型和用量上限。它是眾多可串接的供應商之一。安裝CLI不需要它。

你可以今天只裝OpenCode，然後串接Anthropic、Z.ai或其他API。Go的價值在於：你不用自己管理十把API key。

完整步驟

1. 安裝OpenCode CLI

官方v2文檔提供以下幾種方式。選一種就好：

npm install -g @opencode/cli

bun install -g --trust @opencode/cli

pnpm add -g --allow-build=@opencode/cli @opencode/cli

yarn global add @opencode/cli

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

npm套件使用受信任的postinstall腳本下載你平台的原生二進位檔。這就是bun和pnpm需要--trust／--allow-build旗標的原因。

根據同一份文檔，不要用這些方式：Homebrew、AUR、Scoop、Chocolatey，或從鏡像站抓的散裝.exe。那些教你brew install opencode的2025年教學，相對於v2已經過時了。

Docker版本存在（ghcr.io/anomalyco/opencode，附版本tag），如果你的工作流程走容器化。但第一天，npm或腳本就夠了。

2. 確認能正常執行

關掉終端機再重開（PATH有時不會即時刷新）。然後執行：

opencode

應該要開啟TUI，而不是command not found。如果curl腳本裝到了你的shell沒載入的目錄，開一個新工作階段，或對你的.bashrc／.zshrc執行source。

不需要GPU。也不需要把opencode tui當成什麼神奇子命令：直接執行不帶參數的執行檔就會啟動介面。

3. 串接模型供應商

在TUI裡，指令是：

/connect

在這裡選擇供應商。合理的幾條路：

• **OpenCode Go：**如果你要10美元方案和開放模型。用5美元連結建立帳號、完成付款設定，然後在/connect裡串接Go。用量上限的細節（5小時／週／月）在價格那篇有講；這裡只在乎工作階段能通過驗證。
• **Z.ai / GLM：**如果你已經有Coding Plan，就用coding端點把它串接為自訂供應商。不要混用通用聊天的key。
• Anthropic、OpenAI或其他：/connect之後貼上key。OpenCode內建支援好幾家。

沒有供應商，TUI就只是一個空殼。第一天最典型的錯誤不是「裝不起來」：而是打開了opencode，卻什麼都沒串。

4. 進入真實的repo

cd /你的專案路徑
opencode

代理看得到的是那個目錄裡的檔案。如果你在$HOME裡啟動，它會想對你整顆硬碟發表意見。別這麼做。

如果專案裡已經有AGENTS.md或opencode.json，它會遵守。沒有的話，之後再初始化也行，不會擋住你的第一個提示。

5. 指派第一個任務

要求一件不需要靠信念就能驗證的事：

• 「src/auth.ts在做什麼？」
• 「為這個函式寫一個測試，其他檔案都不要動。」

如果它改的是正確的檔案、diff也合理，安裝就算大功告成。到這一步之後，才值得聊MCP、外掛和主題——自訂文檔是留給第二天的。

如果出了問題

• **command not found：**PATH的問題。重開終端機。npm全域安裝在Windows上，有時是PATH裡少了npm的前綴。
• **npm的postinstall卡住：**那是下載二進位檔的腳本。用bun／pnpm的話，必須有傳入--trust／--allow-build。
• **TUI開了但模型不回應：**不是安裝問題，是/connect的問題。檢查key和供應商。
• **Go在下午就見底：**那是用量上限，不是CLI的bug。細節在上限分析那篇。

常見問題

OpenCode和OpenCode Go是同一個東西嗎？

不是。一個是CLI，一個是模型訂閱。CLI可以單獨用，不需要Go。

可以用Homebrew或Scoop安裝嗎？

根據v2文檔：不行。用npm／bun／pnpm／yarn或opencode.ai/v2/install腳本。

需要強大的GPU嗎？

用Go或雲端API都不需要。

怎麼拿到5美元額度？

透過Go的推薦連結註冊。額度套用於用量上限。

重點整理

• 用官方v2的方式安裝CLI，不要照某篇部落格的brew指令。
• /connect是大家最容易跳過的一步。
• 要在repo裡面啟動opencode。
• Go是選配，用推薦額度試起來很便宜。
• 價格與上限：另外兩篇文章。

👉 用5美元額度試用OpenCode Go

---

如果你腦中已經有代理的輪廓，只差「讓它在這台機器上跑起來」，你不需要再多一篇比較文。你需要的是一個官方文檔仍然背書的安裝方式。

— Leandro Valencia