CodeGPT 接入 ModelFold
首次会话积分消耗偏高属正常现象
Agent 每次请求都会携带固定的工具定义和系统提示（通常有数万 token）。首次会话这部分内容需要写入缓存，按全量输入计费，所以消耗的积分会比较多；之后的请求命中缓存，这部分按低价缓存计费，消耗会明显下降。这是正常现象，并非多扣费。如有大量使用需求，请联系客服，我们可提供优惠。
按官方文档配置；未进行客户端实测 配置入口支持不等于每个模型、每项 Agent 功能都已验证。
安装与准备
通过官方文档中的安装入口安装正式版本；编辑器插件请在对应商店选择官方发布者。到 ModelFold API Keys 创建密钥。配置中出现 MODELFOLD_API_KEY 时，启动工具前设置环境变量：
export MODELFOLD_API_KEY="YOUR_MODELFOLD_API_KEY"密钥不要提交到项目仓库或贴到截图中。图形界面密钥框通常填写原始 Key，由客户端添加认证头。
配置提供商
配置位置： VS Code → Change model → LLMs Cloud → Custom。验证状态： 按官方文档配置；未进行客户端实测
需 Professional 或 Teams 方案。在 Custom 中填写模型 ID、API Key 和完整 completion endpoint，再点 Connect。
Provider: OpenAI Compatible / Chat Completions
URL: https://modelfold.ai/v1/chat/completions
API Key: YOUR_MODELFOLD_API_KEY
Model ID: gpt-6-luna此处填写完整 /v1/chat/completions；不是 Azure 专属的 Custom Link。
通过 OpenAI 兼容格式长对话调用 Claude 不使用原生 Claude 提示词缓存；长任务可选自带缓存的模型，或换用支持 Anthropic 原生格式的客户端。
模型与地址
| 字段 | 填写内容 |
|---|---|
| 本页示例地址 | https://modelfold.ai/v1/chat/completions |
| API 模型 ID | gpt-6-luna |
| 凭证 | ModelFold 控制台创建的 API Key |
模型 ID 以全部模型 ID为准。openai/ 等前缀在部分 CLI 中用来选择适配器，不属于服务端模型 ID。不同工具拼接路径的规则不同，严格按本页填写，不重复添加 /v1 或 /messages。
验证
新建会话，明确选中刚配置的提供商与模型，发送：只回复 OK，不要使用工具。 收到回复只证明该模型的基本对话可用。再到 ModelFold 用量记录 核对相应请求；模型出现在列表里不代表连通性验证通过。开始长任务前，可在临时项目中试一次小修改。
常见问题
| 现象 | 处理 |
|---|---|
| 401 | 检查是否为 ModelFold Key，而非工具订阅凭证；去掉首尾空格。 |
| 404 | 核对协议、路径后缀与准确模型 ID，避免重复 /v1。 |
| 模型列表为空 | 支持手动输入的工具可复制准确 ID；环境变量修改后重启客户端。 |
| 对话通但工具调用失败 | 选择支持工具调用的模型；基本聊天兼容不保证全部 Agent 功能。 |
| 仍然调用内置服务 | 显式切换到自定义提供商，检查旧设置和环境变量覆盖。 |
报价以模型价格页为准。一次任务可能产生多次请求；实际扣费以账户记录为准，客户端估算不等于实际扣费。