CloseAI

Appearance

通过 CloseAI 使用 OpenCode ​

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

⚠️ 不要走官方的 /connect 配置流程

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

准备工作 ​

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

  1. 一个 CloseAI 账户。
  2. 一个 CloseAI API Key。您可以在您的账户仪表板中找到它。

安装 ​

以下方式任选其一：

方式一：官方脚本安装

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

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

方式二：npm 安装（需先装好 Node.js）

bash
npm install -g opencode-ai

方式三：Homebrew 安装

bash
brew install anomalyco/tap/opencode

安装完成后，在终端任意位置执行 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"
      }
    }
  }
}

配置说明：

  • 三个 provider 分别对应三家模型的原生协议接入：anthropic 走 Claude、openai 走 GPT、google 走 Gemini，各自的 baseURL 不同，不要混用，照抄即可
  • 就算暂时只用其中一家模型，也建议三家都配上，省得以后想用的时候又用不了
  • 注意 anthropic 的地址末尾是 /anthropic/v1，google 的末尾是 /google/v1，多写或少写路径都会导致 404 报错

开始使用 ​

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

bash
cd /path/to/your/project
opencode

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

注意事项 ​

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

Copyright © 2024 CloseAI