接入 OpenCode

OpenCode 是一个开源 AI 编程助手,提供终端、网页等运行形式。

从现有安装中迁移到 PingToken

  1. 执行 opencode upgrade 命令,将 opencode 升级至最新版本(>=v1.14.24)
  2. 执行 opencode 命令,启动 OpenCode
  3. 输入框中输入 /connect,然后输入 other 并设置模型供应商名称:pingtoken
  4. 填入 PingToken API Token
  5. 选择 DeepSeek-V4-Pro 模型

从零安装 OpenCode

1. 安装 OpenCode

前往官方下载页面安装或升级:OpenCode 下载

为避免兼容性问题,强烈建议您将 OpenCode 升级到最新版本,确保版本号 >= v1.14.24。

2. 运行与配置

  • 执行 opencode 命令
  • 输入框中输入 /connect,然后输入 other 并设置模型供应商名称:pingtoken
  • 填入 PingToken API Token
  • 选择 DeepSeek-V4-Pro 模型

配置方式二:使用配置文件

OpenCode 采用分层存储设计,配置文件和认证文件分开存放:

目录用途存储内容
~/.config/opencode/配置文件opencode.json(baseURL、模型列表、provider 参数等)
~/.local/share/opencode/数据目录auth.json(API Key、OAuth Token 等敏感凭据)

各操作系统完整路径:

操作系统auth.json 路径
macOS / Linux~/.local/share/opencode/auth.json
Windows%USERPROFILE%\.local\share\opencode\auth.json
步骤 1:创建认证文件 auth.json
{
  "providers": {
    "pingtoken": {
      "apiKey": "YOUR_API_TOKEN"
    }
  }
}

YOUR_API_TOKEN 替换为你的 PingToken API Token(在 控制台 → Token 管理 获取)。

步骤 2:创建配置文件 opencode.json

配置文件路径:

  • macOS/Linux: ~/.config/opencode/opencode.json
  • Windows: %USERPROFILE%\.config\opencode\opencode.json
{
    "provider": {
      "pingtoken": {
        "npm": "@ai-sdk/openai-compatible",
        "options": {
          "baseURL": "https://pingtoken.cn/api/v1"
        },
        "models": {
          "deepseek-v4-flash": {
            "name": "DeepSeek V4 Flash"
          },
          "deepseek-v4-pro": {
            "name": "DeepSeek V4 Pro"
          },
          "qwen3-max": {
            "name": "Qwen3 Max"
          },
          "kimi-k2.5": {
            "name": "Kimi K2.5"
          }
        }
      }
    },
    "model": "pingtoken/kimi-k2.5"
  }

注意:provider 名称(如 pingtoken)要和 auth.json 中的一致。OpenCode 启动时会自动合并 auth.json 中的 API Key 和 opencode.json 中的配置参数。