在 OpenCode 中使用 PixMind

配置 PixMind provider，通过 OpenCode 安全凭据存储 API Key，并选择 GPT-5.6 模型。

OpenCode 支持自定义 OpenAI-compatible provider。PixMind 的供应商配置与 API Key 分开保存：配置文件描述端点和模型，密钥通过 opencode auth login 写入 OpenCode 的凭据存储。

1. 安装 OpenCode

按 OpenCode 官方安装文档完成安装，然后确认命令可用：

opencode --version

2. 获取 PixMind API Key

前往 API Platform 密钥管理创建 API Key。不要把真实密钥写进 opencode.json。

3. 配置 PixMind provider

在项目根目录创建 opencode.json；若需要全局生效，也可写入 OpenCode 的用户配置目录。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "pixmind/gpt-5.6-terra",
  "provider": {
    "pixmind": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PixMind",
      "options": {
        "baseURL": "https://aihub-admin.aimix.pro/api-platform/v1"
      },
      "models": {
        "claude-fable-5": { "name": "Claude Fable 5" },
        "claude-opus-5": { "name": "Claude Opus 5" },
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "claude-opus-4-8": { "name": "Claude Opus 4.8" },
        "claude-opus-4-8-cc": { "name": "Claude Opus 4.8 CC" },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol",
          "reasoning": true,
          "variants": {
            "low": { "reasoningEffort": "low" },
            "medium": { "reasoningEffort": "medium" },
            "high": { "reasoningEffort": "high" },
            "xhigh": { "reasoningEffort": "xhigh" },
            "max": { "reasoningEffort": "max" },
            "ultra": { "reasoningEffort": "ultra" }
          }
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra",
          "reasoning": true,
          "variants": {
            "low": { "reasoningEffort": "low" },
            "medium": { "reasoningEffort": "medium" },
            "high": { "reasoningEffort": "high" },
            "xhigh": { "reasoningEffort": "xhigh" },
            "max": { "reasoningEffort": "max" },
            "ultra": { "reasoningEffort": "ultra" }
          }
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna",
          "reasoning": true,
          "variants": {
            "low": { "reasoningEffort": "low" },
            "medium": { "reasoningEffort": "medium" },
            "high": { "reasoningEffort": "high" },
            "xhigh": { "reasoningEffort": "xhigh" },
            "max": { "reasoningEffort": "max" }
          }
        },
        "gemini-3.1-pro-preview": { "name": "Gemini 3.1 Pro Preview" },
        "gemini-3.5-flash": { "name": "Gemini 3.5 Flash" },
        "gemini-3.6-flash": { "name": "Gemini 3.6 Flash" },
        "gemini-3.7-flash": { "name": "Gemini 3.7 Flash" },
        "gemini-3.5-flash-lite": { "name": "Gemini 3.5 Flash-Lite" }
      }
    }
  }
}

4. 登录供应商

opencode auth login -p pixmind

按提示粘贴 PixMind API Key。不要把密钥写成 {env:sk_...}：花括号内必须是环境变量名，而不是密钥本身。

5. 选择模型并验证

启动 OpenCode，运行 /models，选择 pixmind/gpt-5.6-terra，再发送一个最小请求，例如“只回复 OK”。

上述 reasoning 和 variants 配置会让 OpenCode 在 GPT 模型选择器旁显示思考深度。Sol、Terra 支持到 ultra，Luna 支持到 max。

如果模型已出现但返回“缺少 API Key”，重新执行 opencode auth login -p pixmind，并确认 provider ID 与配置中的 pixmind 完全一致。

模型建议

日常编码：pixmind/claude-sonnet-5 或 pixmind/gpt-5.6-terra
复杂规划：pixmind/claude-opus-5 或 pixmind/gpt-5.6-sol
多模态任务：pixmind/gemini-3.6-flash
低延迟任务：pixmind/gpt-5.6-luna 或 pixmind/gemini-3.5-flash-lite