Claude Code

Claude Code 通过 Anthropic Messages API 连接 TokenFlux。调用费用从 TokenFlux 余额扣除。

本指南使用 Claude Code 2.1.302 和 claude-fable-5 验证了流式回复。

开始前复制标题链接

1. 准备已安装的 Claude Code。配置详情请参阅官方网关连接指南和模型配置。
2. 在网页版的 API 密钥 页面创建并复制密钥。完整密钥只显示一次。
3. 在 账单 页面确认余额充足。
4. 在 模型与价格 页面复制模型 ID，并检查模型支持的协议。

设置地址和凭据复制标题链接

在 Bash 或 Zsh 中设置以下变量。将 YOUR_MODEL_ID 替换为支持 Messages 和工具调用的模型 ID。如果需要提示缓存，请选择原生支持 Messages 的模型。

export TOKENFLUX_API_KEY="YOUR_TOKENFLUX_KEY"
export ANTHROPIC_BASE_URL="https://tokenflux.ai"
export ANTHROPIC_AUTH_TOKEN="$TOKENFLUX_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"

将 YOUR_TOKENFLUX_KEY 替换为刚复制的密钥。请勿将密钥提交到 Git。

Claude Code 会在此地址后添加 /v1/messages。请勿自行添加 /v1/messages。网关凭据使用 TokenFlux 余额付费。请检查已有 Claude Code 设置，确认 env 配置没有覆盖这些环境变量。

选择模型复制标题链接

下次启动前修改 ANTHROPIC_MODEL，或运行 claude --model YOUR_MODEL_ID。请使用 TokenFlux 模型目录中的完整模型 ID。

验证连接复制标题链接

在临时目录中运行以下命令。如果客户端要求确认文件访问，请核对路径后批准。

printf 'TOKENFLUX_GUIDE_OK\n' > marker.txt
claude -p "Read marker.txt with the Read tool and return its contents" \
  --tools Read --allowedTools Read

回复应包含 TOKENFLUX_GUIDE_OK。在 使用记录 页面确认模型和密钥，并查看 token 数量与费用。测试完成后删除 marker.txt。

故障排查复制标题链接

返回 HTML 或 404。 将 ANTHROPIC_BASE_URL 设为 https://tokenflux.ai。请求路径应为 /v1/messages。

要求登录，或费用记到了其他账号。 在启动 Claude Code 的同一终端设置 ANTHROPIC_AUTH_TOKEN。运行 /status 检查凭据来源和地址。

提示缓存或思考功能无效。 使用原生支持 Messages 的模型。协议转换可能丢失 cache_control 和思考签名。缓存命中还取决于模型和提示内容，此配置不保证每次命中。

返回 401、429 或模型错误。 检查密钥是否启用、模型 ID 是否完整，以及余额和限流状态。请勿自动改用其他模型。

API 参考复制标题链接

请参阅 Messages、模型列表 和 API 概览。