iFlow CLI 接入 ModelFold

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

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

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

安装与准备

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

bash

export MODELFOLD_API_KEY="YOUR_MODELFOLD_API_KEY"

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

配置位置： ~/.iflow/settings.json。验证状态： 按官方文档配置；未进行客户端实测

按官方安装说明安装该工具，将下列配置合并到指定位置，然后选择 ModelFold 模型。

json

{
  "baseUrl": "https://modelfold.ai/v1",
  "apiKey": "YOUR_MODELFOLD_API_KEY",
  "modelName": "gpt-6-luna"
}

通过 /auth 选择 OpenAI 兼容认证；不要使用 iFlow 平台登录方式覆盖这组配置。

通过 OpenAI 兼容格式长对话调用 Claude 不使用原生 Claude 提示词缓存；长任务可选自带缓存的模型，或换用支持 Anthropic 原生格式的客户端。

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

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

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

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