# OpenCode

来源: https://docs.aicentos.com/clients/opencode

Language: zh-CN

> 在 OpenCode 中使用 aicentos —— 通过配置文件接入自定义 provider

OpenCode 支持自定义 provider，可以通过配置文件的方式接入 Codex Proxy 服务。

## 准备工作

OpenCode 官网提供官方安装脚本，也提供 npm、bun、brew 等安装方式。

* 如果你直接使用官方安装脚本，通常不需要先手动配置 npm
* 如果你准备走 npm 安装，请先安装 Node.js 与 npm
* 如果你准备走 bun 安装，则需要先安装 bun

### 安装 Node.js（npm 方式）

Node.js 官方下载页是：[https://nodejs.org/en/download](https://nodejs.org/en/download)

* macOS / Windows：下载并安装 LTS 版本
* Linux：按该页面提供的发行版方式安装

如果你在 macOS 上已经安装了 Homebrew，也可以直接执行：

```bash
brew install node
```

这会同时安装 Node.js 和 npm。

建议先按你选择的安装方式确认对应命令可用。例如 npm 方式可先检查：

```bash
node -v
npm -v
```

**注意：** 如果你在 Windows 上使用命令行环境，官方目前建议优先在 WSL 中使用。

## 安装

推荐直接使用 OpenCode 官网提供的安装命令：

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

OpenCode 官网同时提供 npm、bun、brew 等安装方式。

## 设置 API Key

使用 OpenCode 自己的连接或鉴权方式：

```bash
opencode auth login
```

或者在交互界面里运行 /connect，把这个服务作为自定义 provider 保存。

如果你更习惯环境变量，让 opencode.json 读取官方通用变量名即可，例如：

```bash
export OPENAI_API_KEY="your_api_key_here"
```

## 配置 opencode.json

在项目根目录或全局配置目录中创建 opencode.json：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  },
  "model": "aicentos/gpt-4o"
}
```

## 测试

启动 OpenCode 后，执行：

```
/models
```

看到 aicentos 下的模型即可。

## 注意事项

* 推荐顺序：先手动配置文件（opencode.json），再环境变量，最后才是 cc-switch 工具（[https://github.com/farion1231/cc-switch/releases）](https://github.com/farion1231/cc-switch/releases）)
* 如果你走 /v1/responses，OpenCode 官方文档建议使用 @ai-sdk/openai
* 如果你的接入只支持 /v1/chat/completions，才改用 @ai-sdk/openai-compatible
* 不需要额外定义 CODEX\_PROXY\_API\_KEY 这类项目私有变量

## 相关链接

* 官方网站：[https://opencode.ai/](https://opencode.ai/)