常见问题 & 疑难排错

常见问题

BytePass 是什么？

BytePass 是一个 AI 模型 API 网关。提供一个统一的 API 地址和 Key，即可使用 Anthropic（Claude）和 OpenAI（GPT）的模型——无需 VPN，无需境外信用卡。

怎么计费？

BytePass 采用余额制（非订阅制）。充值后按 Token 用量扣费。不同模型有不同倍率：

完整列表见 模型页面。

支持哪些工具？

所有支持 OpenAI 兼容 API 格式的工具都可以使用 BytePass。常用工具：

• Claude Code — Anthropic 官方终端编程助手 → 配置教程
• Codex CLI — OpenAI 终端编程工具 → 配置教程
• Gemini CLI — Google 终端工具
• Cherry Studio — 跨平台 AI 聊天客户端
• OpenCode — 终端 AI 编程助手
• Alma — AI 对话客户端

API 地址是什么？

https://api.bytepass.ai

使用 OpenAI 格式的工具（Codex、Cherry Studio 等）填 https://api.bytepass.ai/v1。

Claude Code 填 https://api.bytepass.ai（不加 /v1——Claude Code 会自动补全路径）。

数据安全吗？

BytePass 是透明代理。你的请求被转发到上游提供商（Anthropic/OpenAI），响应原样返回给你。BytePass 不存储你的对话内容。

疑难排错

401 Unauthorized（未授权）

• API Key 不正确或已过期
• 账户余额为零
• 解决： 在 控制台 检查 Key 和余额

400 Bad Request

• Base URL 格式错误（比如 Claude Code 的 URL 多加了 /v1）
• 解决： Claude Code 用 https://api.bytepass.ai（不带 /v1）；Codex / OpenAI 工具用 https://api.bytepass.ai/v1

429 Too Many Requests（请求过多）

• 触发了速率限制
• 解决： 等一会儿重试。如果持续出现，检查控制台中 Key 的速率限制设置

连接超时

• 网络问题
• 解决： 测试 API 是否可达：curl https://api.bytepass.ai/v1/models -H "Authorization: Bearer 你的KEY"。如果返回模型列表，说明 API 正常，问题在工具配置

Claude Code 一直要求登录

• API Key 未配置，或当前终端没有加载环境变量
• 解决： 通过 CC-Switch（推荐）配置，或在 ~/.claude/settings.json 中设置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。配置后打开新终端。

环境变量不生效

• 编辑了 shell 配置但没有打开新终端
• 存在之前配置留下的冲突变量
• 解决： 打开新终端。检查：env | grep ANTHROPIC 或 env | grep OPENAI

"model not found"（找不到模型）

• 请求了 BytePass 不支持的模型
• 解决： 查看支持的模型列表 bytepass.ai/models 或调用 API：GET https://api.bytepass.ai/v1/models

快速排查清单

# 1. 检查 API 连通性
curl https://api.bytepass.ai/v1/models -H "Authorization: Bearer 你的KEY"

# 2. 检查 Claude Code 配置
cat ~/.claude/settings.json

# 3. 检查 Codex 配置
cat ~/.codex/config.toml
cat ~/.codex/auth.json

# 4. 检查 Claude Code 版本
claude --version

如果以上检查都通过但问题仍然存在，可以尝试重新安装工具，或使用 CC-Switch 重置配置。