AI 排错指南
Ollama · Claude · CCSwitch · Python · MCP · Codex

让每一个 AI 新手
不再卡在环境部署上

全部内容基于真实踩坑整理：报错原文 → 原因分析 → 分步解决 → 效果验证。 与其照着「正确教程」反复失败，不如直接搜到你的报错和答案。

🔍
23
篇排错教程
持续更新中
9
大专栏
覆盖主流工具
66
个报错标签
按关键词检索
2026-08-16
最近更新
Cursor 登录/更新…

全部专栏

🦙
Ollama

本地模型部署、量化、GPU 加速、API 调用踩坑合集

共 2 篇排错教程 → ✨
Claude

Claude Code、API 调用、403/限流/区域限制排错

共 3 篇排错教程 → 🔀
CCSwitch

CCSwitch 配置、接入、鉴权与计费问题

共 4 篇排错教程 → 🐍
Python 环境

安装、虚拟环境、pip、依赖冲突与版本管理

共 4 篇排错教程 → 🔌
MCP 配置

MCP 协议、Server 搭建、Claude/本地模型接入

共 2 篇排错教程 → ⌨️
Codex

Codex CLI 安装、配置、接入国内模型与鉴权排错

共 2 篇排错教程 → 📝
Cursor

Cursor 登录、更新、网络直连与配置问题排错

共 1 篇排错教程 → 🌊
Trae

Trae 安装、更新、账号与使用问题排错

共 1 篇排错教程 → 🛠️
其他工具

Vue 低代码、FFmpeg、开发平台等零散踩坑

共 4 篇排错教程 →

热门标签

#Codex (5) #Python (3) #CCSwitch (3) #ClaudeCode (3) #代理 (2) #安装 (2) #镜像 (2) #Ollama (2) #超时 (2) #pip (2) #401 (2) #协议 (2) #端口 (2) #中转 (2) #MCP (2) #VSCode (2) #环境变量 (2) #Vue (2) #Cursor (1) #网络 (1) #登录失败 (1) #Trae (1) #下载 (1) #模型下载 (1) #镜像源 (1) #Kimi (1) #npm (1) #排错 (1) #百炼 (1) #阿里云 (1) #config.toml (1) #DeepSeek (1) #ConnectionRefused (1) #端点 (1) #OpenAI兼容 (1) #协议适配 (1) #本地模型 (1) #OpenCode (1) #同步 (1) #404 (1) #插件 (1) #FFmpeg (1) #视频处理 (1) #低代码平台 (1) #数据集 (1) #图表 (1) #Replit (1) #注册 (1) #风控 (1) #开发平台 (1) #报表 (1) #饼图 (1) #过滤表达式 (1) #Windows (1) #PATH (1) #系统命令 (1) #路径 (1) #API (1) #429 (1) #限流 (1) #并发 (1) #WinError (1) #后端 (1) #Claude (1) #Anthropic (1) #403 (1)

最新排错文章

Cursor Cursor 登录/更新一直转圈或连接失败:国内网络的三个排查点

Cursor 打开后登录按钮转圈、更新卡住、AI 面板报 network error,大概率是国内网络直连不稳定。三步定位:代理开关、DNS、hosts 缓存。

2026-08-16 · 4 分钟 · #Cursor #网络 #代理 #登录失败
Trae Trae 下载慢 / 安装包校验失败:换镜像源与官方渠道的正确姿势

Trae 官网下载慢、安装包不完整、更新卡住,大多是 CDN 节点问题。用国内镜像或官方直链下载,安装前关掉杀软并校验文件。

2026-08-14 · 3 分钟 · #Trae #安装 #下载 #镜像
Ollama ollama pull 一直超时或下载中断:设置镜像源与重试姿势

ollama pull 卡在 pulling 进度不动、报 connection error / timeout,国内直连模型仓库不稳定。配镜像源 + 断点重试即可解决。

2026-08-12 · 4 分钟 · #Ollama #模型下载 #超时 #镜像
Python 环境 pip install 超时 / ReadTimeoutError:换国内镜像源一次解决

pip 安装包时 ReadTimeoutError 或下载极慢,是默认源 PyPI 在国内不稳定。换清华/阿里镜像源,一劳永逸。

2026-08-10 · 3 分钟 · #Python #pip #超时 #镜像源
CCSwitch Codex CLI 连 Kimi 报 401：Chat Completions 和 Responses 协议不兼容

Codex 用 CC Switch 连 Kimi 返回 401 Unauthorized。根因是 Codex 走 Responses API、Kimi 只支持 Chat Completions，协议不兼容导致代理转换失败。

2026-08-03 · 4 分钟 · #Codex #Kimi #401 #协议
CCSwitch CC Switch 启动即退出：本地代理 127.0.0.1:4000 连不上

Codex / ChatGPT 请求超时，查下来是 CC Switch 的本地代理 127.0.0.1:4000 没跑起来。进程启动即退出、crash.log 有崩溃记录，三步排查。

2026-08-03 · 4 分钟 · #CCSwitch #Codex #代理 #端口
Codex Codex CLI 排错：auth 凭据、npm 路径冲突、临时目录堆积

Codex 本地装好后遇到认证凭据读不出来、npm install -g 提示会更新另一个安装、临时目录堆积清理失败三个问题，逐一排查。

2026-08-03 · 5 分钟 · #Codex #npm #排错
Codex Codex CLI 接入阿里云百炼 Qwen：安装包名、config、base_url、缓存 4 个坑

想让 Codex 用上阿里云百炼 Qwen，npm 包名写错、config.toml 缺 provider 区块、base_url 404、缓存残留不生效，四个坑一次讲清全部解法。

2026-08-03 · 8 分钟 · #Codex #百炼 #阿里云 #config.toml