指南

OpenCode 配置

配置 OpenCode CLI 使用本平台

已支持已验证

Configure OpenCode against the TokenHub OpenAI-compatible gateway for terminal-based coding flows.

什么是 OpenCode

OpenCode 是一款命令行 AI 编程工具，支持多种 AI 模型和 Provider，可在终端中辅助编写和调试代码。

系统要求

- Node.js 版本 ≥ 18.0
- 操作系统：macOS、Linux、Windows (WSL)

快速开始

1. 安装 OpenCode

bash

npm install -g opencode

2. 创建配置文件

在项目根目录创建 opencode.json：

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "local": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "local",
      "options": {
        "baseURL": "https://tokenhub.local/v1"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        },
        "claude-sonnet-4-20250514": {
          "name": "claude-sonnet-4-20250514"
        }
      }
    }
  }
}

3. 设置 API Key

bash

export OPENAI_COMPATIBLE_API_KEY="sk-your-api-key"

4. 启动

bash

cd your-project
opencode

添加更多模型

在 opencode.json 的 models 对象中添加更多模型即可：

json

{
  "models": {
    "gpt-4o": { "name": "gpt-4o" },
    "claude-sonnet-4-20250514": { "name": "claude-sonnet-4-20250514" },
    "deepseek-chat": { "name": "deepseek-chat" }
  }
}

常见问题

连接失败？

请检查：

- baseURL 是否为 https://tokenhub.local/v1
- API Key 环境变量是否设置正确
- 模型 ID 是否与平台支持的模型名称一致

当前公开文档仅覆盖已验证的 OpenAI 兼容接口；其他扩展能力仍需单独验证。

Cline

Cursor