OpenCode 是一个在终端中运行的开源编程代理（coding agent），它可以读取您的项目、编辑文件并执行命令。

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

```shell macOS / Linux curl -fsSL https://opencode.ai/install | bash ```

npm install -g opencode-ai

2. 将 Ollama 配置为提供商

在 opencode.json 中添加 Ollama 提供商：

{
  "$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

若要在不启动交互式会话的情况下配置 OpenCode 与 Ollama 的连接：

ollama launch opencode --config

配置优先级

ollama launch opencode 将使用选定 Ollama 模型的内联配置（inline config）启动 OpenCode。它不会覆盖 ~/.config/opencode/opencode.json；现有的 OpenCode 设置仍然有效。

仅在 opencode.json 中定义的模型不会出现在 ollama launch 的模型选择器中。

请参阅 OpenCode 的 配置优先级。