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

目錄

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

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

  • OpenCode和OpenCode Go是同一個東西嗎？
  • 可以用Homebrew或Scoop安裝嗎？
  • 需要強大的GPU嗎？
  • OpenCode Go 多少錢？
• 重點整理

我之前寫的OpenCode文章都是價格與用量上限的分析：Go的10美元方案和Zen與Go的比較。這篇不是。這篇要講的是怎麼把程式裝好，並讓它在你的儲存庫裡開始回應。

OpenCode是一個住在終端機裡的程式代理（TUI）。它不是IDE，也不取代VS Code。它是那個打開專案、讀取檔案、用你接上的模型提出修改建議的角色。

如果使用 OpenCode Go，從第一個月起就是每月 10 美元。需要更多額度時，Go Plus 是每月 40 美元。首月 5 美元和推薦額度都沒有了。訂閱在 opencode.ai/go。

更新於2026年9月30日。

兩個不能混為一談的名字

• OpenCode：那個CLI。裝一次就好。是自由軟體，以opencode指令執行。
• OpenCode Go：每月 10 美元的訂閱（Go Plus 為 40 美元），附帶開放模型和用量上限。它是你可以串接的一個供應商，不是安裝 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 美元（或 Go Plus 的 40 美元）和開放模型。在 opencode.ai/go 建立帳號、完成付款，然後在 /connect 裡串接 Go。上限細節在價格那篇；這裡只在乎工作階段能通過驗證。
• 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。
• 其他安裝錯誤：postinstall沒有執行、不存在的brew install、Windows的PATH，每一個的解法都在OpenCode常見安裝錯誤與解決方法。
• 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都不需要。

OpenCode Go 多少錢？

從第一次扣款起每月 10 美元。Go Plus 每月 40 美元。上限細節在價格那篇。沒有推薦額度。

重點整理

• 用官方v2的方式安裝CLI，不要照某篇部落格的brew指令。
• /connect是大家最容易跳過的一步。
• 要在repo裡面啟動opencode。
• Go 是選配：每月 10 美元，Go Plus 為 40 美元。
• 價格與上限：另外兩篇文章。

如果要訂閱，去 OpenCode Go。

如果你正在打造自己的AI程式設計工具箱，要支付授權或訂閱費用，在Eneba用我的連結可以享有5%折扣。這是聯盟行銷連結：你買得更便宜，我也多一份支持來維持這個部落格。如果是給團隊用的，我在這裡說明了如何在Eneba買便宜的軟體授權。5% 折扣需透過該連結進入，並在結帳時輸入優惠碼 CreaCosas。

---

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

— Leandro Valencia