先講結論：OpenCode 在不同作業系統怎麼安裝？
先依作業系統選官方安裝路徑，再確認 PATH、版本與 CLI 能否執行；Windows、macOS、Linux 可以使用不同方式，但不要把 Node.js、Bun、Scoop、Chocolatey 或桌面版混成未驗證的單一路徑。
- macOS／Linux：可先比較官方腳本、Homebrew、npm 與 Bun，再選團隊能維護的方式。
- Windows：確認 PowerShell、Scoop、Chocolatey 或 WSL 的環境邊界與 PATH。
- 驗證：安裝後檢查版本、執行最小指令，確認實際呼叫到預期的 OpenCode。
OpenCode 是開源的 AI coding agent，官方文件目前提供安裝腳本、npm、Bun、Homebrew、paru，以及 Windows 的 Scoop／Chocolatey 路徑，也提供 macOS、Windows、Linux 桌面版。安裝時最重要的不是把所有命令都跑一遍，而是依作業系統、權限、更新方式與團隊政策選一條可維護的路徑。
本文以官方文件與官方 GitHub README 為準，命令與套件名稱可能隨上游版本改變。完成安裝後，先用 opencode --version 驗證，再處理 provider 登入、模型設定與專案權限；能啟動 CLI 不代表模型供應商或工作目錄已經設定完成。
先看 5 個重點
- macOS／Linux 最直接的方式是官方安裝腳本：
curl -fsSL https://opencode.ai/install | bash。 - npm 使用
npm i -g opencode-ai，Bun 使用bun add -g opencode-ai；兩者需要對應的 JavaScript runtime 與 PATH。 - Homebrew 使用
brew install anomalyco/tap/opencode；不要把官方 tap 與可能較慢的同名公式混為一談。 - Windows 可用 Scoop 或 Chocolatey，也可以使用官方桌面版或 WSL 內的 Linux 路徑。
- 安裝後執行
opencode --version，再啟動opencode；若找不到命令，先檢查 PATH 與實際安裝位置。
OpenCode 是什麼？
OpenCode 是在終端機中工作的開源 coding agent，官方 README 將它描述為 open source coding agent，並提供 build 與 plan 等內建 agent 模式。它可以讀取專案、協助修改檔案與執行開發工作，但實際能力取決於目前使用的模型、provider、專案權限與 agent 設定。
把 OpenCode 當成一個命令列程式比較容易排錯：第一層是 binary 是否能執行；第二層是 provider 是否能登入；第三層是模型是否可用；第四層才是專案工具、權限與工作流程。每層都要有獨立驗證，才能知道問題卡在哪裡。
macOS 與 Linux：官方安裝腳本
官方文件提供以下路徑：
“sh curl -fsSL https://opencode.ai/install | bash “
腳本會把 OpenCode 放到可執行的安裝位置。官方 README 說明可用 OPENCODE_INSTALL_DIR 指定自訂目錄，也會依序考慮 XDG_BIN_DIR、$HOME/bin 與 ~/.opencode/bin 等路徑。若安裝完成但 shell 找不到 opencode，先重新載入 shell 設定或確認安裝目錄已在 PATH。
對企業或受管控環境，執行遠端腳本前應先閱讀內容、固定來源與記錄版本；也可以選用 Homebrew、npm 或 Bun，讓套件管理器負責安裝與更新。不同方式的優點不是「誰比較快」，而是權限、可審計性與更新流程不同。
npm：適合已有 Node.js 工作流的人
如果團隊已經使用 Node.js 與 npm，可以使用官方文件列出的套件：
“sh npm i -g opencode-ai opencode --version “
先確認 node --version 與 npm --version 有輸出，並留意 global bin 目錄是否在 PATH。多版本 Node 管理器可能讓不同 shell 使用不同 npm；遇到「已安裝但找不到」時，檢查 npm prefix -g 與實際 global bin 路徑，比盲目重裝更快。
npm 的好處是版本與 CI 工具鏈容易接在一起，代價是需要管理 Node runtime、global package 權限與更新。若專案已有固定 Node 版本，不要讓全域安裝悄悄改變團隊的 runtime 政策。
Bun：已有 Bun 環境時的選擇
官方文件也提供 Bun：
“sh bun add -g opencode-ai opencode --version “
先用 bun --version 確認 Bun 可用，再檢查 Bun 的 global bin 是否在 PATH。Bun、npm 與官方腳本最好選一種作為主要更新來源；同一台機器混裝多份 binary，容易讓 which opencode 指向和預期不同的版本。
Homebrew：macOS／Linux 的套件管理
官方 README 建議使用 anomalyco tap：
“sh brew install anomalyco/tap/opencode opencode --version “
Homebrew 方式適合已用 brew 管理 CLI 的使用者，更新與移除都能沿用既有流程。官方 README 也列出同名 brew install opencode，但註明官方公式更新可能較慢；團隊要把來源寫進文件，避免不同成員安裝到不同供應路徑。
Windows：Scoop、Chocolatey、桌面版與 WSL
官方 README 列出 Windows 的 Scoop 與 Chocolatey：
“powershell scoop install opencode choco install opencode “
兩者擇一即可。若偏好圖形介面，官方文件提供 Windows x64 桌面版下載；若團隊已在 WSL 使用 Linux 工具鏈，也可以在 WSL 內依 Linux 路徑安裝，再確認工作目錄、檔案權限與 shell PATH。
Windows 的排錯重點是「你在哪個環境執行」。PowerShell、CMD、Git Bash、WSL 與桌面版可能各自有不同 PATH 與設定檔。先執行 where.exe opencode 或在 WSL 執行 which opencode，再確認版本，避免把一個環境的安裝問題誤判成另一個環境的問題。
Arch Linux 與其他路徑
官方 README 列出 Arch Linux 的 sudo pacman -S opencode、AUR 的 paru -S opencode-bin、mise 與 Nix 路徑。這些選項適合已經用相應套件管理器管理系統的使用者；不要為了追求最新版本，在穩定工作環境中混入未審查的第三方包。
選擇原則是把供應來源、更新責任、簽章／套件信任與回滾方式寫清楚。對個人實驗可以快速安裝，對團隊與 CI 則應鎖定版本、記錄 checksum 或使用已批准的 registry。
安裝後的最小驗證流程
“sh opencode --version opencode “
如果第一行失敗，檢查 binary 路徑、shell PATH、runtime 與套件管理器輸出；如果第二行能啟動但不能完成工作，接著檢查 provider 登入、API key／帳單、模型可用性與專案權限。不要把「命令能啟動」當成完整驗收。
接著在一個可丟棄的測試專案中確認它能讀取檔案、顯示差異、遵守 plan／build 工作模式，並在必要時阻止寫入。正式專案先設定版本、備份與 git 工作樹，再讓 agent 執行修改。
Provider 與權限要另外檢查
OpenCode 的文件列出多種模型供應商與登入方式；provider 是否可用，會依帳戶、方案、地區、API key、模型名稱與上游政策變動。安裝文章可以提供驗證方向，但不應保證某個方案在所有帳戶都能使用。
安全上，先在低權限、可回復的專案測試。不要把 API key 寫進 git、公開 issue 或 shell history；用環境變數、系統金鑰圈或團隊批准的 secret manager 管理。agent 若能執行 shell 命令，工作目錄、網路、檔案與外部服務權限都應該被明確限制。
更新、移除與多版本排錯
先記錄安裝方式，再使用同一個來源更新：腳本安裝就重跑官方腳本，npm 就使用 npm，brew 就使用 brew。若改用另一種方式，先移除或停用舊 binary，再用 which／where 找出實際執行檔。
最常見的問題不是 OpenCode 本身，而是 PATH 優先順序。可以依序檢查：opencode --version、which opencode、套件管理器的安裝清單、shell 啟動檔，以及是否在 WSL／容器／IDE 內使用另一個環境。把輸出與版本記錄下來，後續回報才有足夠證據。
常見誤讀與限制
第一，安裝成功不代表 provider、模型、帳單與權限已設定完成。
第二，npm、Bun、Homebrew、腳本與 Windows 套件管理器不要同時安裝多份，否則 PATH 會造成版本混淆。
第三，桌面版、PowerShell、WSL 與終端機可能使用不同設定與檔案環境。
第四，OpenCode 能協助修改程式，不代表它的輸出免於測試、程式碼審查、秘密掃描與版本控制。
FAQ：OpenCode 安裝
macOS 最推薦哪一種？
若已使用 Homebrew，brew install anomalyco/tap/opencode 容易更新；想使用官方腳本則可執行 curl -fsSL https://opencode.ai/install | bash。團隊應統一來源。
Windows 一定要裝 WSL 嗎？
不一定。官方文件提供 Windows 桌面版與 Scoop／Chocolatey；已有 Linux 工作流的人才可能選 WSL。
npm 和 Bun 可以同時裝嗎？
可以但不建議把兩份都當主要版本。多份 global binary 容易造成 PATH 與更新來源不一致，先選一個並記錄版本。
opencode --version 找不到怎麼辦？
先用 which opencode 或 where.exe opencode 查路徑，再檢查安裝輸出、PATH、shell 重載與 runtime 的 global bin 位置。
相關 Yololab 文章
官方資料與延伸閱讀
分享此文：
KEEP READING
接著讀什麼？
從同一主題繼續閱讀，或回到 YOLO LAB 的完整文章索引，找到下一個值得投入時間的問題。
發表迴響