> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sub2api.ruilinlu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 OpenCode 中配置 Sub2API

> 将 Sub2API 配置为 OpenCode 的 API 后端，使用开源终端 AI 编程助手访问多种模型。

OpenCode 是一款开源的终端 AI 编程助手。通过将 Sub2API 配置为 OpenCode 的 API 后端，你可以在终端中使用 Sub2API 支持的多种模型进行代码生成和补全。

## 前置条件

* 已安装 OpenCode
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

## 安装 OpenCode

TODO: 请在后台确认实际配置后填写。

## 配置方法

OpenCode 支持通过配置文件或环境变量设置 API 后端。

### 配置文件方式

TODO: 请在后台确认实际配置后填写。（配置文件路径和格式需根据实际确认）

编辑 OpenCode 的配置文件（通常为 `~/.config/opencode/config.toml` 或类似路径）：

```toml theme={null}
[provider]
name = "openai"

[provider.openai]
base_url = "https://sub2api.ruilinlu.com"
api_key = "your_sub2api_key"
model = "gpt-4o"
```

### 环境变量方式

你也可以通过环境变量快速配置：

```bash theme={null}
export OPENAI_API_KEY="your_sub2api_key"
export OPENAI_BASE_URL="https://sub2api.ruilinlu.com"
```

## 验证连接

配置完成后，运行以下命令测试连接：

```bash theme={null}
# 检查版本
opencode --version

# 进入交互模式测试
opencode
```

## 故障排查

<Accordion title="提示配置文件格式错误">
  * 确认配置文件语法正确（如 TOML 格式）
  * TODO: 请在后台确认实际配置后填写。（确认支持的配置文件格式）
</Accordion>

<Accordion title="返回 401 错误">
  * 确认 api\_key 已正确设置为 Sub2API API Key
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="无法连接到 API">
  * 确认 base\_url 已设置为 `https://sub2api.ruilinlu.com`
  * 参考 [Base URL 配置](/configuration/base-url)
</Accordion>