zyc123/Aiapi-doc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

943

Browse Source
This commit is contained in:
zyc123 2026-05-14 18:13:54 +08:00
parent fc151aca48
commit 527dc282b8
1 changed files with 116 additions and 159 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

181
support/troubleshooting.md
View File

@ -1,20 +1,20 @@
# 疑难杂症排查指南 # 疑难杂症排查指南
本文档汇总了 Claude Code、CodeX、Gemini CLI 等 AI 编程工具的常见问题和解决方案。 本文档汇总了 Claude Code、CodeX、Gemini CLI 等 AI 编程工具在使用 oneinai 服务时的常见问题与解决方案。
## 🔍 服务状态查看 ## 服务状态查看
在排查问题前，建议先查看服务状态： 排查问题前，建议先确认 oneinai 服务是否正常：
**服务分组状态页** ：<https://status.ikuncode.cc/> **服务分组状态页**：<https://status.oneinai.cc/>
* * * ---
## 一、Claude Code 启动时跳登录 ## 一、Claude Code 启动时反复跳登录
### 问题描述 ### 问题描述
启动 Claude Code 时，反复弹出登录界面。 启动 Claude Code 时，反复弹出登录界面，无法进入正常使用状态。
### 解决方案 ### 解决方案
@ -28,56 +28,41 @@
参考教程：<https://www.cnblogs.com/gordonMlxg/articles/19103691> 参考教程：<https://www.cnblogs.com/gordonMlxg/articles/19103691>
* * * ---
## 四、API Connect Error 排查 ## 二、API Connect Error 排查
### 排查方向 ### 排查方向
1. **本地网络异常** 1. **本地网络异常**
- 检查网络连接是否正常
- 尝试访问其他网站验证网络可达性
* 检查网络连接是否正常
* 尝试访问其他网站验证网络
2. **代理 / 梯子不稳定** 2. **代理 / 梯子不稳定**
- 检查代理配置是否正确
* 检查代理配置 - 尝试切换代理节点
* 尝试切换代理节点
### 建议 ### 建议
👉 **尝试直接使用直连网络** **优先尝试直连网络**：关闭代理后测试是否恢复正常。若直连可用，说明问题出在代理链路上。
关闭代理后测试是否恢复正常。 ---
* * * ## 三、上下文过大导致异常
## 八、CC 上下文过大导致异常
### 问题表现 ### 问题表现
对话中出现异常错误，通常与上下文过大有关。 对话中出现异常错误，通常表现为响应失败或返回乱码，多与上下文过大有关。
### 解决方案 ### 解决方案
1. **新建会话** 1. **新建会话**：开启新的对话，清空上下文。
2. **查看 Token 分布**：执行 `/context` 命令查看当前上下文的 Token 使用情况。
3. **关闭自动压缩**：关闭 Auto Compress 功能，手动控制上下文大小。
* 开启新的对话，清空上下文 ---
2. **查看 Token 分布**
/context ## 四、Request Timed Out（请求超时）
1
查看当前上下文的 Token 使用情况
3. **关闭自动压缩**
* 关闭 Auto Compress（自动压缩）功能
* 手动控制上下文大小
* * *
## 九、Request Timed Out（请求超时）
### 可能原因 ### 可能原因
@ -87,29 +72,29 @@
### 解决方案 ### 解决方案
* 检查本地网络连接 - 检查本地网络连接
* 检查代理或梯子状态 - 检查代理或梯子状态
* 必要时尝试直连网络 - 必要时切换至直连网络
* 查看[服务状态页](<https://status.ikuncode.cc/status/api>)确认服务可用性 - 查看 [oneinai 服务状态页](<https://status.oneinai.cc/status/api>) 确认服务可用性
* * * ---
## 十、API Error 503 ## 五、API Error 503
### 错误说明 ### 错误说明
当前分组服务不可用。 当前 oneinai 分组服务暂时不可用。
### 解决方案 ### 解决方案
1. 切换至其他可用服务分组 1. 切换至其他可用的服务分组
2. 通过状态页确认分组状态 2. 通过状态页确认分组的实时状态
**服务状态查看** ：<https://status.ikuncode.cc/status/api> **服务状态查看**：<https://status.oneinai.cc/status/api>
* * * ---
## 十一、Gemini CLI 报错 400 ## 六、Gemini CLI 报错 400
### 问题说明 ### 问题说明
@ -119,28 +104,25 @@
直接重开会话即可解决。 直接重开会话即可解决。
* * * ---
## 十二、Claude Code 2.0.73 版本内容割裂 ## 七、Claude Code 2.0.73 版本内容割裂
### 问题说明 ### 问题说明
在 2.0.73 版本中出现对话/内容割裂问题。 在 2.0.73 版本中出现对话 / 内容割裂的问题。
### 解决方案：回退版本 ### 解决方案：回退版本
bash ```bash
npm install -g @anthropic-ai/claude-code@2.0.72 npm install -g @anthropic-ai/claude-code@2.0.72
```
1 回退到稳定的 2.0.72 版本即可恢复。
回退到稳定的 2.0.72 版本。 ---
* * * ## 八、关闭 Claude Code 自动更新
## 十三、如何关闭 Claude Code 自动更新
### 问题描述 ### 问题描述
@ -150,100 +132,75 @@ bash
在 `settings.json` 中添加以下环境变量： 在 `settings.json` 中添加以下环境变量：
json ```json
{ {
"env": { "env": {
"DISABLE_AUTOUPDATER": "1" "DISABLE_AUTOUPDATER": "1"
} }
} }
```
1
2
3
4
5
或在系统环境变量中设置： 或在系统环境变量中设置：
bash ```bash
# macOS / Linux # macOS / Linux
export DISABLE_AUTOUPDATER=1 export DISABLE_AUTOUPDATER=1
```
```powershell
# Windows PowerShell # Windows PowerShell
$Env:DISABLE_AUTOUPDATER = "1" $Env:DISABLE_AUTOUPDATER = "1"
```
1 ---
2
3
4
5
* * * ## 排查技巧总结
## 🔧 排查技巧总结
### 快速诊断流程 ### 快速诊断流程
1. ✅ 查看[服务状态页](<https://status.ikuncode.cc/status/api>) 1. 查看 [oneinai 服务状态页](<https://status.oneinai.cc/status/api>)
2. ✅ 检查环境变量配置 2. 检查环境变量配置
3. ✅ 验证令牌是否有效 3. 验证令牌是否有效
4. ✅ 检查网络和代理状态 4. 检查网络和代理状态
5. ✅ 查看 Token 余额 5. 查看 Token 余额
6. ✅ 尝试重新开启会话 6. 尝试重新开启会话
### 常用调试命令 ### 常用调试命令
#### Claude Code #### Claude Code
bash ```bash
/status # 查看当前会话状态 /status # 查看当前会话状态
/context # 查看上下文 Token 使用 /context # 查看上下文 Token 使用
/clear # 清空当前会话 /clear # 清空当前会话
```
1
2
3
### 环境变量检查 ### 环境变量检查
#### Windows #### Windows
powershell ```powershell
# 查看所有 ANTHROPIC 相关变量 # 查看所有 ANTHROPIC 相关变量
Get-ChildItem Env: | Where-Object { $_.Name -like "*ANTHROPIC*" } Get-ChildItem Env: | Where-Object { $_.Name -like "*ANTHROPIC*" }
```
1
2
#### macOS / Linux #### macOS / Linux
bash ```bash
# 查看所有 ANTHROPIC 相关变量 # 查看所有 ANTHROPIC 相关变量
env | grep ANTHROPIC env | grep ANTHROPIC
```
1 ---
2
* * * ## 获取帮助
## 📮 获取帮助
如果以上方法都无法解决您的问题，请： 如果以上方法都无法解决您的问题，请：
* 📧 查看[售前售后](</support/after-sales>)联系客服 - 查看 [售前售后](</support/after-sales>) 联系 oneinai 客服
* 💬 加入 Telegram 群组：<https://t.me/ikuncode> - 加入 Telegram 群组：<https://t.me/oneinai>
* 📖 查看[常见问题 FAQ](</support/faq>) - 查看 [常见问题 FAQ](</support/faq>)
* * * ---
_本文档持续更新中，如有新的疑难杂症欢迎反馈..._ _本文档持续更新中，如有新的疑难杂症欢迎反馈。_