Claude Code 接入

Claude Code 可直接通过 TokenHouse 驱动,无需任何中间代理。

推荐设置 ANTHROPIC_AUTH_TOKENANTHROPIC_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
 
claude

ANTHROPIC_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_errorkey 无效或已撤销/account/keys 核对 key 状态,必要时新建
400 invalid_request_errorunknown_modelDEFAULT_* 钉的模型名不在网关可调用列表里GET /v1/models/models 页核对别名拼写
402 insufficient_funds_error组织余额不足(strict_reserve_failedflex_threshold_breached/account/billing 充值