AI 编辑器Anthropic + OpenAI 协议

Zed 接入 CCSub:anthropic_compatible / openai_compatible 怎么配置

Zed 用第三方 API:在 settings.json 加 anthropic_compatible(api_url 填 https://www.ccsub.net)或 openai_compatible(填 /api/v1),Key 在界面或 CCSUB_API_KEY 环境变量里设置。

最后更新:Zed 官网

复制即用的配置

把下面三项填进工具里即可。API Key 在控制台「API 密钥」页面创建。

api_url(Anthropic 兼容)
https://www.ccsub.net(不带 /v1,Zed 会拼 /v1/messages)
api_url(OpenAI 兼容)
https://www.ccsub.net/api/v1
API Key
sk-你的CCSub密钥(在界面填,或设环境变量 CCSUB_API_KEY)
name
claude-sonnet-5
Zed settings.json(language_models 部分)
"language_models": {
  "anthropic_compatible": {
    "ccsub": {
      "api_url": "https://www.ccsub.net",
      "available_models": [
        {
          "name": "claude-sonnet-5",
          "display_name": "claude-sonnet-5 (CCSub)",
          "max_tokens": 200000
        }
      ]
    }
  }
}

model 可填 claude-sonnet-5 等,全部可用型号 ID 见 型号列表。 还没有 Key? 先注册账号。

配置步骤速览

  1. 1

    创建 CCSub API Key

    注册 CCSub,在控制台「API 密钥」页面创建 sk- 开头的 Key。

  2. 2

    打开 Zed 的设置文件

    在 Zed 命令面板执行 zed: open settings file(macOS 快捷键 Cmd+Alt+,)打开 settings.json。

  3. 3

    添加 anthropic_compatible 提供方

    在 language_models 下添加 anthropic_compatible,提供方名写 ccsub,api_url 填 https://www.ccsub.net,并在 available_models 里列出型号,例如 claude-sonnet-5。

  4. 4

    设置 API Key

    在 Agent 设置(命令 agent: open settings)的 LLM Providers 里给 ccsub 填 Key,或者设置环境变量 CCSUB_API_KEY 后重启 Zed。

  5. 5

    在 Agent 面板选型号验证

    打开 Agent 面板,在型号下拉里选 ccsub 下的型号发一句话,再到 CCSub「使用记录」核对。

Zed 是一款用 Rust 写的开源代码编辑器,自带 Agent 面板。和 Cursor 不同,Zed 可以直接配置 Anthropic 兼容的提供方,所以 claude- 开头的型号也能走 CCSub。配置写在 Zed 的 settings.json 里,Key 单独存放。

设置文件在哪

在 Zed 命令面板(macOS 按 Cmd+Shift+P,其他系统 Ctrl+Shift+P)执行 zed: open settings file 就能直接打开 settings.json,macOS 快捷键是 Cmd+Alt+,。Cmd+, 打开的是图形化设置界面,这里要改的是 JSON 文件。文件位置是 macOS / Linux 的 ~/.config/zed/settings.json,Windows 的 %APPDATA%\Zed\settings.json。

方式一:Anthropic 兼容(推荐调用 Claude 型号)

在 settings.json 里加入 language_models(已有的话合并进去):

{
  "language_models": {
    "anthropic_compatible": {
      "ccsub": {
        "api_url": "https://www.ccsub.net",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "claude-sonnet-5 (CCSub)",
            "max_tokens": 200000,
            "capabilities": { "tools": true, "images": true }
          }
        ]
      }
    }
  }
}
字段说明
ccsub
提供方名称,自己起;它决定环境变量名,建议全小写
api_url
https://www.ccsub.net不带 /v1,Zed 会拼 /v1/messages;末尾不加斜杠
name
claude-sonnet-5请求时发送的 model
display_name
型号下拉里显示的名字
max_tokens
200000Zed 用来控制上下文长度的数值,按需调整
capabilities
tools 默认开启;images 默认关闭,要发图片就设为 true

model 可填 claude-sonnet-5 等,全部可用型号 ID 见 型号列表。想用几个型号,就在 available_models 里列几项。

方式二:OpenAI 兼容

{
  "language_models": {
    "openai_compatible": {
      "ccsub-openai": {
        "api_url": "https://www.ccsub.net/api/v1",
        "available_models": [
          { "name": "gpt-5.5", "display_name": "gpt-5.5 (CCSub)", "max_tokens": 200000 }
        ]
      }
    }
  }
}

