代理式編程已超越自動補全的範疇：現代工具可以規劃任務、編輯多個檔案、執行指令，並在失敗時循環重試，直到得出真正可用的結果。OpenCode 是一款開源、模型無關的編程代理，你可以在終端機執行（也可作為桌面應用程式或 IDE 擴充功能使用），是在自身環境中嘗試這類工作流程的實用選擇。
💡 在本指南中，你將學會：
- 透過 Novita AI 的 API 將 Kimi K2.5 連接至 OpenCode
- 在你偏好的介面（終端機/桌面/IDE）中安裝並準備好使用 OpenCode
- 建立一個小型示範專案。
什麼是 OpenCode？
OpenCode 是一款開源 AI 編程代理，你可以在多種開發者環境中執行——最常見的是作為終端機介面（CLI + TUI），也可作為桌面應用程式或 IDE 擴充功能使用。
OpenCode 與 Claude Code 的差異
OpenCode 和 Claude Code 都是終端機型 AI 編程代理，但兩者的發展路徑不同。
- OpenCode 是一款開源、供應商無關的代理：它強調支援「透過 Models.dev 連接 75 家以上的 LLM 供應商（包含本地模型）」，定位為可靈活連接不同模型後端的工具。
- 相比之下，Claude Code 是 Anthropic 官方推出的 Claude 優先 CLI——一款可在終端機存取 Claude 模型的指令行工具，同時透過 MCP 提供官方擴充功能（插件）與工具/資料連接的生態系統。
快速比較表
| 面向 | OpenCode | Claude Code |
|---|---|---|
| 定位 | 開源、多模型終端機編程代理 | Anthropic 官方推出的 Claude 優先終端機編程代理 |
| 模型/供應商選擇 | 透過 Models.dev 支援 75 家以上的 LLM 供應商，包含本地模型 | 以 Claude 為核心；可透過 MCP + 插件擴充 |
| GitHub 自動化 | /opencode 或 /oc 評論觸發；可在 GitHub Actions 執行器上運行 |
擴充功能側重於插件/MCP（官方生態系統） |
| 定價入門點 | 工具本身開源；成本取決於你選擇的模型後端 | Claude 方案（Pro/Max/Team/Enterprise） |
為什麼選擇 Kimi K2.5？
Kimi K2.5 是一款單一開源模型，整合了原生多模態、真實工具執行與大規模代理協調能力。模型基於約 15T 混合視覺-文本標記訓練，涵蓋圖像/影片理解、程式碼生成與視覺除錯功能。
資料來源：Kimi
實用重點
- 代理基準測試優於 GPT-5.2、Claude 4.5 Opus 和 Gemini 3 Pro：從圖表可見，Kimi K2.5 在代理評估套件中領先：HLE-Full 50.2、BrowseComp 74.9、DeepSearchQA 77.1。在 BrowseComp 測試中，K2.5 高於 GPT-5.2（65.8）、Claude 4.5 Opus（57.8）和 Gemini 3 Pro（59.2），非常適合需要瀏覽、蒐集證據與迭代優化的長時程任務。
- 在多語言場景下具備競爭力的程式碼庫級編程能力：K2.5 在 SWE-Bench Verified 中獲得 76.8 分，SWE-Bench Multilingual 中獲得 73.0 分。雖然 Claude 4.5 Opus 在 Verified 測試中略高（80.0 分），Gemini 3 Pro 也領先於此（80.9 分），但 K2.5 仍保持強勁競爭力，且在多語言場景中脫穎而出——高於 GPT-5.2（72.0 分），大幅領先 Gemini 3 Pro（65.0 分），這對於混合語言程式碼庫的多檔案修補非常重要。
- 針對開發者工作流程的強大圖像理解能力（文件、圖表、UI）：在各項圖像基準測試中，K2.5 始終處於頂尖水準：MMMU Pro 78.5、MathVision 84.2、OmniDocBench 1.5 88.8——支援閱讀技術 PDF、解析圖表、將視覺需求轉為程式碼等實用任務。
- 有助於實際產品迭代的影片推理能力：在影片任務中，K2.5 在 VideoMMMU 中獲得 86.6 分，LongVideoBench 中獲得 79.8 分，顯示其更強的長上下文影片理解能力——非常適合分析產品演示、除錯 UI 錄影，或從操作導覽中提取需求。
如何安裝 OpenCode
OpenCode 提供多種安裝選項，最快速的是單行安裝腳本，最便於攜帶的是安裝 npm 套件。
macOS / Linux
推薦：
curl -fsSL https://opencode.ai/install | bash
或（跨平台）：
npm install -g opencode-ai
# or
bun add -g opencode-ai
啟動：
opencode
Windows
推薦：
npm install -g opencode-ai
# or
bun add -g opencode-ai
curl | bash需要 bash 環境（WSL 或 Git Bash）。在 PowerShell/CMD 中，請使用 npm/bun。
啟動：
opencode
如何在 OpenCode 中使用 MiniMax M2.1
在 Novita AI 取得 API 金鑰
- 步驟 1：建立帳號或登入 造訪
[https://novita.ai](https://novita.ai)註冊或登入。 - 步驟 2：前往金鑰管理頁面 登入後，找到「API Keys」選項。
- 步驟 3：建立新金鑰 點擊「Add New Key」按鈕。
- 步驟 4：立即儲存你的金鑰 金鑰生成後請立即複製儲存，通常只會顯示一次。
將 Novita API 金鑰加入 OpenCode
- 啟動 OpenCode：
opencode
- 在 OpenCode 提示列中執行：
/connect
- 搜尋並選擇 Novita AI，接著貼上你的 Novita API 金鑰。
- 選擇 Kimi K2.5（模型 ID：
moonshotai/kimi-k2.5）。
完成！OpenCode 會將代理請求透過 Novita AI 的 API 路由，使用你選擇的模型進行處理。
建立你的第一個專案：Woolf Stream
為了讓示範專案直觀易懂（也方便截圖分享），我們將建立一個單頁式網頁應用程式：Woolf Stream。使用者上傳圖片、選擇數個創作控制項後，應用程式會呼叫 Novita AI 相容 OpenAI 的聊天端點，使用支援圖像輸入的 Kimi K2.5 生成純文字的意識流散文，靈感來自 20 世紀初的現代主義技巧，且不會直接引用或逐字模仿維吉尼亞·吳爾夫的文風。
專案功能說明
- 一個使用 TypeScript + TailwindCSS 的單頁式 Next.js 14（App Router）示範專案
- API 金鑰面板（密碼輸入框 + 顯示/隱藏切換、儲存/清除至 localStorage；絕不硬編碼）
- 拖曳上傳圖片（png/jpg）功能，包含預覽與客戶端 base64 資料網址轉換
- 控制項：
- 長度預設值：150 / 300 / 600 / 1000 字
- 語調滑桿：夢幻 ↔ 銳利
- 聚焦下拉選單：感官 / 記憶 / 時間 / 社會凝視
- 生成流程：
- 「生成散文」按鈕在API 金鑰 + 圖片齊全前維持停用狀態
- 載入指示器 + 錯誤面板，顯示 HTTP 狀態碼 + 疑難排解提示
- 輸出內容：
- 帶有生成散文的閱讀卡片
- 複製按鈕 + 下載 .txt 檔案
- 「顯示使用的提示詞」手風琴元件（用於提高透明度與可重現性）
切換至建構模式並執行
在 OpenCode 中切換至 建構模式，接著貼上以下提示詞。
提示詞
建立一個單頁式示範專案，使用 Next.js 14（App Router）+ TypeScript + TailwindCSS。
目標：使用者上傳圖片（png/jpg 格式）。應用程式將圖片發送至相容 OpenAI 的聊天端點（支援圖像輸入），生成一篇受維吉尼亞·吳爾夫現代主義技巧啟發的優美意識流散文，僅輸出文字。
API 需求（嚴格要求）：
- 相容 OpenAI 的自訂 base URL：https://api.novita.ai/openai
- 模型：moonshotai/kimi-k2.5
- 使用者輸入自己的 API 金鑰（密碼欄位 + 顯示/隱藏切換）。僅儲存於 localStorage，絕不硬編碼。
- 請求需包含
Authorization: Bearer {userKey}標頭。UI 需求：
- 莫內 / 睡蓮風格 UI：柔和粉彩色調、紙張質感、細膩筆觸漸層背景、溫和發光陰影、圓角卡片、微小的波紋懸停動畫。響應式設計，適配行動裝置。
- 元件：API 金鑰儲存/清除、拖曳上傳 + 預覽、控制項：長度（150/300/600/1000 字）、語調滑桿（夢幻↔銳利）、聚焦下拉選單（感官/記憶/時間/社會凝視）、生成按鈕（缺少金鑰或圖片時停用）、載入指示器、錯誤面板。
- 輸出內容：閱讀卡片中渲染的散文 + 複製按鈕 + 下載 .txt + 「顯示使用的提示詞」手風琴元件。
多模態呼叫（必須實現）：
- 使用
POST /v1/chat/completions端點。- 發送的訊息中
content為陣列，需同時包含以下兩種內容：{type:"text", text:"...instructions..."}{type:"image_url", image_url:{url:"data:image/png;base64,...."}}
- 顯示模型的文字回應。
寫作限制（重要）：
- 生成受 20 世紀初現代主義意識流啟發的原創散文（抒情節奏、內在性、感官細節、聯想跳躍、流動的時間感）。
- 不得引用或重現任何吳爾夫的文本，不得聲稱自己是吳爾夫，不得有直接的戲仿句子。
- 貼合圖片：反映構圖、光線、顏色、氛圍、隱含的動態；保留主體位置。
- 輸出：一段連續的文字（最多 1-3 段）。不得使用項目符號，不得包含分析。
交付內容：
- 完整可執行的程式碼 + 檔案結構。
- 可注入
base_url和使用者金鑰的 API 包裝函式。- 客戶端圖片 -> base64 資料網址轉換功能。
- 清晰的錯誤提示，包含 HTTP 狀態碼與疑難排解提示。
本地執行
OpenCode 生成專案後，執行以下指令：
npm install
npm run dev
開啟 Next.js 印出的本地網址（通常為 http://localhost:3000），並確認以下功能正常：
- 頁面呈現出莫內 / 睡蓮的視覺風格
- API 金鑰儲存/清除功能正常（僅儲存於 localStorage），顯示/隱藏切換正常運作
- 拖曳上傳功能正常，預覽區域顯示所選圖片
- 在API 金鑰 + 圖片齊全前，「生成散文」按鈕維持停用狀態
- 生成的散文為純文字、1-3 段，且明顯貼合圖片內容
- 複製 + 下載
.txt功能正常 - 「顯示使用的提示詞」功能可顯示實際發送的完整提示詞
- 錯誤（金鑰無效/網路問題）會顯示 HTTP 狀態碼與清晰的提示
超越終端機的 OpenCode：桌面應用程式與 IDE 整合
OpenCode 通常用於終端機，但你也可以將其作為桌面應用程式（Beta 版）執行，或嵌入 IDE 中使用——這兩種情況下都可以繼續使用 Novita AI 相容 OpenAI 的 API。介面會有所不同，但模型/供應商的設定保持不變：選擇 minimax/minimax-m2.1。
桌面應用程式
OpenCode 的桌面版本適用於 macOS、Windows 和 Linux。如果你偏好使用獨立介面執行較長的代理工作階段，桌面應用程式是非常好的選擇——而且它可以沿用你先前為 Novita AI 建立的供應商設定。
IDE 整合
OpenCode 提供以下官方整合流程：
- VS Code
- Cursor
- Zed
- Windsurf
- VSCodium
結論
OpenCode 讓你能輕鬆採用代理式工作流程，無需被單一供應商綁定。透過 Novita AI 上的 Kimi K2.5，你可以獲得適合程式碼庫級迭代與多模態開發任務的實用設定——無論是從終端機（或桌面/IDE）使用，都能沿用相同的 API 設定。
Novita AI 是一個 AI 雲端平台，為開發者提供簡單的 API 介面，方便部署 AI 模型，同時也提供實惠且可靠的 GPU 雲端服務，用於建構與擴展 AI 應用。
常見問題
什麼是 OpenCode？
OpenCode 是一款開源 AI 編程代理框架，可讓大型語言模型在真實開發環境中編寫、執行和除錯程式碼，加速端到端的專案建構。
誰是 OpenCode 的所有者？
OpenCode 並非由 Claude 或 Gemini 所屬的大型 AI 實驗室擁有。這是由 OpenCode 團隊/社群維護的開源專案，開發工作由 opencode.ai 的創建團隊主導。沒有專屬的「模型所有者」——該專案設計為供應商無關，獨立於任何單一 LLM 供應商。
OpenCode 比 Claude 更好嗎？
OpenCode 並非嚴格意義上「比 Claude Code 更好」——兩者定位不同。OpenCode 是開源且模型無關的，如果你希望在單一代理工作流程中擁有靈活性、自由執行多個模型（例如透過 Novita AI 使用 Kimi K2.5），OpenCode 是更好的選擇；而如果你完全投入 Claude 生態系統，Claude Code 作為 Anthropic 官方推出的 Claude 優先 CLI，能提供最流暢的使用體驗。
OpenCode 安全嗎？
是的，OpenCode 不會儲存任何你的程式碼或上下文資料，因此可以在注重隱私的環境中運作。
OpenCode 是免費的嗎？
OpenCode 是少數會讓你停下腳步的開源工具之一。它目前在 GitHub 上擁有超過 8 萬顆星星，人氣位居前列——試用過後你就會明白這股勢頭從何而來。它本質上和 Claude Code 同屬 AI 編程代理，但完全免費且開源。
