---
title: OpenCode 使用教程
sidebarTitle: OpenCode
description: 安装 OpenCode 终端编程工具，配置无限星河AI API 地址、密钥与模型并完成首次请求。
---

OpenCode 是一个开源终端 AI 编程工具，可以读取项目、修改文件和运行命令。

## 安装 OpenCode

按照 [OpenCode 官网](https://opencode.ai/) 的说明安装。使用 npm 时可以执行：

```bash
npm install -g opencode-ai
```

## 添加 API Key

运行 `opencode`，然后输入：

```text
/connect
```

选择 **Other**，供应商 ID 填写 `infistar`，再粘贴无限星河AI API Key。

## 配置模型

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

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "infistar": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "无限星河AI",
      "options": {
        "baseURL": "https://infistar.cc/v1"
      },
      "models": {
        "模型广场中的原始模型ID": {
          "name": "模型广场中的原始模型ID"
        }
      }
    }
  }
}
```

## 开始使用

重新启动 OpenCode，输入 `/models`，选择 `infistar` 下的模型。

![OpenCode 终端界面](/images/tutorials/opencode/opencode-terminal.jpg)

第一次先让它“只回复配置成功，不要修改文件”。

## 遇到问题

- **没有显示模型**：确认 `/connect` 和配置文件中的供应商 ID 都是 `infistar`。
- **提示 401**：重新执行 `/connect` 并更新 API Key。
- **提示 404**：`baseURL` 应为 `https://infistar.cc/v1`。
- **工具不能使用**：换用模型广场中支持工具调用的模型。