注意两种方式的 api_url 写法相反:Anthropic 兼容不带 /v1(Zed 自己拼 /v1/messages),OpenAI 兼容要带到 /api/v1(Zed 只拼 /chat/completions)。

Key 怎么设置

Zed 官方文档明确要求不要把 Key 写进 settings.json。两种方式任选:

  1. 界面填写:命令面板执行 agent: open settings,在 LLM Providers 里找到 ccsub,填入 CCSub 的 Key。新提供方也可以直接从这里的 Add Provider 添加,Anthropic 兼容的选 Anthropic。
  2. 环境变量:变量名是提供方名称转成大写下划线再加 _API_KEY。提供方叫 ccsub 就是 CCSUB_API_KEY,叫 ccsub-openai 就是 CCSUB_OPENAI_API_KEY。设置后要重启 Zed。

提供方名称尽量用全小写、不带空格。名称里的大写字母和空格都会影响生成的环境变量名,容易出现「变量设了却不生效」的情况。

capabilities 里的几个开关

Anthropic 兼容型号的 capabilities 有三个开关,默认值和建议如下:

capabilities 说明
tools
true默认开启,Agent 面板读写文件、执行命令都依赖它,保持开启
images
false默认关闭,要在对话里发截图就改成 true
prompt_caching
false开启后 Zed 会在请求里加缓存标记。CCSub 普通用户的缓存读写都按输入价计费,保持默认即可

另外 custom_headers 用来给请求加自定义请求头,接 CCSub 不需要填。改完 settings.json 保存即可,Zed 会自动重新加载,不用重启。

验证

打开 Agent 面板,在型号下拉里选 ccsub 下的型号,发一句话。然后到 CCSub 控制台的「使用记录」里找这条请求。想对比其他编辑器的接法,可以看 Cursor 接入教程;习惯 VS Code 插件的话,看 Cline 接入教程。

常见报错和排查

Agent 面板的型号列表里没有 ccsub

原因:settings.json 有语法错误(多了或少了逗号),或者 available_models 是空的。

处理:Zed 打开 settings.json 时会标出 JSON 错误,修正后保存;至少在 available_models 里写一个型号。

401 authentication_error: Missing or invalid API key

原因:没给 ccsub 设置 Key,或者环境变量名不对(提供方名称里有大写或空格,生成的变量名会不同)。

处理:提供方名称用全小写的 ccsub,对应 CCSUB_API_KEY;或者直接在 Agent 设置界面里填 Key。

404 Not Found

原因:Anthropic 兼容的 api_url 带了 /v1,请求变成 /v1/v1/messages;或者 api_url 末尾多了斜杠。

处理:Anthropic 兼容填 https://www.ccsub.net,OpenAI 兼容填 https://www.ccsub.net/api/v1,末尾都不加斜杠。

更多报错的原因和处理办法,见 报错排查总览;安装环境问题见 故障排查文档。

常见问题

Anthropic 兼容的 api_url 要带 /v1 吗?

不要。Zed 会在 api_url 后面拼 /v1/messages,填 https://www.ccsub.net 即可。OpenAI 兼容则相反,要填到 /api/v1,Zed 只在后面拼 /chat/completions。

Key 能写进 settings.json 吗?

Zed 官方文档明确要求不要把 Key 写进 settings.json。在 Agent 设置界面里填,或者用环境变量:变量名是提供方名称转成大写下划线再加 _API_KEY,提供方叫 ccsub 就是 CCSUB_API_KEY。

为什么发图片没反应?

兼容提供方的型号默认不开启图片输入。在 available_models 里给这个型号加 capabilities,把 images 设为 true。

max_tokens 填什么?

在 Zed 里 max_tokens 表示上下文窗口长度,用来决定能带多少历史内容,示例里写的是 200000,按你的需要调整即可;单次输出上限是另一个字段 max_output_tokens。

model 应该填什么?

available_models 里的 name 就是请求时的 model,可填 claude-sonnet-5 等,全部可用型号 ID 见 CCSub 型号列表页。

查看全部工具接入教程

还没有 CCSub 账号?

注册后在控制台创建 API Key,把上面的配置填进工具即可开始使用。按量付费的余额不过期,用多少扣多少。