OpenCode

基于 Go 的开源终端编程助手。把 BeansAI 配置为自定义 provider。

概览

OpenCode 是一个完全开源的终端编程工具，基于 Bubble Tea 构建 TUI 界面。它读取opencode.json 配置文件，支持自定义 AI provider——把它指向 BeansAI，即可从终端访问 Claude、GPT 和目录里的所有其他模型。

安装

根据平台选择对应的安装方式：

macOS / Linux (install script)

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

All platforms via npm (recommended for Windows)

npm i -g opencode-ai@latest

macOS via Homebrew

brew install --cask opencode-desktop

配置

第一步 — 注册 BeansAI 为 provider。运行 auth 命令，从列表中选择other：

shell

# Select "other" from the provider list when prompted
opencode auth login

按提示输入：Provider ID：beansai（必须与下方配置文件中的 key 一致），以及你的 BeansAI API 密钥。

第二步 — 写入配置文件。创建或编辑 ~/.config/opencode/opencode.json（Windows：%USERPROFILE%\.config\opencode\opencode.json）：

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "beansai": {
      "npm": "@ai-sdk/anthropic",
      "name": "BeansAI",
      "options": {
        "baseURL": "https://api.beansai.dev/v1"
      },
      "models": {
        "claude-opus-4-7": {
          "name": "Claude Opus 4.7"
        },
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6"
        },
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        }
      }
    }
  }
}

JSON 中的 provider key（"beansai"）必须与执行 opencode auth login 时输入的 Provider ID 完全一致。baseURL 末尾必须带 /v1。

基础用法

shell

cd your-project
opencode

在 TUI 里使用 /models 列出已配置的 provider 并切换模型。用自然语言输入需求—— OpenCode 会读取项目文件并直接应用修改。

使用技巧

在配置的 models 块里添加更多模型——BeansAI 目录里的任意模型 ID 都有效。
想同时使用 GPT 模型，可以添加第二个 provider 块，使用 "npm": "@ai-sdk/openai" 并配一个独立的 API 密钥。
OpenCode 内置 LSP 集成，能感知编辑器里的类型错误和诊断信息，并自动修复。
用 /sessions 按项目保存和恢复对话历史。

配置

第一步 — 注册 BeansAI 为 provider。运行 auth 命令，从列表中选择other：

shell

# Select "other" from the provider list when prompted
opencode auth login

按提示输入：Provider ID：beansai（必须与下方配置文件中的 key 一致），以及你的 BeansAI API 密钥。

第二步 — 写入配置文件。创建或编辑 ~/.config/opencode/opencode.json（Windows：%USERPROFILE%\.config\opencode\opencode.json）：

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "beansai": {
      "npm": "@ai-sdk/anthropic",
      "name": "BeansAI",
      "options": {
        "baseURL": "https://api.beansai.dev/v1"
      },
      "models": {
        "claude-opus-4-7": {
          "name": "Claude Opus 4.7"
        },
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6"
        },
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        }
      }
    }
  }
}

JSON 中的 provider key（"beansai"）必须与执行 opencode auth login 时输入的 Provider ID 完全一致。baseURL 末尾必须带 /v1。

使用技巧

在配置的 models 块里添加更多模型——BeansAI 目录里的任意模型 ID 都有效。
想同时使用 GPT 模型，可以添加第二个 provider 块，使用 "npm": "@ai-sdk/openai" 并配一个独立的 API 密钥。
OpenCode 内置 LSP 集成，能感知编辑器里的类型错误和诊断信息，并自动修复。
用 /sessions 按项目保存和恢复对话历史。