使用 ApiFlux 配置 Claude Code
安装 Claude Code，通过 Anthropic 兼容界面连接 ApiFlux，并验证模型请求。
本指南介绍如何将 Claude Code 连接到 ApiFlux。配置完成后，Claude Code 可以通过 ApiFlux 的 Anthropic-compatible 界面发送请求，并在 ApiFlux 控制台查看记录和用量。
适用场景
适合希望在 Claude Code 中使用 ApiFlux 统一管理模型接入、用量和记录的用户。
如果用户还没有安装终端，可以先阅读：
[!NOTE] Claude Code 可以用官方安装指令码安装，不一定需要 Node.js。但如果用户同时要使用 Codex CLI 或 OpenCode，建议先安装 Node.js LTS。
准备工作
开始前，请准备：
- 一个 ApiFlux API Key
- 一个 ApiFlux 支持 Claude / Anthropic-compatible 协议的模型 ID
ApiFlux 官网入口：
https://apiflux.ai/ApiFlux OpenAI-compatible Base URL：
https://apiflux.ai/v1Claude Code 使用网关时通常通过 ANTHROPIC_BASE_URL 设置界面地址。建议先使用：
https://apiflux.ai如果出现路径相关错误，再尝试：
https://apiflux.ai/v11. 安装 Claude Code
Windows
打开 PowerShell，执行：
irm https://claude.ai/install.ps1 | iex也可以使用 WinGet：
winget install Anthropic.ClaudeCode如果使用 WSL，请在 WSL 终端中按 macOS / Linux 命令安装。
macOS / Linux
打开终端，执行：
curl -fsSL https://claude.ai/install.sh | bashmacOS 用户也可以使用 Homebrew：
brew install --cask claude-code安装完成后，关闭终端并重新打开。
2. 确认 Claude Code 已安装
在终端中执行：
claude --version如果能看到版本号，说明 Claude Code 已安装成功。
也可以执行诊断命令：
claude doctor如果提示 command not found 或「不是内部或外部命令」，请重新打开终端；如果仍然失败，请重新执行安装命令。
3. 准备 ApiFlux API Key
进入 ApiFlux 控制台，打开 API Keys 页面，复制要用于 Claude Code 的 API Key。
如果尚未创建 API Key，请先参考：
4. 配置 Claude Code 环境变量
[!NOTE]
ANTHROPIC_API_KEY中填写的是 ApiFlux API Key，不是 Anthropic 官网 Key。
Windows PowerShell
当前窗口暂时生效：
$env:ANTHROPIC_BASE_URL="https://apiflux.ai"
$env:ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"
$env:DISABLE_INTERLEAVED_THINKING="1"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"检查 Key 是否生效：
echo $env:ANTHROPIC_API_KEY如果希望长期生效，可以执行：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://apiflux.ai","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","YOUR_APIFLUX_API_KEY","User")
[Environment]::SetEnvironmentVariable("DISABLE_INTERLEAVED_THINKING","1","User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS","1","User")设置长期环境变量后，请关闭 PowerShell，再重新打开。
macOS / Linux
当前窗口暂时生效：
export ANTHROPIC_BASE_URL="https://apiflux.ai"
export ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"
export DISABLE_INTERLEAVED_THINKING=1
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1检查 Key 是否生效：
echo $ANTHROPIC_API_KEYmacOS 默认通常是 zsh，长期生效可以写入 ~/.zshrc：
echo 'export ANTHROPIC_BASE_URL="https://apiflux.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.zshrc
echo 'export DISABLE_INTERLEAVED_THINKING=1' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1' >> ~/.zshrc
source ~/.zshrcLinux 常见是 bash，长期生效可以写入 ~/.bashrc：
echo 'export ANTHROPIC_BASE_URL="https://apiflux.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.bashrc
echo 'export DISABLE_INTERLEAVED_THINKING=1' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1' >> ~/.bashrc
source ~/.bashrc5. 选择模型
Claude Code 的模型 ID 应以 ApiFlux Models 页面为准。
如果当前 Claude Code 版本支持通过启动参数指定模型，可以使用：
claude --model "YOUR_MODEL_ID"示例：
claude --model "claude-sonnet-4-6"[!NOTE]
claude-sonnet-4-6仅作为示例。实际可用模型请以 ApiFluxModels页面为准。
6. 发起测试请求
启动 Claude Code：
claude --model "YOUR_MODEL_ID"在 Claude Code 中输入一个简单请求：
请用三句话介绍 ApiFlux，并说明它适合什么用户。如果 Claude Code 正常回复，请回到 ApiFlux 控制台，打开 Logs 查看请求记录。
兼容性说明
部分 Claude Code 版本会默认发送 beta header。第三方网关或部分 Claude 路由可能不接受这些 beta header，从而返回：
invalid beta flag如果出现该错误，请确保启动前已经设置：
DISABLE_INTERLEAVED_THINKING=1
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1如果 https://apiflux.ai 报路径错误，可以改用：
ANTHROPIC_BASE_URL="https://apiflux.ai/v1"常见问题
401 Unauthorized
通常由以下原因导致：
- API Key 填写错误
- API Key 已删除或失效
- 当前终端没有加载环境变量
- Key 中包含多余空格
Windows PowerShell 可执行：
echo $env:ANTHROPIC_API_KEYmacOS / Linux 可执行：
echo $ANTHROPIC_API_KEY如果没有输出，请重新配置环境变量。
404 或 Not Found
通常是 Base URL 路径不匹配。
可先尝试：
https://apiflux.ai如果仍然失败，再尝试：
https://apiflux.ai/v1模型不可用
请回到 ApiFlux Models 页面，确认所选模型支持 Claude / Anthropic-compatible 协议。