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 环境变量里设置。
复制即用的配置
把下面三项填进工具里即可。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
"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
创建 CCSub API Key
注册 CCSub,在控制台「API 密钥」页面创建 sk- 开头的 Key。
- 2
打开 Zed 的设置文件
在 Zed 命令面板执行 zed: open settings file(macOS 快捷键 Cmd+Alt+,)打开 settings.json。
- 3
添加 anthropic_compatible 提供方
在 language_models 下添加 anthropic_compatible,提供方名写 ccsub,api_url 填 https://www.ccsub.net,并在 available_models 里列出型号,例如 claude-sonnet-5。
- 4
设置 API Key
在 Agent 设置(命令 agent: open settings)的 LLM Providers 里给 ccsub 填 Key,或者设置环境变量 CCSUB_API_KEY 后重启 Zed。
- 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。两种方式任选:
- 界面填写:命令面板执行
agent: open settings,在 LLM Providers 里找到 ccsub,填入 CCSub 的 Key。新提供方也可以直接从这里的 Add Provider 添加,Anthropic 兼容的选 Anthropic。 - 环境变量:变量名是提供方名称转成大写下划线再加
_API_KEY。提供方叫ccsub就是CCSUB_API_KEY,叫ccsub-openai就是CCSUB_OPENAI_API_KEY。设置后要重启 Zed。
提供方名称尽量用全小写、不带空格。名称里的大写字母和空格都会影响生成的环境变量名,容易出现「变量设了却不生效」的情况。
capabilities 里的几个开关
Anthropic 兼容型号的 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 型号列表页。