Windows 上用 OpenCode 寫程式：從零開始的完整安裝指南（2025）

Mon, 08 Jun 2026 14:30:00 +0800

前言

如果你最近混程式圈，應該聽過 OpenCode 這名字。這個開源 AI coding agent 在 GitHub 上已經突破了 17 萬顆星，被譽為「終端機裡最強的人工智慧程式助手」。

簡單來說，OpenCode 讓你用自然語言跟 AI 對話，它就能幫你讀程式碼、寫功能、修 bug、做 code review——而且一切發生在你熟悉的終端機介面裡。

對於 Windows 使用者來說，OpenCode 的安裝方式有幾種選擇，官方也建議使用 WSL（Windows Subsystem for Linux）來獲得最佳體驗。但這篇文章就是要從零開始，帶你一步步把 OpenCode 裝好、設定好、跑起來。

不管你是完全沒碰過 terminal 的小白，還是想嘗試新工具的開發者，這篇都會讓你一次上手。

在深入安裝之前，先簡單認識一下 OpenCode 到底是什麼。

OpenCode 是一個開源的 AI coding agent，由 Anomaly Co 開發。它提供三種使用方式：

它的核心特色是「雙 Agent 架構」：

Mon, 08 Jun 2026 10:30:00 +0800

OpenCode 這個開源 AI Coding Agent 最近在 GitHub 上爆紅，星數已經突破 160K。但很多新手裝好之後就直接開始 opencode run，結果遇到各種問題：token 爆炸、模型選錯、工具亂開、MCP server 連不上……

其實 OpenCode 的設定檔 opencode.jsonc 提供了超多進階選項，只要設對，效能和體驗可以直接提升好幾個等級。

這篇文章我會整理 10 個最重要的設定項目，幫你一次搞定 OpenCode 的最佳化配置。

很多人在寫 opencode.jsonc 的時候都沒有加 schema，結果編輯器無法提供自動補完和語法檢查。

{
 "$schema": "https://opencode.ai/config.json",
 // ... 你的設定
}

加上這行之後，VS Code 或其他支援 JSON Schema 的編輯器就能自動提示可用的設定項目，再也不怕打錯欄位名稱。

OpenCode 支援雙模型設定：model 負責主要編碼任務，small 負責輕量任務（像是自動產生對話標題、簡短摘要等）。