Windows 可以用嗎？

可以。npm(npm i -g opencode-ai)可在 Windows 的 PowerShell 執行,WSL 內也能使用 curl 安裝。原生 Windows 的細節請至 opencode.ai 確認最新資訊。

需要 API 金鑰嗎？

需要。OpenCode 採自備金鑰(BYO)方式,安裝後用 opencode auth login 加入供應商,金鑰儲存在本機。也可用 OAuth 連接 GitHub Copilot 或 ChatGPT 以沿用既有訂閱。

重新執行安裝方式即可:npm 用 npm i -g opencode-ai@latest,Homebrew 用 brew upgrade opencode,再以 opencode --version 確認。

教學

OpenCode 是免費、開源的終端機型 AI 編碼代理。本文從安裝、供應商認證到第一次執行,以步驟方式說明。指令以 OpenCode v1.17.8(2026-06-20)驗證。

步驟

macOS / Linux 可用 curl 腳本或 Homebrew;所有作業系統(含 Windows)用 npm 最方便。

# 所有 OS(需 Node 18+)
npm i -g opencode-ai

# macOS / Linux
curl -fsSL https://opencode.ai/install | bash
brew install anomalyco/tap/opencode

2. 確認安裝
顯示版本以確認 PATH 設定正確(顯示 1.17.8 以上即可)。
```
opencode --version
```
3. 認證模型供應商
OpenCode 不綁定特定模型。用登入指令加入第一個供應商(Anthropic、OpenAI、Google 等),金鑰會儲存在本機。
```
opencode auth login
```

可啟動互動式 TUI、執行單次無頭任務,或啟動伺服器模式。

# 互動式 TUI
opencode

# 單次任務
opencode run "說明這個專案在做什麼"

# 伺服器模式
opencode serve

常見問題

Windows 可以用嗎？: 可以。npm(npm i -g opencode-ai)可在 Windows 的 PowerShell 執行,WSL 內也能使用 curl 安裝。原生 Windows 的細節請至 opencode.ai 確認最新資訊。
需要 API 金鑰嗎？: 需要。OpenCode 採自備金鑰(BYO)方式,安裝後用 opencode auth login 加入供應商,金鑰儲存在本機。也可用 OAuth 連接 GitHub Copilot 或 ChatGPT 以沿用既有訂閱。
如何更新？: 重新執行安裝方式即可:npm 用 npm i -g opencode-ai@latest,Homebrew 用 brew upgrade opencode,再以 opencode --version 確認。