让每一个 AI 新手
不再卡在环境部署上
全部内容基于真实踩坑整理：报错原文 → 原因分析 → 分步解决 → 效果验证。 与其照着「正确教程」反复失败，不如直接搜到你的报错和答案。
六大专栏
本地模型部署、量化、GPU 加速、API 调用踩坑合集
共 1 篇排错教程 →Claude Code、API 调用、403/限流/区域限制排错
共 3 篇排错教程 →CCSwitch 配置、接入、鉴权与计费问题
共 4 篇排错教程 →安装、虚拟环境、pip、依赖冲突与版本管理
共 3 篇排错教程 →Vue3 + Vite 工程、组件封装、前后端联调排错
共 2 篇排错教程 →MCP 协议、Server 搭建、Claude/本地模型接入
共 2 篇排错教程 →FFmpeg、开发平台、各类环境工具的零散踩坑
共 4 篇排错教程 →最新排错文章
Codex 用 CC Switch 连 Kimi 返回 401 Unauthorized。根因是 Codex 走 Responses API、Kimi 只支持 Chat Completions，协议不兼容导致代理转换失败。
Codex / ChatGPT 请求超时，查下来是 CC Switch 的本地代理 127.0.0.1:4000 没跑起来。进程启动即退出、crash.log 有崩溃记录，三步排查。
Claude Code 报 Unable to connect to API，直连 Anthropic 不通，改用 DeepSeek 兼容端点后又遇到端点失效。从直连失败到切换 /v1 的完整排错。
想让 Codex 用上阿里云百炼 Qwen，npm 包名写错、config.toml 缺 provider 区块、base_url 404、缓存残留不生效，四个坑一次讲清全部解法。
Codex 本地装好后遇到认证凭据读不出来、npm install -g 提示会更新另一个安装、临时目录堆积清理失败三个问题，逐一排查。
在 CCSwitch 里新增自定义服务商时保存失败、部分输入框填不进去？多半是原生 Claude 协议和 OpenAI 兼容协议混用了，统一格式即可。
同一个 CCSwitch 里 GPT 模型正常，ClaudeCode/Codex 却调不了。原因是 Codex 原生适配 OpenAI 协议、Claude 需单独适配中转协议。
直连 Anthropic 原生接口国内网络 403 无法访问，改用中转后 ClaudeCode 又报 403 服务商未开通模型权限。两个 403 两种解法。