OpenCode

OpenCode 是一个开源的 AI 编码代理。它提供终端界面、桌面应用和 IDE 扩展等多种使用方式。

前置条件

已创建 API 密钥
如果通过 NPM 安装，需要已安装 Node.js 18+

安装 OpenCode

macOS
Windows

一键安装（推荐）：

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

或通过 Homebrew：

brew install anomalyco/tap/opencode

或通过 NPM：

npm install -g opencode-ai

通过 NPM：

npm install -g opencode-ai

配置

OpenCode 需要两个配置文件：opencode.json（提供商配置）和 auth.json（认证信息）。

macOS
Windows

配置文件路径：

~/.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": "你的OpenAI分组密钥"
  },
  "anthropic": {
    "type": "api",
    "key": "你的Claude分组密钥"
  }
}
EOF

配置文件路径：

C:\Users\<您的用户名>\.config\opencode\opencode.json
C:\Users\<您的用户名>\.local\share\opencode\auth.json

如果文件夹不存在，请在文件资源管理器中手动创建对应目录。opencode.json（OpenCode 按模型厂商区分 provider，需要将用到的 provider 的 baseURL 都指向 Teio，这样无论使用 OpenAI 还是 Claude 系列模型，请求都会通过 Teio 转发）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://teio.me/v1"
      }
    },
    "anthropic": {
      "options": {
        "baseURL": "https://teio.me/v1"
      }
    }
  }
}

auth.json：

{
  "openai": {
    "type": "api",
    "key": "你的OpenAI分组密钥"
  },
  "anthropic": {
    "type": "api",
    "key": "你的Claude分组密钥"
  }
}

启动

如果你刚完成上述配置，请先重启终端，确保配置文件已被加载。

opencode

如果配置正确，你会进入 OpenCode 的交互界面。

Macshot Clipboard ED84E82A A174 46E7 8291 93B5FBBD09EE

启动后可以通过 /models 命令切换到的模型。

Macshot Clipboard 73B526CE 7EFB 41AE 9418 8005D02D201D

根据需求选择对应的模型

Macshot Clipboard A27C51A0 B8F4 4176 BDC0 32032F83440D 1

常见问题

提示模型不存在或 model not found

Macshot Clipboard 8A37AE2F D5D8 46AE A9D4 9AEB676DFAA1

由于 OpenAI 和 Anthropic 官方列举了所有模型，但个别模型 Teio 暂不支持。建议在 Teio 控制台的「操练场」中，选择对应分组查看当前可用的模型列表，确认你要使用的模型已被支持后再进行配置

遇到问题？请参考常见问题。

使用教程

AI编程工具

可视化配置工具

调用服务示例

LLM科普

帮助

前置条件

安装 OpenCode

配置

启动

常见问题

​前置条件

​安装 OpenCode

​配置

​启动

​常见问题

前置条件

安装 OpenCode

配置

启动

常见问题