避坑指南：解决Codex本地API 502报错，CPA与Clash代理冲突全解析

本文详细记录了在 macOS (Apple Silicon) 环境下配置 CLI Proxy API (CPA) 与 Codex 集成时频繁遇到的 502 Bad Gateway 错误。文章指出核心原因在于 ClashX 等系统代理工具默认拦截了 localhost 请求，导致本地服务无法连接。作者提供了通过设置 NO_PROXY 环境变量或配置代理绕过规则的有效解决方案，并深入剖析了 API Key 不匹配、端口占用及旧版本冲突等衍生问题的排查方法，是一份针对本地 AI 环境搭建的高质量实操指南。