Claude Code
让 Claude Code 走 Half Off Dev,按 Claude 官方价格的一半计费:两个环境变量或 settings.json、模型选择与提示缓存。
Claude Code 从环境变量读取接入地址和凭证,使用的是 Anthropic Messages 协议,而 Half Off Dev 原样提供这一协议、不做任何转换。把这几个变量指向 Half Off Dev,这个终端编程助手就能照常工作,费用按 Anthropic 官方价格的 5 折结算。开始前请先创建 API 密钥。
配置#
想先试试,就 export 三个变量,再在同一个 shell 里启动 claude:
export ANTHROPIC_BASE_URL=https://halfoff.dev
export ANTHROPIC_AUTH_TOKEN=$HALFOFF_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claude想长期生效,就把这些值写进 ~/.claude/settings.json,密钥填完整:
{
"env": {
"ANTHROPIC_BASE_URL": "https://halfoff.dev",
"ANTHROPIC_AUTH_TOKEN": "ho-...",
"ANTHROPIC_MODEL": "claude-sonnet-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
}
}base URL 末尾不要加 /v1,Claude Code 会自己加。
或者从控制台导入#
在 API 密钥页面选择 接入客户端 → Claude Code,就能看到已填好密钥的上述配置。点 用 CC Switch 一键导入,会在 CC Switch 桌面应用里创建 Half Off Dev 供应商并预设好模型(需先安装 CC Switch)。刚创建的密钥会自动填入;旧密钥需要粘贴完整内容,因为 Half Off Dev 只保存哈希。
模型#
Claude Code 有两个模型槽位:ANTHROPIC_MODEL 是你日常对话用的主模型,ANTHROPIC_DEFAULT_HAIKU_MODEL 负责后台的小任务,适合放一个又快又便宜的模型。GET /v1/models 中任何 Claude 模型 ID 都可以用,比如 claude-opus-5.5。完整列表见模型列表。
提示缓存#
Claude Code 非常依赖提示缓存,在这里同样有效。Half Off Dev 会把每个会话固定在持有其缓存的渠道上,所以编程会话中大段重复的上下文,每一轮都按缓存输入价计费。详见提示缓存。
常见报错#
| 现象 | 处理方法 |
|---|---|
401 Missing API key | 密钥没有发到 Half Off Dev。在运行 claude 的 shell 里 export ANTHROPIC_AUTH_TOKEN,或写进 ~/.claude/settings.json。 |
401 Invalid or revoked API key | 密钥输错、被截断或已吊销。重新粘贴,或新建一个。 |
404 Model '...' is not available | 模型 ID 不存在。从 GET /v1/models 或模型列表复制 Claude 模型 ID。 |
404 且路径里有 /v1/v1/ | ANTHROPIC_BASE_URL 末尾带了 /v1。改成 https://halfoff.dev。 |
402 | 余额已用完,或密钥达到消费上限。见余额与计费。 |
其他状态码见错误码。