在 ZCode 里使用珂艾网关
能用。 ZCode 支持添加任何兼容 OpenAI / Anthropic 协议的供应商，填四项即可，约 3 分钟。 整理日期：2026-10-18 ｜ 相关：按任务选模型 · Claude Code 配置
一、配置三要素
| 要素 | 填什么 |
|---|---|
| Base URL（OpenAI 协议） | https://turbo.apimax.host/v1 |
| API Key | 珂艾控制台「令牌管理」生成的 sk- 开头密钥 |
| 模型 ID | 网关模型 ID，如 claude-sonnet-5-5 |
⚠️ 选 OpenAI 协议这条通道，Base URL 带 /v1。
如果你想用 Anthropic 协议，Base URL 改成https://turbo.apimax.host（不带/v1），两者规则相反。
二、配置步骤
入口
添加供应商
1.
2.
| 字段 | 填什么 |
|---|---|
| 名称 | 自定义，填 珂艾 或 Keai 都行 |
| Base URL | https://turbo.apimax.host/v1 |
| API Key | 你的 sk- 密钥 |
| API 格式 | 选 Chat Completions（标准对话接口） |
3.
claude-sonnet-5-5）。ZCode 不会从自定义供应 商自动拉取模型列表，必须手填。一次只填你要用的几个，别贪多。
4.
5.
三、验证是否真的通了
读一下当前目录，告诉我这是什么项目401 → 密钥错或带空格404 → Base URL 漏 /v1四、推荐模型搭配
| 使用场景 | 模型 ID | 为什么 |
|---|---|---|
| 日常写代码、改 bug | claude-sonnet-5-5 | 代码理解稳，工具调用成熟 |
| 想用 GLM 但不想单独订阅 | glm-5.3 | 与 ZCode 原生体验一致，走珂艾更灵活 |
| 复杂架构、跨文件重构 | claude-opus-5-5 | 长链路推理不吃亏 |
| 便宜大批量 | deepseek-v4-flash | 单价低，适合反复试错 |
ZCode 原生为 GLM 优化，用 glm-5.3时体验最接近官方；但接珂艾后同样能切 Claude、GPT、DeepSeek，不必受限于一家。
五、常见报错
| 现象 | 原因 | 解决 |
|---|---|---|
| 供应商加好了但没模型可选 | 没点「添加模型」 | 编辑供应商，手动填模型 ID |
| 模型填了但调用报不存在 | 填了官方名而非网关 ID | 对照第四节表格 |
报 404 | Base URL 漏 /v1 | 改成 https://turbo.apimax.host/v1 |
401 | 密钥错误 / 带空格 | 重新复制核对 |
| 能聊但不能改文件 | API 格式不是 Chat Completions | 编辑供应商改格式 |
| 响应很慢 | 选了 opus 或推理档过高 | 日常换 sonnet / flash |
💡 ZCode 官方文档里提到的「Coding 专用端点 / 通用端点」是智谱自家套餐的规则，用第三方供应商（如珂艾）不需要区分，填标准 /v1即可。
六、计费与分组
| 项目 | 信息 |
|---|---|
| 计费方式 | 按量计费（按输入 / 输出 token 结算） |
| 可用分组 | 取决于令牌所属分组 |
| 建议 | 编程类 Agent 循环多，给专用令牌设额度上限 |
实际单价以价格页为准。
七、进阶：同时留一条官方通道
八、相关阅读
九、更新记录
| 日期 | 改了什么 |
|---|---|
| 2026-10-18 | 首次发布。基于 ZCode 2026-10 桌面版；说明「添加模型必须手填」与「智谱 Coding 端点规则不适用于第三方」 |
修改于 2026-11-02 17:01:33