常见问题
查找 BetterToken 账号、充值计费、余额用量、API Key、Base URL、模型调用、外部工具配置以及常见连接错误的解答和排查方法。
AI Coding 工具 FAQ
这些页面面向搜索 Claude Code、Codex、Cursor、Cline 等 AI Coding 工具配置和概念的开发者。它们先解释工具本身，再说明 API Key、Base URL、协议和用量观察如何与 BetterToken 相关。
- Claude Code 是什么？它是如何工作的？
- Claude Code 和 Claude Desktop 有什么区别？
- Claude Code 和 Cursor 哪个更适合本地开发？
- Claude Code 是用 Claude.ai 账号还是 API Key？
- 如何在 Claude Code 中配置 API Key 和 Base URL？
- Kimi K3 接入 Claude Code 配置指南: 手动将 Kimi K3 接入 Claude Code：在
settings.json或 VS Code 中填写 BetterToken API Key、Base URL 和kimi-k3模型映射。 - Claude Code 中的 CLAUDE.md 是什么？应该怎么写？
- 如何在 Claude Code 中切换 Sonnet 和 Opus？
- Claude Code 权限和 hooks 是什么？
- Claude Desktop 如何配置 MCP？
- Claude Desktop 自定义接入
- Claude Desktop：SSL 证书与加载故障排查: Claude Desktop 已连接 API 但无响应，或提示 SSL certificate has expired 时，通过 CC Switch 本地路由和 Needs model mapping 排查。
- Claude Desktop Cowork 和 Code Gateway 有什么区别？
- Codex CLI 是什么？
- Codex CLI、Codex App 和 Codex Web 有什么区别？
- 如何配置 Codex CLI 的 config.toml？
- Codex：1M 上下文的 GPT-5.6 Sol 配置: 在
config.toml中为 GPT-5.6 Sol 设置百万 token 上下文和自动压缩阈值，或仅为单次 Codex CLI 会话临时启用。 - Codex CLI 中 model_provider、base_url 和 wire_api 是什么？
- Codex CLI 中 review_model 和 reasoning_effort 是什么？
- Codex CLI 中的 AGENTS.md 是什么？应该怎么写？
- Codex CLI sandbox 和 approval mode 是什么？
- 如何在 Codex API 模式配置 GPT-6 Astra？
- 如何在使用第三方 API 的同时保留 Codex 登录态？
- Codex：保留官方登录并用第三方 GPT Image 生图: 保持 Codex 官方账号登录与文字模型配置，通过独立生图 Skill 接入 BetterToken GPT Image API，了解安装提示词、密钥配置、生图、参考图编辑和排错步骤。
- Cursor 如何配置自定义 OpenAI API Key 和 Base URL？
- Cursor Rules、AGENTS.md 和 .cursorignore 是什么？
- Cursor 如何配置 MCP？
- Cline 如何配置 OpenAI-compatible API？
- GLM 接入 OpenCode：Model ID 与模型验证: 使用 BetterToken API Key、Base URL 和准确的 Model ID 在 OpenCode 中配置 GLM，验证所选模型并排查认证与配置错误。
- Kimi K3 API 接入 OpenCode 配置指南: 通过 BetterToken 将 Kimi K3 接入 OpenCode：使用
/connect或opencode.json填写 API Key、Base URL 和kimi-k3Model ID。 - OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？
- Claude Code 和 Codex CLI 有什么区别？
- MCP 和 API Key / Base URL 有什么区别？
账号与计费
- 推荐计划奖励规则是什么？: 了解推荐朋友注册和首次充值后的 10% 奖励规则、奖励余额的使用方式，以及需要人工审核的情况。
BetterToken 是如何计费的？
BetterToken 按实际消耗的 token 量计费，与 Anthropic / OpenAI 官方定价保持一致，不额外收取溢价。
具体定价请参考定价页面。
注册后可以退款吗？
如需退还已充值的金额，请联系客服处理。
是否可以同时在多个工具中使用同一个 API Key？
可以。同一个 API Key 可以同时在 Claude Code、Codex、Cursor 等多个工具中使用，额度共享。
如何查看用量？
登录控制台后，在账户管理页面可以查看当前用量和消费记录。
接入与配置
BetterToken 的 base_url 是什么？
BetterToken 现在按协议区分两个地址：
| 场景 | Base URL |
|---|---|
Claude Code / ANTHROPIC_BASE_URL | https://bettertoken.ai |
Codex / OPENAI_BASE_URL / 其他外部工具 | https://bettertoken.ai/v1 |
不再使用“一个地址适配所有协议”的写法。
接入 Claude Code 时需要指定模型吗？
使用 BetterToken API Key、Base URL https://bettertoken.ai 和你选择的 Model ID 接入 Claude Code。 把 YOUR_MODEL_ID 替换为复制的模型 ID。ANTHROPIC_MODEL 设置主模型，三个 ANTHROPIC_DEFAULT_*_MODEL 变量分别设置 Haiku、Sonnet 和 Opus 别名。可以使用同一个模型，也可以为各角色选择不同模型。 从模型广场复制准确的 Model ID。
接入 Codex 时需要指定模型吗？
从模型广场复制准确的 Model ID。
接入 Cursor 等其他工具时需要指定模型吗？
从模型广场复制准确的 Model ID。
OpenClaw 和其他外部工具需要额外 headers 吗？
通常不需要。
根据我们核对到的官方文档，Cursor、Cline、Zed 等常见外部工具的默认接入说明都聚焦在 Base URL、API Key 和模型 ID。OpenCode 与 OpenClaw 虽然支持可选 headers，但官方文档的定位也是自定义 headers / custom auth needs，而不是 BetterToken 默认接入的必填项。
只有当工具官方文档，或你额外接入的上游网关、租户路由、审计、缓存服务明确要求额外 headers 时，再按对应文档补充。
配置后提示认证失败怎么办？
请检查以下几点：
- API Key 是否正确，没有多余空格
- Claude Code 是否使用
https://bettertoken.ai，Codex / 外部工具是否使用https://bettertoken.ai/v1 - 是否存在旧的
ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、OPENAI_API_KEY或OPENAI_BASE_URL覆盖了配置 - 外部工具是否存在额外的官方接入要求，例如特定版本限制、模型白名单，或上游网关明确要求的额外 headers
如仍有问题，请联系客服。
模型调用
- 如何选择合适的 AI 模型？: 根据工具协议、任务类型、质量、速度、上下文长度和成本选择 AI 模型，并在模型广场确认可用模型。
- 为什么大模型不知道自己的版本号？: 解释通过 API 调用时模型可能无法准确回答自身版本的原因，以及如何验证实际调用的模型。
- Base URL 怎么填？: 说明 Claude Code、Codex、Cursor、Cline 等工具中 Base URL、
/v1路径、API Key 和 Model ID 的匹配方式。 - max_tokens 是什么？不设置会怎样？: 解释
max_tokens、max_completion_tokens、max_output_tokens的区别，以及如何设置模型输出 token 上限。 - 如何用 Pydantic 校验结构化 JSON？: 使用 Pydantic 校验 LLM 返回的 JSON，保留原始响应，并显式处理修复与重试。
成本与 Token
- Claude Code token 为什么消耗很多？如何降低成本？
- BetterToken 支持缓存计费吗？: 说明提示词缓存、缓存命中字段、不同模型协议的差异，以及如何判断请求是否命中缓存。
- Responses 与 Messages：输入 Token 差异: 了解为什么同一 API Key 和模型通过 Responses API 与 Messages API 会记录不同的输入 Token，以及如何进行公平对比。
可靠性与限流
- Codex 使用额度还是 API 429：你遇到的是哪一种限制？: 在重试前，区分 Codex 套餐使用额度、API 速率限制、消费上限与 BetterToken 余额问题。
BetterToken 是如何保证可靠性的？
BetterToken 同时接入多家供应商，并通过以下机制保障稳定性：
- 多源供应：某个供应商故障时自动切换，不影响你的请求
- 动态路由：实时检测各链路状态，选择响应最快、成功率最高的路径
- 精选旗舰：围绕 Claude Code 与 Codex 生态集中保障核心链路的可用性
遇到限流或超时怎么办？
BetterToken 的多源路由机制会自动处理单一供应商的限流和超时。如果你遇到持续的限流问题：
- 检查账户余额是否充足
- 适当增大工具的超时时间（建议设置
API_TIMEOUT_MS=3000000） - 联系客服了解当前配额情况
BetterToken 是否适合生产环境？
BetterToken 主要面向 AI 编程工具的个人开发者场景（Claude Code、Codex 等）。对于大批量的生产环境 API 调用，建议结合实际情况评估。
隐私与安全
- BetterToken 如何保障数据安全？: 说明 BetterToken 在 API 调用中的数据安全边界、传输安全、日志用途和用户侧安全建议。
BetterToken 会存储我的请求内容吗？
BetterToken 作为 API 中转层处理请求，不会持久化存储用户的对话内容。详细的隐私条款请参考隐私政策。
API Key 泄露了怎么办？
立即登录控制台，删除旧的 API Key 并重新生成一个。同时检查使用该 Key 的工具配置，替换为新 Key。
区域访问
- 俄罗斯用户使用 API 需要 VPN 吗？: 说明俄罗斯区域站点的直连访问方式、无需 VPN 的使用场景，以及网络异常时的排查步骤。