ZCode（智谱）接入 ModelFold

首次会话积分消耗偏高属正常现象

Agent 每次请求都会携带固定的工具定义和系统提示（通常有数万 token）。首次会话这部分内容需要写入缓存，按全量输入计费，所以消耗的积分会比较多；之后的请求命中缓存，这部分按低价缓存计费，消耗会明显下降。这是正常现象，并非多扣费。如有大量使用需求，请联系客服，我们可提供优惠。

按官方文档配置；未进行客户端实测配置入口支持不等于每个模型、每项 Agent 功能都已验证。

安装与准备

通过官方文档中的安装入口安装正式版本；编辑器插件请在对应商店选择官方发布者。到 ModelFold API Keys 创建密钥。配置中出现 MODELFOLD_API_KEY 时，启动工具前设置环境变量：

bash

export MODELFOLD_API_KEY="YOUR_MODELFOLD_API_KEY"

密钥不要提交到项目仓库或贴到截图中。图形界面密钥框通常填写原始 Key，由客户端添加认证头。

配置位置： Model Settings → Add Provider。验证状态： 按官方文档配置；未进行客户端实测

从智谱官方安装页安装 ZCode。新建供应商，分别填写 Anthropic／OpenAI 地址和 Key，添加准确模型 ID 后启用。

text

Provider: Anthropic Messages
URL: https://modelfold.ai/anthropic
API Key: YOUR_MODELFOLD_API_KEY
Model ID: claude-opus-5-5

不要把额外推理参数塞入 options：官方说明这里只读取连接字段。

接 Claude 优先使用 Anthropic 原生格式，符合条件的重复上下文可使用缓存；命中仍取决于模型、前缀和客户端是否发送缓存标记，不能保证每轮都命中。

字段	填写内容
本页示例地址	`https://modelfold.ai/anthropic`
API 模型 ID	`claude-opus-5-5`
凭证	ModelFold 控制台创建的 API Key

模型 ID 以全部模型 ID为准。openai/ 等前缀在部分 CLI 中用来选择适配器，不属于服务端模型 ID。不同工具拼接路径的规则不同，严格按本页填写，不重复添加 /v1 或 /messages。

新建会话，明确选中刚配置的提供商与模型，发送：只回复 OK，不要使用工具。 收到回复只证明该模型的基本对话可用。再到 ModelFold 用量记录核对相应请求；模型出现在列表里不代表连通性验证通过。开始长任务前，可在临时项目中试一次小修改。

现象	处理
401	检查是否为 ModelFold Key，而非工具订阅凭证；去掉首尾空格。
404	核对协议、路径后缀与准确模型 ID，避免重复 `/v1`。
模型列表为空	支持手动输入的工具可复制准确 ID；环境变量修改后重启客户端。
对话通但工具调用失败	选择支持工具调用的模型；基本聊天兼容不保证全部 Agent 功能。
仍然调用内置服务	显式切换到自定义提供商，检查旧设置和环境变量覆盖。

报价以模型价格页为准。一次任务可能产生多次请求；实际扣费以账户记录为准，客户端估算不等于实际扣费。