OpenCode | Vtrix API Docs

概述

OpenCode 是面向终端和项目目录的 AI 编程工具。它支持多 provider 配置的版本可以通过 OpenAI-compatible 模式接入 Vtrix，也可以在支持 Anthropic-compatible 的版本中调用 Claude 系列模型。

环境要求

OpenCode
Vtrix API Key
支持自定义 provider 的 OpenCode 版本
支持工具调用和长上下文的 Vtrix 模型

安装

根据 OpenCode 当前官方说明安装。常见方式包括安装脚本或包管理器：

# 示例，具体以 OpenCode 当前版本文档为准
curl -fsSL https://opencode.ai/install | bash

配置方式

OpenAI-compatible 环境变量

export OPENAI_API_KEY="YOUR_VTRIX_API_KEY"
export OPENAI_BASE_URL="https://cloud.vtrix.ai/llm"

然后指定 Vtrix 模型，例如：

opencode --model gpt-5.5

Anthropic-compatible 环境变量

如果你主要使用 Claude 系列模型，并且当前 OpenCode 版本支持 Anthropic-compatible provider，可以配置：

export ANTHROPIC_AUTH_TOKEN="YOUR_VTRIX_API_KEY"
export ANTHROPIC_BASE_URL="https://cloud.vtrix.ai/llm"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

配置文件方式

不同版本字段名可能不同，核心配置保持一致：

{
  "providers": {
    "vtrix": {
      "type": "openai-compatible",
      "baseURL": "https://cloud.vtrix.ai/llm",
      "apiKey": "${VTRIX_API_KEY}",
      "models": ["gpt-5.5", "claude-sonnet-4-5"]
    }
  },
  "defaultModel": "gpt-5.5"
}

如果 OpenCode 使用 TOML：

[providers.vtrix]
type = "openai-compatible"
base_url = "https://cloud.vtrix.ai/llm"
api_key = "${VTRIX_API_KEY}"

[models.default]
provider = "vtrix"
model = "gpt-5.5"

验证配置

在项目根目录运行只读任务：

opencode "阅读当前项目结构，不要修改文件，并总结主要模块"

如果 OpenCode 能返回项目结构摘要，说明连接和模型配置生效。

场景	推荐模型
代码生成和修改	`gpt-5.5`
多文件阅读	`claude-sonnet-4-5`
Codex 风格任务	`gpt-5.3-codex`
快速问答	`gemini-3-5-flash`

常见问题

配置字段名不一致

以当前 OpenCode 版本文档为准。字段名可以不同，但 Base URL、API Key 和模型 ID 必须对应 Vtrix。

工具调用不可用

切换到支持 Tool Calling 的模型，并减少单次任务范围。

请求走了默认 provider

确认命令行参数、配置文件默认模型和环境变量没有指向其他 provider。

概述