OpenCode 是一款 AI 编程工具,支持通过自定义提供商连接 OpenAI-compatible endpoint。在 OpenCode 中配置 PPIO 派欧云的大语言模型 API,可用于代码生成、调试、重构和项目问答。
前置准备
开始前,请先准备以下信息:
- API Key:前往 API 密钥管理 创建或复制 API Key。
- Base URL:
https://api.ppio.com/openai/v1
- Model ID:前往模型广场或模型详情页,复制需要使用的模型 ID,例如
deepseek/deepseek-v4.1-flash。
安装 OpenCode
OpenCode 提供命令行与桌面端,任选一种方式安装。
Linux / macOS / WSL2
任选一种安装方式:
Desktop
也可访问 OpenCode 下载页面安装桌面端:
配置自定义提供商
打开 OpenCode 设置页,找到提供商配置入口。不同版本入口名称可能略有差异,通常位于 Settings → Providers → Custom Provider。
填写以下信息:
Model ID 需与 PPIO 模型详情页中的名称完全一致。不同模型的上下文长度、价格和能力以模型详情页为准。
验证模型
完成配置后,在 OpenCode 中选择刚添加的 PPIO 模型,并输入一条测试消息:
模型正常回复说明配置已生效。若验证失败,请检查:
- API Key 是否正确且账户余额可用。
- Base URL 是否填写为
https://api.ppio.com/openai/v1。
- Model ID 是否正确。
- 当前网络是否可以访问 PPIO API endpoint。