Claude Code 对接 modelfold.ai 使用指南

通过简单的环境变量配置,就能让本机的 Claude Code 通过 modelfold.ai 接入,使用你在 modelfold.ai 的账号额度。安装时间取决于网络。

---

准备工作

准备 ModelFold API Key，并确保账户有可用积分。推荐只设置原始 Key 的 ANTHROPIC_AUTH_TOKEN，不要加 Bearer ，不要同时设置另一种凭据。

配置项	值
ANTHROPIC_BASE_URL	https://modelfold.ai/anthropic
ANTHROPIC_AUTH_TOKEN	你的 ModelFold API Key（原始值）

第一步:安装 Claude Code

Mac 用户

打开「终端」,粘贴执行:

curl -fsSL https://claude.ai/install.sh | bash

原生安装不需要 Node.js。国内网络可能把安装地址重定向到 app-unavailable-in-region，随后出现 syntax error near unexpected token '<'，这表示返回了 HTML，不能继续当安装脚本执行。请使用可访问官方安装源的代理，再重试；端口以你自己的代理设置为准：

export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"
curl -fsSL https://claude.ai/install.sh | bash

若安装成功但 claude 提示找不到命令：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

Windows 用户

从开始菜单搜索并打开 PowerShell,粘贴执行:

irm https://claude.ai/install.ps1 | iex

安装完成后,运行 claude --version 能看到版本号即表示安装成功。

⚠️ 如果无法运行claude 命令,检查是否为claude添加了环境变量

⚠️ 安装后请不要登录 Anthropic 账号,我们将在下一步直接使用 modelfold.ai 的凭据接入。

如果显示

x Installation failed

Failed to fetch version from https://downloads. claude.ai/claude-code-releases/latest: ECONNREFUSED

请先写入代理网络环境

$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
irm https://claude.ai/install.ps1 | iex

7897 换成你的代理端口。

---

第二步:配置凭据

方式 A:写入系统环境变量(推荐)

一次配置,以后任意终端运行 claude 都会自动走 modelfold.ai。

Mac

打开终端,把下面整段粘贴执行(请先把 Key 换成你自己的):

echo 'export ANTHROPIC_BASE_URL="https://modelfold.ai/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的MODELFOLD_API_Key"' >> ~/.zshrc
source ~/.zshrc

Windows

打开 PowerShell,粘贴执行(请先把 Key 换成你自己的):

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://modelfold.ai/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的MODELFOLD_API_Key", "User")

Mac 执行 source ~/.zshrc 后当前终端即可使用。Windows 的用户环境变量只对新进程生效，请重新打开终端；若在编辑器内使用，也需重启编辑器。

---

方式 B:写入 Claude Code 配置文件

只在运行 claude 时生效,不会影响系统其它程序,更适合洁癖用户。

打开下面这个文件(若不存在请新建),写入内容并替换 Key:

• Mac:~/.claude/settings.json
• Windows:C:\Users<你的用户名>.claude\settings.json

ANTHROPIC_AUTH_TOKEN（不需要加 Bearer）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelfold.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的MODELFOLD_API_Key"
  }
}

---

方式 C: CC-SWITCH

安装步骤：

• 下载 CC-Switch-Windows.msi 文件。

https://github.com/farion1231/cc-switch/releases

• 双击运行安装包，按照向导完成安装。
• 安装完成后，在开始菜单或桌面找到 CC Switch 并启动。

填入信息：

• API KEY（无需Bearer）
• 请求地址 'https://modelfold.ai/anthropic' (建议关闭完整URL)
• 在高级选项中填入ModelFold文档中对应的模型名

保存后启用即可

---

选择模型并做最小验证

先在当前终端设置用于查询的 Key，再获取平台当前提供的模型列表（此处与前面的凭据是同一个 Key）：

export MODELFOLD_API_KEY="你的MODELFOLD_API_Key"
curl -fsS -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  https://modelfold.ai/anthropic/v1/models

从响应的 data[].id 复制一个模型名，替换下面的 模型ID。不要假定 Claude Code 的默认模型或别名在平台可用：

claude -p "你好，请简短回复" --model "模型ID"

PowerShell 查询时使用 $env:MODELFOLD_API_KEY 和 curl.exe。若要固定默认模型，可在用户级 settings.json 的 env 中添加 ANTHROPIC_MODEL，值为查询得到的 id。

模型列表返回 200 只说明鉴权和模型发现成功；必须实际收到回复才能确认生成可用。若显示 429 / Resources are tight, please try again later，是请求到达上游后资源紧张；若显示 400 Internal error, please try again later，也不算接入验证通过。稍后再试或从列表选择其他模型，不要反复改 Key 或把 BASE_URL 改回 /v1/anthropic。

第三步:验证是否成功

打开终端,在任意目录运行:

claude

进入交互界面后,随便问一句话(例如「你好」)。

• ✅ 能正常回复 → 已成功对接 modelfold.ai,并在ModelFold的logs页面中查看到具体使用记录,可以开始使用
• ❌ 提示要登录 Anthropic 账号 → 请查看下方「常见问题」第 1 条

---

常见问题

现象	原因 / 解决方案
启动时仍要求登录 Anthropic 账号	环境变量未生效。请完全关闭所有终端窗口(Mac:右键「退出终端」;Windows:关掉所有 PowerShell 进程)后重新打开
报错 401 Unauthorized	API Key 错误或已过期；若用 ANTHROPIC_AUTH_TOKEN 则直接填 Key 不加前缀；请到 modelfold.ai 后台核对
模型不可用	在 Claude 中运行 /model，改用 GET https://modelfold.ai/anthropic/v1/models 列出的模型 id。
Windows 改完仍无效	必须关闭所有终端,包括 VSCode、Cursor 等编辑器的内置终端,整个软件退出后重开

如需查看 Claude Code 实际发出的请求,可使用 claude --debug 启动并查看详细日志；分享前先检查并移除凭据、提示词和文件内容。

---

安全提示

• API Key 请妥善保管,切勿截图、复制到聊天群或提交到代码仓库
• 若配置文件放在项目目录下,务必将 .claude/settings.json 加入 .gitignore(放在用户主目录下则默认安全)
• 一旦泄漏,请立即到 modelfold.ai 后台重置 Key

---

如有任何问题,欢迎随时联系我们。