常见问题
Tokeness 是什么？
Tokeness 是 AI API 网关。你用一个 API Key 调用不同模型，并在控制台查看余额、日志和用量。
Base URL 应该填什么？
所有接入页统一填写：
https://n.tokeness.dev/v1如果某个客户端把字段拆成 Base URL、Endpoint、Host 或 Service URL，请优先把这个完整地址填到支持完整路径的字段里。不要自己删掉 /v1。
为什么调用提示鉴权失败？
常见原因包括 Key 复制不完整、请求头没有使用 Bearer、Key 被停用、环境变量未生效。
Claude Max 和 Claude API 是一回事吗？
不是。Claude Max 是面向个人使用的订阅方案；Claude API 使用 API 密钥调用模型，模型名称或模型 ID 以 API 服务方的控制台/模型市场为准。订阅方案名称不能直接当作 API 模型 ID，也不能据此证明请求实际使用了某个模型。
返回 401、429 或 5xx 怎么排查？
按以下顺序保留请求信息并排查：
- 401：检查 API Key 是否完整、是否已启用；再检查 Base URL、模型名称、协议类型，以及 OpenAI 兼容请求是否带
Authorization: Bearer <API Key>。 - 429：检查 Key 的额度限制、钱包余额和请求频率；降低并发或稍后重试，并在使用日志中确认是否重复计费。
- 5xx：先记录时间、请求路径、模型名称和返回状态，在使用日志中查看错误原因；避免连续重试，稍后用同一配置重试，仍失败时提供这些信息给支持方。
流式响应中断怎么办？
先确认非流式请求是否成功，再检查客户端超时、网络连接、代理和读取流的实现。记录中断前的状态码、请求路径和模型名称；修复连接或超时设置后，用小请求重试，不要把中断本身当作模型身份或可用性的证明。
为什么提示余额不足？
Tokeness 采用预充值模式。请检查钱包余额，以及当前 API Key 是否设置了额度上限。
模型名从哪里复制？
从 Tokeness 控制台或模型广场复制。模型名需要保持大小写、连字符和版本号一致。
第一次接入时，先复制一个可用模型名，再回到教程里替换 YOUR_MODEL_NAME。
能不能共用一个 Key？
技术上可以。开发、生产、客户项目、自动化任务使用不同 Key，便于限额和排查。
支持哪些工具？
支持自定义 OpenAI 兼容 Base URL 的工具，可以按本文档接入。本文档提供 Cherry Studio、Claude Code、VS Code Claude Code 插件、Cline、Roo Code、Continue、Cursor、Codex CLI、Dify、n8n、Open WebUI、AnythingLLM、LibreChat、LiteLLM、OpenClaw、OpenCode 的配置参考。
Claude Code 安装后命令不存在怎么办？
先确认 Node.js 和 npm 已安装，并重启终端。如果是在 Windows 上使用 Claude Code，使用 PowerShell、WSL2 或工具官方推荐的 shell 环境。
连接 AI 编程工具时报 401 怎么办？
检查工具配置中的 API Key、Base URL、模型名和协议类型。OpenAI 兼容接入使用 https://n.tokeness.dev/v1，请求头使用 Authorization: Bearer <API Key>。
代码示例里的 YOUR_MODEL_NAME 是什么？
它不是固定模型名。请到模型广场复制实际模型名后替换。
Tokeness 支持哪些 AI 模型？
Tokeness 支持多种主流模型。可用模型名称以 Tokeness 控制台或模型广场为准。使用前先从模型广场复制完整模型名，不要使用其他平台或工具里的默认模型名代替。
Tokeness 和直接调用 OpenAI 有什么区别？
Tokeness 是兼容 OpenAI API 格式的网关。接入 OpenAI 兼容工具时，通常只需要替换 base_url 和 api_key，业务代码仍按 OpenAI 兼容格式调用。Tokeness 还提供集中 Key 管理、额度控制、使用日志和多模型接入。
如何在 Claude Code 中使用 Tokeness？
Claude Code 原生使用 Anthropic 协议。Tokeness 通用接口是 OpenAI 兼容协议，所以建议通过 CC Switch 添加 Tokeness 供应商，并开启路由模式完成协议转换。详见 Claude Code 接入指南。
充值支持哪些方式？
充值方式以控制台“钱包”页面展示为准。进入控制台后打开“钱包”，即可查看当前可用的充值渠道、余额和充值记录。