文档 · 接入指南

Zed 接 TopxAI：OpenAI 兼容与 Anthropic 兼容供应商

2026-09-19

在 settings.json 里把 TopxAI 加为 openai_compatible 供应商（GPT、Grok、Kimi、GLM）和 anthropic_compatible 供应商（Claude）。

Zed 的 agent 在 settings.json 的 language_models 下接受自定义供应商。TopxAI 配成一个 openai_compatible 供应商放 Chat Completions 上的文本模型，再配一个 anthropic_compatible 供应商放 Claude。

settings.json

{
  "language_models": {
    "openai_compatible": {
      "TopxAI": {
        "api_url": "https://ai.topxea.com/v1",
        "available_models": [
          {
            "name": "gpt-6.1-sol",
            "display_name": "GPT-6.1 Sol",
            "max_tokens": 1000000
          },
          {
            "name": "grok-4.7",
            "display_name": "Grok 4.7",
            "max_tokens": 500000
          },
          {
            "name": "kimi-k3",
            "display_name": "Kimi K3",
            "max_tokens": 1000000
          }
        ]
      }
    },
    "anthropic_compatible": {
      "TopxAI Claude": {
        "api_url": "https://ai.topxea.com",
        "available_models": [
          {
            "name": "claude-sonnet-5-5",
            "display_name": "Claude Sonnet 5.5",
            "max_tokens": 1000000,
            "max_output_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": true,
              "prompt_caching": true
            }
          },
          {
            "name": "claude-opus-5-5",
            "display_name": "Claude Opus 5.5",
            "max_tokens": 1000000,
            "max_output_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": true,
              "prompt_caching": true
            }
          }
        ]
      }
    }
  }
}

密钥不写进 settings.json。在 agent 设置里该供应商那一行填入，或者导出 Zed 按供应商名派生的环境变量：上面两个供应商对应 TOPXAI_API_KEY 和 TOPXAI_CLAUDE_API_KEY。

说明

max_tokens 是 Zed 用来算「剩余上下文」的窗口大小，填模型真实的窗口。
Claude 供应商打开 prompt_caching：TopxAI 转发 cache_control 断点，缓存读取按输入价的十分之一计费。
Zed 的 Edit Prediction 有单独的供应商设置，这里的配置不覆盖它。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

模型：gpt-6.1-sol, grok-4.7 · 模型与价格

Zed 接 TopxAI：OpenAI 兼容与 Anthropic 兼容供应商

settings.json

说明

不通时

相关