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 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 和設定檔

Gratuit · Utiliser We0 AI

Creez un site vitrine et genere des leads en quelques minutes

Decrivez votre idee une fois, et We0 AI peut generer un site vitrine, des pages et un CMS, puis vous aider a attirer clients et trafic apres le lancement.

Une génération de projet complète pour une inscription gratuite

Idéal pour essayer un flux de génération complet et voir rapidement une première ébauche de projet.

Sans titre-1