OpenCode 完整指南：安裝、設定並打造可重複使用的技能
一份實用的 OpenCode 指南，涵蓋安裝、模型連線、技能設定、Windows/WSL 注意事項、AGENTS.md、opencode.jsonc，以及可重複使用的 AI 程式開發工作流程。
OpenCode 最被低估的部分，不在於它是否能幫你寫程式碼。
真正的問題是，它是否能把重複的開發動作轉化為可重複使用的工作流程。安裝一次。設定模型。加入專案規則。接著使用 Skills 定義某項任務應該如何被處理。這就是 AI 不再像一位新隊友一樣，需要你一次又一次解釋相同背景脈絡的方式。
原文有一條清楚的路徑：先讓 OpenCode 跑起來，然後設定 Skills。這次改寫保留了這個結構，同時依照目前官方文件更新安裝與設定邏輯。
對 We0ai 這樣的平台來說，這很重要，因為 AI 程式代理不只是用來寫程式碼。它們可以幫助團隊把網站、元件、SEO/GEO 頁面與成長實驗，串接到更大的 Build -> Showcase -> Grow -> Leads 工作流程中。
OpenCode 是什麼：不是聊天視窗，而是終端機裡的 AI 程式代理
OpenCode 最適合被理解為開發者使用的 AI 程式代理。它可以在終端機中執行，也可透過桌面版與 IDE 相關體驗使用。和一般聊天機器人相比，它更接近一位工程助理，可以讀取專案、理解脈絡、編輯檔案，並協助除錯。
這也是它很適合搭配 Skills 的原因。你不必每次都問「幫我寫這個函式」，而是可以為發行說明、SEO 頁面審查、測試修復、Pull Request 檢查與程式碼審查定義可重複的行為。
步驟 1：安裝 OpenCode
原始圖片：OpenCode 官方安裝入口。
原始圖片：在 Windows Terminal 中使用 npm 全域安裝 OpenCode。
原始圖片：啟動後的 OpenCode 終端機介面。
官方文件將安裝腳本列為最簡單的起點。你也可以使用 npm、Bun、pnpm、Yarn、Homebrew 或其他套件管理器安裝 OpenCode。對許多前端與全端開發者來說，npm 仍然是最熟悉的入口。
# 建議：官方安裝腳本 curl -fsSL https://opencode.ai/install | bash # 使用 Node.js 安裝 npm install -g opencode-ai # 啟動 opencode
Windows 使用者應該留意環境。如果你的工作流程依賴終端機工具、相依套件、Git 與 shell scripts，WSL 通常會是更順暢的選擇。直接在 Windows 上執行也可行，但類 Linux 環境通常能減少路徑與權限上的摩擦。
步驟 2：連接模型，而不是盲目相信預設值
原始圖片：在 OpenCode 中查看並切換模型。
原始圖片：選擇模型後開始第一次對話。
模型選擇是許多首次使用者卡住的地方。不要只依照「免費」或「最強」來選。先從你需要處理的工作類型開始。
官方文件建議在 TUI 中使用 /connect 來連接你的供應商。金鑰設定完成後，開啟專案目錄並在該處啟動 OpenCode。
# 在 OpenCode TUI 中連接供應商 /connect # 在專案中啟動 cd your-project opencode
步驟 3：使用 opencode.jsonc 管理設定
預設設定已足夠用於快速測試。但如果你希望 OpenCode 成為長期工作流程的一部分，設定檔就很重要。OpenCode 支援 JSON 與 JSONC 設定，也可以合併使用全域與專案設定。
{ "$schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4-5", "autoupdate": true, "permission": { "edit": "ask", "bash": "ask" }, "instructions": [ "AGENTS.md" ] }
目標不是讓設定看起來很複雜。目標是讓工作邊界清楚：要使用哪個模型、更新如何運作、哪些動作需要核准，以及必須讀取哪些專案規則。
步驟 4：理解 Skills，也就是可重複使用行為的核心
原始圖片：官方 Anthropic Skills 儲存庫。
原始圖片：一個中文社群的 Agent Skills Marketplace。
Skill 不只是另一個資料夾。它是給 AI 助理使用的可重複利用指令套件。你會描述某個特定任務應該如何被判斷、執行與回傳。接著 OpenCode 就能在有用的時候載入這種行為。
根據官方文件，OpenCode 會在專案層級的 .opencode/skills、全域的 ~/.config/opencode/skills，以及相容的 Claude / Agents 技能目錄中搜尋 Skills。
# 專案層級 Skill your-project/ .opencode/ skills/ seo-page-review/ SKILL.md # 全域 Skill ~/.config/opencode/skills/ release-notes/ SKILL.md
一個最小可用的 SKILL.md 通常需要 name 和 description。name 應該簡短、使用小寫，並以連字號分隔。description 則應該夠明確，讓代理程式知道什麼時候要載入它。
--- name: seo-page-review description: Review a showcase website page for SEO, GEO, trust signals, and lead conversion. compatibility: opencode --- ## 要檢查的項目 - 搜尋意圖與頁面結構 - 信任訊號與證明 - 潛在客戶收集路徑 - 內部連結與轉換清晰度
步驟 5：Windows 全域 Skill 設定
原始圖片：Windows 使用者目錄下的 OpenCode skills 資料夾。
原始圖片：skills 目錄中的多個 Skill 資料夾。
原始圖片：使用 skill list 檢查已載入的 Skills。
原始圖片：OpenCode 自動匹配 frontend-design Skill。
原始圖片：Skill 被觸發後產生的頁面程式碼與結構化輸出。
原始圖片：OpenCode 產生的最終網頁預覽。
原文著重於 Windows 上的全域 Skill 設定。這個概念很實用：如果每個專案都應該使用同一個 Skill，就把它放在使用者層級的目錄中。如果該 Skill 只用於單一專案，就把它保留在專案層級。
一個簡單規則很有幫助：如果 Skill 代表團隊知識，就把它放在儲存庫中。如果它只是你的個人習慣，就把它保留為全域設定。
步驟 6：不要隨意混用 AGENTS.md、Skills 和設定檔
許多團隊會把所有內容都塞進一個混亂的指令檔。這會讓助理更難控制。更乾淨的做法是分離職責。
簡單來說：AGENTS.md 用於長期專案規則，Skills 用於特定且可重複執行的任務，而 opencode.jsonc 用於執行階段設定。
OpenCode 與 We0ai：建置層遇上成長層
OpenCode 主要協助 Build 層：程式碼、重構、腳本、專案規則，以及可重複利用的開發工作流程。We0ai 則聚焦於 Showcase 與 Growth：把產品、服務、案例、範本、內容和 SEO/GEO 頁面，轉化為能被找到、能被 AI 搜尋理解，並能轉換為潛在客戶的展示型網站。
它們並不是彼此的替代品。實務上的做法是使用 OpenCode 改善開發與內容工程工作流程，同時使用 We0ai 將最終網站變成面向使用者與搜尋流量的成長資產。
最後重點
OpenCode 並不難安裝。真正的問題是你是否把它視為長期工作流程工具。
如果你只是安裝它，你會得到一個 AI 程式設計助理。如果你設定模型與權限，你會得到一個更穩定的專案助理。如果你善用 Skills、AGENTS.md 和 opencode.jsonc，你會得到一套可重複利用、可跨專案移動，並可由團隊共享的 AI 開發系統。
對於正在建置展示型網站、SEO/GEO 頁面、產品案例頁面和成長實驗的團隊來說，這很重要。網站成長並不會停在頁面生成。它需要程式碼、內容、元件與工作流程持續改進。
這也是 We0ai 背後的邏輯：Build -> Showcase -> Grow -> Leads。建置資產、展示價值、提升能見度，並將關注轉化為潛在客戶與客戶。
CTA：如果你的網站不只是需要上線，請把開發工作流程與展示成長路徑一起設計。
常見問題
什麼是 OpenCode？
OpenCode 是一款給開發者使用的 AI 程式碼代理工具。它可在終端機中協助進行程式碼理解、編輯、生成與專案協作。
我要如何安裝 OpenCode？
你可以使用官方安裝腳本，或透過 npm install -g opencode-ai 安裝。
OpenCode Skills 的用途是什麼？
Skills 可封裝可重複使用的任務指令，例如程式碼審查、SEO 頁面審查、版本說明，以及測試修復工作流程。
Skills 應該放在哪裡？
常見路徑包括 .opencode/skills/<name>/SKILL.md 和 ~/.config/opencode/skills/<name>/SKILL.md。
AGENTS.md 和 SKILL.md 有什麼差別？
AGENTS.md 較適合長期專案規則，而 SKILL.md 較適合特定且可重複執行的任務工作流程。
這與 We0ai 有什麼關係？
OpenCode 支援建置層，而 We0ai 支援展示與成長。兩者結合可串連程式碼、內容、SEO/GEO 與潛在客戶轉換。
相關工具
- OpenCode
- Node.js
- npm
- We0ai
來源