在 Claude Code 中使用 ZhiFlo

这条路径适合已经在用 Claude Code 的用户。你会在当前终端里临时把请求改走 ZhiFlo，关掉窗口后再回到原来的 Claude Code 环境。

开始前

• 已按照 Claude Code 安装说明安装客户端；claude --version 能显示版本信息。
• 已创建一枚当前设备专用的 Token。
• 已复制账户当前可用的完整 模型 ID。

1. 在当前终端设置网关

ZhiFlo 的 Claude Code 网关地址不带 /v1。Bearer Token 必须放在 ANTHROPIC_AUTH_TOKEN，不要改用 ANTHROPIC_API_KEY。

macOS、Linux 或 Bash

先设置地址，再在隐藏输入中粘贴 Token：

export ANTHROPIC_BASE_URL="https://api.zhiflo.com"
read -s ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_AUTH_TOKEN

PowerShell

先设置地址，再在安全输入框中粘贴 Token：

$env:ANTHROPIC_BASE_URL = "https://api.zhiflo.com"
$secureToken = Read-Host "Paste your ZhiFlo Token" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secureToken).Password

这些变量保存在当前进程环境中。不要把 Token 写进项目文件、命令参数或可同步的 shell 配置。

2. 启动并核对状态

1. 在刚设置变量的同一个终端启动 Claude Code，并把占位符替换为账户的完整模型 ID：

   claude --model "<MODEL_FROM_ZHIFLO>"

2. 在 Claude Code 中运行：

   /status

   检查 Anthropic base URL 显示 https://api.zhiflo.com，凭据来源对应当前环境变量。

3. 发送一条只读提示：

   不要修改任何文件，只回答 OK。

收到 OK，说明这次临时切换已经成功：Claude Code 读到了当前终端变量，地址走的是 ZhiFlo，模型也真的返回了回复。

常见问题

• /status 仍显示默认地址：退出 Claude Code，在设置变量的同一终端重新启动；不要从另一个窗口启动。
• 返回 401：确认使用的是 ANTHROPIC_AUTH_TOKEN，并重新粘贴未过期、未撤销的 Token。
• 返回 404：删除 ANTHROPIC_BASE_URL 末尾的 /v1。Claude Code 会自行请求 /v1/messages。
• 模型不可用：重新复制当前账户的模型 ID，再用 --model 启动。

关闭当前终端即可移除这次临时网关设置。重新打开 Claude Code 时，它会使用你原来的登录和环境。

下一步：查看 连接问题的分层排查方法。