mac安装codex desktop后需先清除旧配置（rm -rf ~/.codex）、新建auth.json和config.toml，再按平台规范填写api key与base_url（如letaicode需含/codex路径），最后重启验证状态灯变绿即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Mac 上安装 Codex Desktop 后，多数人卡在第三方 API 配置环节：auth.json 里混入旧字段、config.toml 路径放错位置、model_provider 名称拼写错误，或 base_url 少了 /v1 后缀导致 404 报错。这些问题不解决，Codex 就无法调用模型。
确认基础环境与清理旧配置
打开终端，先检查系统版本是否 ≥ macOS 12：sw_vers -productVersion。再执行以下命令彻底清除历史残留：
rm -rf ~/.codex
这一步必须做。旧的 【auth.json 或 config.toml 若未清空，会优先读取错误配置，导致后续所有填写都失效】。删完后重新建目录：mkdir -p ~/.codex && touch ~/.codex/auth.json ~/.codex/config.toml。
获取并填入第三方 API Key
以 LetAiCode 平台为例（其他平台同理）：
① 访问 https://www.php.cn/link/5a370ab3360fc98865faf5190a306499 → 登录 → 进入「接口密钥」页面 → 点击「创建新密钥」；
② 密钥类型必须选择 codex 分组，否则即使 Key 正确也会返回 401；
③ 创建后立即复制 sk-xxx 格式的密钥，它只显示一次；
④ 编辑 auth.json：vi ~/.codex/auth.json → 按 i 进入编辑 → 粘贴 {"OPENAI_API_KEY": "sk-xxx"} → ESC → :wq 回车保存；
⚠️ 注意：auth.json 文件里只能有且仅有这一行 JSON 内容，多一个空格、少一个引号、或多一行注释都会触发认证失败。
配置 config.toml 指向第三方服务
方法一：适配 LetAiCode（推荐新手）
执行 vi ~/.codex/config.toml，粘贴以下内容（已适配 2026 年最新接口）：
model_provider = "letaicode"model = "gpt-5.5"disable_response_storage = truepreferred_auth_method = "apikey"[model_providers.letaicode]name = "letaicode"base_url = "https://www.php.cn/link/5a370ab3360fc98865faf5190a306499/codex"wire_api = "responses"requires_openai_auth = false
方法二：对接 DeepSeek（需自行注册）
base_url 改为 https://api.deepseek.com/v1，model_provider 改为 deepseek，并在 [model_providers.deepseek] 下补全 name 和 requires_openai_auth = true；
方法三：用 CCSwitch 统一管理（适合多模型切换）
先下载 CCSwitch（夸克网盘链接：https://pan.quark.cn/s/1345770b19d5），启动后添加 OpenAI 兼容接口，Base URL 填第三方地址（如 https://api.aisz.mom/v1），API Key 填你刚复制的 sk-xxx；再把 config.toml 中的 base_url 指向本地 CCSwitch 地址：http://localhost:3000/v1。
验证配置是否生效
关闭所有 Codex Desktop 进程，重新打开应用；
点击左上角 File → Settings → Model Provider，确认下拉菜单中显示「letaicode」或你填写的 provider 名；
新建对话，输入「测试」并发送，右上角状态灯变绿且返回合理响应，即表示配置完成。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
