Claude Code

当前状态：待复验。Claude Code 使用 Anthropic Messages 语义而非 OpenAI Chat Completions；环境变量可配置不代表任意版本的模型、流式、工具调用或权益已通过平台验证。

前置条件

• 确认当前版本仍支持官方的 LLM Gateway 配置。
• 将 API Key 保存为本机安全环境变量或受控密钥管理条目，不能写入 shell 历史、仓库 .env、截图或工单。
• 从模型目录复制原始模型 ID，并先明确使用通用余额还是 Coding Plan。
• 首次配置在隔离工作区完成，先审查文件、命令和网络权限。

入口与计费方式

场景	Base URL	协议	权益
通用余额	https://tokenfactory.cn/api	Anthropic Messages	通用余额
Coding Plan	https://tokenfactory.cn/api/anthropic	Anthropic Messages	Coding Plan

两种入口都使用控制台 API Key，但权益语境不同；套餐不足、过期或模型不在范围内时不会自动改扣通用余额。

准确配置

1. 在当前终端会话或 Claude Code 支持的安全配置位置提供 API Key。
2. 按上表选择 Base URL，并设置 ANTHROPIC_AUTH_TOKEN 与模型目录中的 ANTHROPIC_MODEL。
3. 启动后确认会话读取了预期变量；切换余额与套餐时必须显式更换入口。

export ANTHROPIC_BASE_URL=https://tokenfactory.cn/api
export ANTHROPIC_AUTH_TOKEN="$TOKENFACTORY_API_KEY"
export ANTHROPIC_MODEL="<model-id>"

验证

发起不含敏感信息的最小任务，使用诊断信息确认 Base URL、模型和令牌变量生效，但不要打印令牌值。

故障排查

• 认证失败：检查变量是否只设置在父 shell、是否有多余引号或已过期。
• 模型不可用：回到模型目录核对模型 ID 与权益语境。
• 余额、套餐、限额和超时：参考错误处理，不要将失败请求盲目切换到另一条计费路径。

安全提示

输出已开始后发生中断时结果可能未知。对于会修改文件或执行命令的任务，先人工检查状态，再按流式与重试决定是否继续。

更新信息

本页保持待复验。未来真实复验后仅在本页补充测试版本、验证日期、适用入口和已知限制。