让每一个 AI 新手
不再卡在环境部署上
全部内容基于真实踩坑整理：报错原文 → 原因分析 → 分步解决 → 效果验证。 与其照着「正确教程」反复失败，不如直接搜到你的报错和答案。
六大专栏
本地模型部署、量化、GPU 加速、API 调用踩坑合集
共 1 篇排错教程 →Claude Code、API 调用、403/限流/区域限制排错
共 2 篇排错教程 →CCSwitch 配置、接入、鉴权与计费问题
共 2 篇排错教程 →安装、虚拟环境、pip、依赖冲突与版本管理
共 3 篇排错教程 →Vue3 + Vite 工程、组件封装、前后端联调排错
共 2 篇排错教程 →MCP 协议、Server 搭建、Claude/本地模型接入
共 2 篇排错教程 →FFmpeg、开发平台、各类环境工具的零散踩坑
共 2 篇排错教程 →最新排错文章
在 CCSwitch 里新增自定义服务商时保存失败、部分输入框填不进去？多半是原生 Claude 协议和 OpenAI 兼容协议混用了，统一格式即可。
同一个 CCSwitch 里 GPT 模型正常，ClaudeCode/Codex 却调不了。原因是 Codex 原生适配 OpenAI 协议、Claude 需单独适配中转协议。
直连 Anthropic 原生接口国内网络 403 无法访问，改用中转后 ClaudeCode 又报 403 服务商未开通模型权限。两个 403 两种解法。
VSCode 里配置好的 MCP 工具，其他 AI 客户端没法复用。手动把 MCP 配置 JSON 复制到对应客户端配置目录，并补上 Node.js 运行依赖。
在 VSCode 里手动填第三方 MCP 插件仓库地址，市场解析失败、拉取 404。原因是地址带了多余的 file:// 本地协议前缀，删掉即可。
找不到低代码平台的原生接口文档，直接在 Vue 里写请求代码渲染饼图、数据卡片，结果语法报错、数据为空。改用平台内置数据集统计函数就通了。
报表饼图预览异常、统计结果为 0、过滤条件语法报错。根因是过滤表达式缺引号、字段名不匹配，核对数据库原始字段值格式即可。
短时间请求量触达服务商限流，返回 429。按「停等冷却 → 换备用密钥 → 降并发 → 切本地模型」的顺序处理，附真实排查经验。