Skip to main content
OpenCode 是一个开源的终端 AI 编程工具，支持多种模型提供商。通过配置 Teio 的 API，你可以在终端中使用 OpenCode 进行编程。

​
前置条件

  • 已 创建 API 令牌（选择 OpenAI 或 Claude 分组，取决于你要使用的模型）
  • 如果通过 NPM 安装，需要已安装 Node.js 18+

​
安装 OpenCode

一键安装（推荐）：
curl -fsSL https://opencode.ai/install | bash
或通过 Homebrew：
brew install anomalyco/tap/opencode
或通过 NPM：
npm install -g opencode-ai

​
配置

OpenCode 需要两个配置文件：opencode.json（提供商配置）和 auth.json（认证信息）。
配置文件路径：
  • ~/.config/opencode/opencode.json
  • ~/.local/share/opencode/auth.json
如果文件夹不存在，请手动创建：
mkdir -p ~/.config/opencode ~/.local/share/opencode
写入 opencode.json（OpenCode 按模型厂商区分 provider，需要将用到的 provider 的 baseURL 都指向 Teio，这样无论使用 OpenAI 还是 Claude 系列模型，请求都会通过 Teio 转发）：
cat > ~/.config/opencode/opencode.json << 'EOF'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://teio.me/v1"
      }
    },
    "anthropic": {
      "options": {
        "baseURL": "https://teio.me/v1"
      }
    }
  }
}
EOF
写入 auth.json：
cat > ~/.local/share/opencode/auth.json << 'EOF'
{
  "openai": {
    "type": "api",
    "key": "sk-你的OpenAI分组令牌"
  },
  "anthropic": {
    "type": "api",
    "key": "sk-你的Claude分组令牌"
  }
}
EOF
将 sk-你的OpenAI分组令牌 和 sk-你的Claude分组令牌 替换为你在 Teio 控制台创建的实际 API 令牌。如果只需要使用其中一种，可以只配置对应的 provider。

​
启动

如果你刚完成上述配置，请先重启终端，确保配置文件已被加载。
opencode
如果配置正确，你会进入 OpenCode 的交互界面。启动后可以通过 /models 命令切换到的模型。

​
常见问题

确认已正确安装 OpenCode。如果使用一键安装脚本，尝试重启终端。如果使用 npm 安装，检查全局 bin 目录是否在 PATH 中：
npm config get prefix
将输出路径下的 bin 目录添加到你的 PATH 环境变量中。
  • 检查 auth.json 中的令牌是否正确，确保没有多余的空格或换行
  • 确认令牌分组与使用的模型匹配（OpenAI 模型用 OpenAI 分组令牌，Claude 模型用 Claude 分组令牌）
  • 在 Teio 控制台确认令牌未过期或被禁用
  • 如果是一直卡着不动，可在 Teio 控制台的「操练场」中，选定对应分组和模型手动测试一次，看看是否有正常返回；如果操练场也没有返回，通常说明是分组、模型或令牌本身存在问题
由于 OpenAI 和 Anthropic 官方列举了所有模型，但个别模型 Teio 暂不支持。建议在 Teio 控制台的「操练场」中，选择对应分组查看当前可用的模型列表，确认你要使用的模型已被支持后再进行配置。