平台使用
常见问题
hahacode 使用中的常见问题
余额充足但提示「额度不足」？#
令牌额度和账户余额是分开的。每个令牌有自己的使用上限，即使账户余额充足，令牌额度用完了也会报错。
解决方法：在控制台编辑令牌，增加额度或开启「无限额度」。
提示「没有可用渠道」？#
你请求的模型不在当前令牌的分组内，或该分组的所有渠道都不可用。
解决方法：换一个包含该模型的分组创建新令牌，或换一个模型试试。
应该选哪个分组？#
- 要小米模型：
XiaoMi/xiaomi - 要 GPT / Codex：
gpt-plus或gpt-pro - 要图像生成：
gpt-image生图分组 - 要 Claude / Kiro：
kiro-特价
具体可用渠道和模型以官网控制台的「可用渠道」菜单为准，详见模型与分组。
请求返回 401 错误？#
- 检查 API Key 是否正确（注意前后空格）
- 确认 Key 没有被删除或禁用
- 确认请求头格式：
Authorization: Bearer sk-你的KEY
价格以哪里为准？#
渠道、模型和价格可能调整，请以官网控制台的「可用渠道」菜单和调用日志实际记录为准。
支持哪些工具？#
hahacode 兼容 OpenAI API 格式，支持所有兼容 OpenAI 的工具，包括：
- Claude Code
- Codex
- OpenCode
- OpenClaw
- Cherry Studio
- 以及其他兼容 OpenAI API 的工具
Claude Code 里怎么切换模型？#
想用 gpt-5.5、mimo-v2.5-pro 等第三方模型，在 CC Switch 的「编辑供应商 → 模型映射」里，把 Claude 别名指向目标模型即可，无需改 JSON。详见 Claude Code 切换模型。
Claude Code 缓存命中率低、费用偏高？#
八成是 Claude Code 默认开启的归属 header 在作祟 —— 每次请求携带动态会话 ID，会直接击穿上游 prompt cache。 在 CC Switch「编辑供应商 → 配置 JSON」的 env 里加一行：
json
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"不论用 Claude 官方还是第三方模型都建议关闭。详见 关闭归属 Header。
提示「上下文长度过大」怎么办？#
这通常是因为对话上下文超过了模型的上下文窗口限制。解决方法：
- 在 Claude Code 中使用
/compact命令手动压缩上下文 - 配置自动压缩：在
~/.claude/settings.json的env中添加"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"，数值越小越早触发压缩 - 换用当前分组里上下文更大的模型，或压缩对话后继续
API 地址是什么？#
主地址：https://hahacode.com/v1。也可以直接使用加速地址：https://cn.hahacode.com/v1。控制台、充值、兑换等页面也支持加速域名 https://cn.hahacode.com。 不同工具填写方式略有不同，具体请看各工具的配置页面。