接入 OpenCode
OpenCode 是一个开源 AI 编程助手,提供终端、网页等运行形式。
从现有安装中迁移到 PingToken
- 执行
opencode upgrade命令,将 opencode 升级至最新版本(>=v1.14.24) - 执行
opencode命令,启动 OpenCode - 输入框中输入
/connect,然后输入other并设置模型供应商名称:pingtoken - 填入 PingToken API Token
- 选择 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 中的配置参数。