---
url: /tutorial/integrations/opencode.md
---

# 通过 CloseAI 使用 OpenCode

OpenCode 是一款开源的终端 AI 编码助手（TUI），支持接入任意 LLM 提供商。最近很多用户询问 OpenCode 怎么配置 CloseAI，这里给出一套我们亲自测试过的最简配置。

::: warning ⚠️ 不要走官方的 /connect 配置流程
官方文档引导你在 TUI 里运行 `/connect`、去 opencode.ai/auth 登录开通他们自家的 OpenCode Zen 服务，那一套和我们无关，不用管。官方文档对自定义 API 地址（baseURL）的说明也很简略，照着摸索很容易卡住。**正确姿势是直接改一个配置文件**，复制粘贴、填上 Key 就能用，下面会讲。
:::

## 准备工作

在开始之前，请确保您已经拥有：

1. 一个 [CloseAI 账户](https://www.closeai.com/)。
2. 一个 CloseAI API Key。您可以在您的账户仪表板中找到它。

## 安装

:::tabs
\== macOS / Linux

以下方式任选其一：

**方式一：官方脚本安装**

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

如果这条命令卡住或报一堆乱码错误，说明你的网络访问不了 `opencode.ai`，开代理后重试，或者直接改用下面的 npm 方式。

**方式二：npm 安装（需先装好 [Node.js](https://nodejs.org/)）**

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

**方式三：Homebrew 安装**

```bash
brew install anomalyco/tap/opencode
```

安装完成后，在终端任意位置执行 `opencode --version`，能输出版本号即安装成功。

\== Windows

**重要提示**：与 Claude Code 一样，建议 Windows 用户在 Git Bash（或 WSL）中安装和使用 OpenCode，避免 CMD / PowerShell 的各种兼容性问题。Git Bash 的安装方式见 [Claude Code 教程](./claude-code.md)中的说明。

以下方式任选其一（在 Git Bash 中执行）：

**方式一：npm 安装（推荐，需先装好 [Node.js](https://nodejs.org/)）**

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

**方式二：包管理器安装**

```powershell
choco install opencode    # Chocolatey
scoop install opencode    # Scoop
```

安装完成后，在终端任意位置执行 `opencode --version`，能输出版本号即安装成功。

:::

## 配置 CloseAI 接入

不管官方文档那套 `/connect` 流程，只需要改一个文件。打开（没有就新建）全局配置文件：

* **macOS / Linux**：`~/.config/opencode/opencode.json`
* **Windows**：`C:\Users\你的用户名\.config\opencode\opencode.json`（在 Git Bash 中同样是 `~/.config/opencode/opencode.json`）

macOS / Linux 可以在终端执行以下命令创建目录并打开文件：

```bash
mkdir -p ~/.config/opencode
open -e ~/.config/opencode/opencode.json   # macOS；Linux 用任意编辑器打开
```

Windows 用户在 Git Bash 中执行：

```bash
mkdir -p ~/.config/opencode
notepad ~/.config/opencode/opencode.json   # 记事本提示文件不存在时点"是"新建
```

把下面这份我们测试通过的配置**整体复制进去**，再把 `sk-xxxx` 替换成您自己的 CloseAI API Key 即可：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.openai-proxy.org/anthropic/v1",
        "apiKey": "sk-xxxx"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.openai-proxy.org/v1",
        "apiKey": "sk-xxxx"
      }
    },
    "google": {
      "options": {
        "baseURL": "https://api.openai-proxy.org/google/v1",
        "apiKey": "sk-xxxx"
      }
    },
    "closeai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CloseAI",
      "options": {
        "baseURL": "https://api.openai-proxy.org/v1",
        "apiKey": "sk-xxxx"
      },
      "models": {
        "deepseek-v4.1-flash": { "name": "deepseek-v4.1-flash" },
        "glm-5.3": { "name": "glm-5.3" }
      }
    }
  }
}
```

**配置说明**：

* 三个 provider 分别对应三家模型的**原生协议**接入：`anthropic` 走 Claude、`openai` 走 GPT、`google` 走 Gemini，各自的 `baseURL` 不同，不要混用，照抄即可
* 就算暂时只用其中一家模型，也建议三家都配上，省得以后想用的时候又用不了
* 注意 `anthropic` 的地址末尾是 `/anthropic/v1`，`google` 的末尾是 `/google/v1`，多写或少写路径都会导致 404 报错
* `closeai` 这个 provider 用来接 DeepSeek、GLM 等国产模型，走 Chat Completions 协议，`models` 下填模型 ID 即可，要加别的模型照样子追加一行

## 开始使用

进入您的项目目录，启动 OpenCode：

```bash
cd /path/to/your/project
opencode
```

启动后在输入框里执行 `/models` 命令，就能看到 anthropic / openai / google 三家的模型列表，选择您想用的模型（如 Claude、GPT、Gemini 系列）即可开始对话。后续的使用方法（计划模式、`/undo` 撤销等）请参考[官方文档](https://opencode.ai/docs)。

## 注意事项

如果您之前用过官方的 `/connect` 流程登录过其他提供商，或者环境变量里残留了 `ANTHROPIC_API_KEY`、`OPENAI_API_KEY` 之类的旧配置，可能会和本文的配置互相干扰，出现 Key 不生效、请求发到错误地址等问题。遇到这种情况，请优先清理旧的登录态和环境变量，确保只保留本文的配置文件。