常见问题
通用
aicentos 是什么？
aicentos 是一个 AI Coding 中转站，支持 Claude、Codex 模型在多种平台使用。
支持哪些工具？
目前支持以下工具：
- Claude Code — Anthropic 官方 CLI
- OpenAI Codex — OpenAI 官方编程助手
- RooCode — VS Code AI 编程插件
- Qwen Code — 阿里通义千问编程工具
- Droid CLI — 轻量级 AI 编程 CLI
- OpenCode — 开源 AI 编程终端工具
数据隐私如何保障？
aicentos 仅作为 API 中转服务，不存储你的代码和对话内容。所有请求直接转发至对应的模型提供商。
建议
敏感项目建议在使用前阅读各模型提供商的隐私政策。
账户与 Token
如何注册？
访问 aicentos，按提示完成注册即可。
如何获取 API Token？
注册后登录控制台，前往 Token 管理页 创建新的 Token。
Token 有效期多长？
Token 在手动删除或重新生成前持续有效。建议定期轮换以确保安全。
用量额度是多少？
aicentos 为每个用户提供用量额度，具体数量根据平台资源动态调整。请关注控制台中的用量信息。
注意
额度用尽后请求会被拒绝，请合理规划用量。
工具配置
环境变量设置后不生效怎么办？
检查以下常见原因：
- 未重启终端 — 修改
.bashrc/.zshrc后需要执行source ~/.bashrc或新开终端 - 变量名拼写错误 — 注意区分大小写，如
ANTHROPIC_BASE_URL不能写成Anthropic_Base_Url - 多余的引号或空格 —
export KEY="value"中 value 前后不要有多余空格
快速排查命令
bash
# 检查变量是否已设置
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
# 如果为空，说明变量未生效配置文件路径在哪里？
| 工具 | 配置文件路径 |
|---|---|
| Claude Code | 环境变量方式配置 |
| Codex | ~/.codex/config.toml 和 ~/.codex/auth.json |
| RooCode | VS Code 设置 JSON |
| Qwen Code | 环境变量方式配置 |
连接不上 aicentos 服务怎么办？
- 确认
BASE_URL设置为https://www.aicentos.com/（注意末尾的/） - 检查网络是否能访问
https://www.aicentos.com/ - 如果在公司网络中，确认代理设置是否正确
模型选择
如何选择合适的模型？
根据使用场景选择：
| 场景 | 推荐模型 | 理由 |
|---|---|---|
| 日常编程 | claude-sonnet-4-5-20250929 | 能力与速度均衡 |
| 快速补全 | claude-3-5-haiku-20241022 | 响应速度快 |
| 复杂架构 | claude-sonnet-4-5-20250514 | 推理能力强 |
不同模型之间有什么差异？
- Sonnet 系列：能力全面，适合大多数编程任务
- Haiku 系列：轻量快速，适合简单补全和格式化任务
- 具体的模型能力差异请参考各提供商的官方文档
如何切换模型？
通过环境变量 ANTHROPIC_MODEL 指定：
bash
export ANTHROPIC_MODEL=claude-sonnet-4-5-20250929故障排除
提示认证失败（Auth Error）
常见原因
- Token 输入有误（多余空格或不完整）
- Token 已被删除或重新生成
API_KEY和AUTH_TOKEN未同时设置
解决方法：前往 控制台 确认 Token 状态，重新复制粘贴。
如何查看和理解错误日志？
进入 控制台 → 使用日志，将日志类型切换为 错误日志，可按时间、模型、Token、分组、请求 ID、错误消息和状态码筛选。
排查建议
- 优先复制接口响应或日志中的
request_id，在使用日志中精确搜索同一次请求 - 用“错误消息”搜索
content中的关键词，例如Invalid token、Upstream request failed - 用“状态码”快速聚合问题类型，例如
400、401、403、413、429、500、502、503、504 - 如果同一分组集中出现相同错误，优先按分组判断是配置问题、用量问题还是上游可用性问题
完整字段说明、状态码分类和常见错误表请查看 错误日志说明。
分组健康状态怎么看？
分组健康状态用于判断问题是个别请求异常，还是某个套餐、模型或上游分组集中异常。优先看 success_rate、error_count 和 error_reasons，再结合单条日志中的 request_id 定位具体请求。
完整状态页、字段说明和排查流程请查看 分组健康状态。
请求超时（Timeout）
可能原因：
- 网络延迟过高
- 请求的上下文过长，模型处理时间较久
- 当前服务负载较高
建议：减小输入上下文，或稍后重试。
触发频率或额度限制（Rate Limit）
收到 429 状态码通常表示请求过于频繁，也可能表示上游账号日额度已用尽，或当前模型凭证正在冷却。
应对方法
- 降低请求频率，间隔几秒后重试
- 避免在脚本中无间隔循环调用 API
- 检查是否有其他进程在同时使用同一 Token
- 如果日志包含
Max 10/min或Max 5/min，按提示把并发和每分钟请求数降到阈值以下 - 如果日志包含
daily limit exceeded，等待每日额度重置，或切换其他可用模型/分组 - 如果日志包含
cooling down，不要立即连续重试，等待冷却结束或临时切换模型
返回模型不可用（Model Not Available）
检查指定的模型名称是否正确，参考 快速开始 中的推荐模型列表。部分模型可能尚未在 aicentos 上线。