外观
Claude Code
Claude Code 使用 Anthropic Messages 协议,不是 OpenAI /chat/completions 协议。Token Factory 同时提供余额按量入口和 Coding Plan 套餐入口,两者使用同一个 sk-tf-... API Key,由 ANTHROPIC_BASE_URL 决定计费路径。
推荐: Coding Plan 套餐
订阅 Coding Plan 后,Claude Code 推荐使用套餐入口:
bash
export ANTHROPIC_BASE_URL=https://tokenfactory.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-tf-你的密钥
export ANTHROPIC_MODEL=glm-5.2
claudeClaude Code 会自动在 base url 后拼接 /v1/messages,最终请求:
text
https://tokenfactory.cn/api/anthropic/v1/messages该入口按 Coding Plan 套餐额度计费。套餐额度不足、套餐过期或模型不在套餐白名单内时,不会自动改扣余额;需要切回余额入口或调整套餐。
余额按量入口
未订阅套餐,或希望按 token 余额计费时,使用普通 Anthropic 入口:
bash
export ANTHROPIC_BASE_URL=https://tokenfactory.cn/api
export ANTHROPIC_AUTH_TOKEN=sk-tf-你的密钥
export ANTHROPIC_MODEL=glm-4.7
claudeClaude Code 最终请求:
text
https://tokenfactory.cn/api/v1/messages该入口按余额 token 计费,与普通 API 余额共用账户余额。
四种入口对照
| 场景 | 用户填写 | 最终请求 | 计费 |
|---|---|---|---|
| 余额 + OpenAI 兼容工具 | https://tokenfactory.cn/api/v1 | /chat/completions | 余额 token 计费 |
| 余额 + Claude Code | ANTHROPIC_BASE_URL=https://tokenfactory.cn/api | /v1/messages | 余额 token 计费 |
| 套餐 + OpenAI 兼容工具 | https://tokenfactory.cn/api/v1/coding | /chat/completions | Coding Plan 套餐额度 |
| 套餐 + Claude Code | ANTHROPIC_BASE_URL=https://tokenfactory.cn/api/anthropic | /v1/messages | Coding Plan 套餐额度 |
模型选择
不额外配置时,Claude Code 默认的 claude-sonnet 会自动映射到主力国产模型。也可以显式指定 Token Factory 已上架的模型:
bash
export ANTHROPIC_MODEL=glm-5.2Claude Code 档位映射:
| Claude Code 档位 | 映射到国产模型 |
|---|---|
claude-haiku-* | glm-4.5-air |
claude-sonnet-* | glm-4.7 |
claude-opus-* | glm-4.7 |
Coding Plan 首版套餐入口仅支持套餐白名单模型,以套餐页展示为准。
常见问题
Q: Claude Code 为什么不能填 OpenAI Base URL?
Claude Code 请求的是 Anthropic Messages 协议,会调用 /v1/messages;OpenAI 兼容工具调用的是 /chat/completions,两者路径和请求体都不同。
Q: 套餐入口能不能自动扣余额兜底?
不能。Coding Plan 和余额路径强隔离,套餐入口只消耗套餐额度;需要余额计费时,手动把 ANTHROPIC_BASE_URL 改回 https://tokenfactory.cn/api。
Q: 提示 401 / 鉴权失败?
检查 ANTHROPIC_AUTH_TOKEN 是否为有效的 sk-tf- 开头密钥,以及 ANTHROPIC_BASE_URL 是否没有多写 /v1。
Q: 提示模型不可用?
余额入口确认模型在模型目录中已上架;套餐入口确认模型在 Coding Plan 支持模型内。