> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heihuzi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 黑胡子AI便利店 API 常见问题和排查路径。

优先按下面顺序排查：

1. API Key 是否正确。
2. `/v1/models` 是否返回目标模型。
3. 分组是否开启所需能力。
4. 客户端协议是否选对。
5. 上游渠道是否可用。

## 快速定位

| 现象              | 优先查看       |
| --------------- | ---------- |
| 401             | 认证与权限      |
| 403             | 认证与权限      |
| 模型不可见           | 模型问题       |
| 图片失败            | 图像生成问题     |
| Claude Code 调不通 | 认证与权限、模型问题 |