Trae 外接配置

Trae 可通过扩展商店中的 Claude、Codex（或 OpenAI 兼容）插件填写自定义 Base URL。QiyuanHub 对 OpenAI 兼容客户端统一提供 Chat Completions；不同插件对「是否带 `/v1`」要求不同，这是最容易配错的点。

• 适合：已在 Trae 中使用 Claude / Codex 插件的开发者
• 目标：把官方云切换为 QiyuanHub 网关
• 调用前请保证账号已审核、Key 有效、模型已上线

• 已注册并登录 QiyuanHub（官网注册页完成邮箱验证）
• 账号状态为 active：控制台可正常创建 API Key；pending 审核中无法调用
• 已在「控制台 → API 密钥」创建密钥，格式为 `sk-opc-...`（完整 Key 仅创建时显示一次）
• 钱包有可用余额，或仍有体验额度
• 已从「模型 & 定价」确认目标模型为「已上线」，推荐先用 `deepseek-v4.1` 做连通验证

• Base URL：`https://api.qiyuanapi.cc/v1`（必须带 `/v1`，不要写成 `https://api.qiyuanapi.cc`）
• API Key：`sk-opc-你的密钥`（请求头为 `Authorization: Bearer <key>`）
• 模型 ID：使用定价页中的 slug：`deepseek-v4.1`

Trae 内配置失败时，用本机 curl 可快速判断是网关问题还是插件问题：

export OPC_API_KEY="sk-opc-your-api-key"

curl https://api.qiyuanapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $OPC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍自己"}]
  }'

按你安装的插件类型选择：

• OpenAI / Codex 兼容插件：`https://api.qiyuanapi.cc/v1`（必须带 /v1）
• Claude 类插件：优先试 `https://api.qiyuanapi.cc/v1`；若插件文档要求「Host 不含路径」，再试 `https://api.qiyuanapi.cc`
• API Key：一律填 QiyuanHub 的 `sk-opc-...`（不要填官方 Anthropic / OpenAI Key）
• 模型：填平台 slug `deepseek-v4.1`

• 401 unauthorized — Key 错误、被禁用，或未加 `Bearer ` 前缀
• 402 / quota_exceeded — 余额不足，请充值或使用兑换码
• 403 application_pending — 账号尚未审核通过
• 403 ip_not_allowed — 当前 IP 不在该 Key 白名单内（若你开启了 IP 限制）
• model_not_allowed / 模型不存在 — slug 写错，或模型未上线 / 无权限
• 429 rate_limited — 触发限流，稍后重试或降低并发
• Claude 可用但 Codex 不可用：给 Codex 补上 `/v1`
• Codex 可用但 Claude 不可用：Claude 插件可能不兼容当前网关协议，改走 OpenAI 兼容插件
• 403 Block / 被内置浏览器拦截：更新插件版本，或按 Trae 文档调整 User-Agent / 外接方式
• 模型列表拉空：忽略自动列表，手动填写平台 slug

• 《30 秒快速验证》— 先确认网关与 Key
• 《Codex (OpenAI) 配置》— CLI 侧 OpenAI 兼容变量参考
• 《常见问题》— 错误码与审核状态说明