OpenCode — Fast AI Docs

适合人群

重视可定制与多提供商

如果你经常切模型、切后端，OpenCode 会更灵活。

配置文件

~/.config/opencode/opencode.json

支持全局配置与项目级 `.opencode/opencode.json` 覆盖。

协议口径

OpenAI-compatible provider

Fast AI 在 OpenCode 中按兼容 OpenAI 的 provider 配置。

官方文档

OpenCode 安装教程

中文安装与入门文档。

OpenCode 自定义提供商

中文 provider 文档，直接看自定义提供商配置。

特点与使用场景

特点

开源，支持终端、桌面和 IDE 扩展，适合在一套工具里管理多家模型提供商。

适用场景

你需要可移植配置、可扩展的 skills / tools 体系，或者想在不同供应商之间快速切换。

第 1 步：安装 OpenCode

使用官方脚本或 npm

官方文档优先推荐安装脚本，也支持 npm 全局安装。

Install Script

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

npm

npm install -g opencode-ai

验证安装

执行 opencode --version 或直接运行 opencode。

第 2 步：配置 Fast AI provider

写入 `opencode.json`

全局配置文件通常位于 ~/.config/opencode/opencode.json；项目级配置则位于仓库中的 .opencode/opencode.json。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "fastai": {
      "npm": "@ai-sdk/openai",
      "name": "FastAI",
      "options": {
        "baseURL": "https://api.fastai.run/v1",
        "apiKey": "{env:FASTAI_API_KEY}"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5",
          "attachment": true,
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
      }
    }
  },
  "model": "fastai/gpt-5.5"
}

导出 API Key

OpenCode 通过 {env:FASTAI_API_KEY} 读取 Fast AI Key。

macOS / Linux

export FASTAI_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:FASTAI_API_KEY="YOUR_API_KEY"

第 3 步：验证连接

启动 OpenCode

运行 opencode，进入交互界面后让它总结当前仓库，或者使用 /models 检查模型是否已读取到 fastai/gpt-5.4。

确认请求成功

能正常收到回复，并且 Fast AI 控制台记录到对应请求，即为接入成功。