OpenCode 是一款開源程式碼代理工具，可在您的終端機中執行、讀取專案內容、編輯檔案並執行指令。

Ollama 會將 OpenCode 設定為使用本地與雲端模型。

快速開始

使用 Ollama 啟動 OpenCode：

ollama launch opencode

功能

聊天

詢問專案或任務相關問題

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="terminal" /></div>
  <div>
    <div class="capability-list-heading">命令列</div>
    <div class="capability-list-copy">從您的工作目錄執行指令</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="code" /></div>
  <div>
    <div class="capability-list-heading">檔案編輯</div>
    <div class="capability-list-copy">讀取並編輯專案中的檔案</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="users" /></div>
  <div>
    <div class="capability-list-heading">子代理</div>
    <div class="capability-list-copy">將工作拆分至多個任務執行</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="file-text" /></div>
  <div>
    <div class="capability-list-heading">網頁擷取</div>
    <div class="capability-list-copy">擷取並摘要網頁內容</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="image" /></div>
  <div>
    <div class="capability-list-heading">視覺辨識</div>
    <div class="capability-list-copy">傳送圖片與截圖</div>
  </div>
</div>

模型選擇

請選擇上下文長度足夠容納您專案的模型。

cloud雲端模型

無需下載即可使用大型模型。

hard-drive本地模型

選擇模型並設定 64k 以上的上下文視窗。

注意

OpenCode 需要 64k 或更高的上下文長度。詳情請參閱上下文長度。

手動設定

1. 安裝 OpenCode

curl -fsSL https://opencode.ai/install | bash

npm install -g opencode-ai

2. 將 Ollama 設為提供者

將 Ollama 提供者新增至 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3.5": {
          "name": "qwen3.5"
        }
      }
    }
  }
}

3. 執行 OpenCode

opencode

若要在不啟動互動式工作階段的情況下，使用 Ollama 設定 OpenCode：

ollama launch opencode --config

設定優先順序

ollama launch opencode 會使用所選 Ollama 模型的內嵌設定啟動 OpenCode，不會覆寫 ~/.config/opencode/opencode.json；現有的 OpenCode 設定仍然會生效。

僅在 opencode.json 中定義的模型不會出現在 ollama launch 的模型選擇器中。

詳情請參閱 OpenCode 的設定優先順序。