OpenCode

终端 AI 编程 Agent,支持 JSON 配置文件和 /connect 交互式命令,兼容 OpenAI SDK 协议。

配置文件OpenAI

安装

terminal
go install github.com/sst/opencode@latest

需要 Go 1.22+。也支持通过 brew 安装。

配置步骤

  1. 1

    安装 OpenCode

    通过 go install 安装。需要 Go 1.22+。

    terminal
    go install github.com/sst/opencode@latest
  2. 2

    创建配置文件

    在项目根目录创建 opencode.json(项目级),或在 ~/.config/opencode/config.json 创建用户级配置。

    opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "silvamux-gateway": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "千木(SilvaMux)",
          "options": {
            "baseURL": "https://api.example.com/v1",
            "apiKey": "sk-your-api-key"
          },
          "models": {
            "deepseek-v3.2": {
              "name": "DeepSeek V3.2",
              "limit": { "context": 128000, "output": 8192 }
            },
            "claude-sonnet-4-20250514": {
              "name": "Claude Sonnet 4",
              "limit": { "context": 200000, "output": 8192 }
            }
          }
        }
      }
    }

    API Key 可用 {env:VAR_NAME} 语法引用环境变量,避免在配置文件中明文存储密钥。

  3. 3

    启动 OpenCode

    在项目目录下运行 opencode 命令。

    terminal
    # 进入项目目录
    cd /path/to/your/project
    
    # 启动
    opencode
  4. 4

    (可选)交互式配置

    也可以在 OpenCode 中使用 /connect 命令交互式添加 Provider。

    opencode
    # 在 OpenCode 中输入
    /connect

注意事项

  • 也支持 /connect 命令交互式配置
  • API Key 可用 {env:VAR_NAME} 语法引用环境变量
  • 支持自定义 headers(options.headers)