Claude Code 接入
Claude Code 可直接通过 TokenHouse 驱动,无需任何中间代理。
推荐设置 ANTHROPIC_AUTH_TOKEN。ANTHROPIC_API_KEY 现在同样可用——网关同时接受这两个环境变量产生的 Authorization: Bearer 头与 x-api-key 头。
配置
设置以下环境变量后直接运行 claude:
export ANTHROPIC_BASE_URL=https://api.tokenhouse.ai
export ANTHROPIC_AUTH_TOKEN=<your-key>
# 把 opus / sonnet / haiku 档位钉到 TokenHouse 的真实模型
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claudeANTHROPIC_DEFAULT_HAIKU_MODEL 同时用作后台 / 快速任务模型(旧的 ANTHROPIC_SMALL_FAST_MODEL 已弃用)。
本页只推荐钉 claude-* 系列模型——Claude Code 的提示词与工具调用都是按 Claude 调校的。可用别名以 GET /v1/models 或 /models 页为准,费率见 /pricing。
持久化
两种方式,任选其一:
方式一:shell rc。 把上面的 export 写入 ~/.zshrc / ~/.bashrc,或放进项目的 .envrc(direnv),每次启动 shell 自动生效。
方式二:Claude Code 自己的配置文件。 在 ~/.claude/settings.json 的 "env" 块里声明,不污染 shell 环境,且对所有项目生效:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.tokenhouse.ai",
"ANTHROPIC_AUTH_TOKEN": "<your-key>",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}Key 明文只在 /account/keys 创建时显示一次。写进配置文件前请确认文件权限;key 撤销后立即失效。
切换模型
会话内输入 /model,即可在 opus / sonnet / haiku 三档之间切换。注意这三档只是「档位」——每档实际指向哪个模型,由上面的 ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL 钉定。
想换模型(比如把 sonnet 档换成 claude-sonnet-4-5),改的是环境变量或 settings.json,改完重启 claude 生效。
验证
claude -p "用一句话介绍你自己"能正常返回即接入成功。
故障排查
| 症状 | 原因 | 解决 |
|---|---|---|
401 auth_error | key 无效或已撤销 | 到 /account/keys 核对 key 状态,必要时新建 |
400 invalid_request_error(unknown_model) | DEFAULT_* 钉的模型名不在网关可调用列表里 | 用 GET /v1/models 或 /models 页核对别名拼写 |
402 insufficient_funds_error | 组织余额不足(strict_reserve_failed 或 flex_threshold_breached) | 到 /account/billing 充值 |