必须先完成安装和基础配置，否则启动后会卡在登录页或提示“网络不可达”；需下载适配芯片的.dmg安装包、拖入应用程序、授权辅助功能/文件/网络权限，并通过chatgpt账号登录（需付费）或配置第三方api key（如火山引擎），最后验证状态栏显示“connected”即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在Mac上用Codex写代码、调试项目或当智能助手，必须先完成安装和基础配置，否则启动后会卡在登录页或提示“网络不可达”。
下载适配你芯片的Codex安装包
打开浏览器，访问 Codex官方下载页。点击「Mac」选项卡，根据你Mac的芯片类型选择版本：【Apple Silicon（M1/M2/M3/M4）选.dmg文件；Intel处理器选x64版】。不确定芯片型号？点屏幕左上角「苹果菜单 → 关于本机」，看“芯片”一栏写的是什么。
下载完成后，文件名类似 Codex-26.611.62324-macOS-arm64.dmg（Apple Silicon）或 Codex-26.611.62324-macOS-x64.dmg（Intel）。
安装并授权系统权限
双击下载好的.dmg文件，窗口中会出现一个Codex图标和右侧「应用程序」文件夹图标。把Codex图标拖进「应用程序」文件夹，等待拷贝完成。
打开「启动台」，点击Codex图标启动。首次运行时，系统会弹出安全警告——这是正常现象，不是软件损坏。点击「仍要打开」，随后按提示依次授予三项权限：【辅助功能、文件访问、网络访问】。缺任何一项，Codex都无法读取你的代码文件或调用模型。
输入你的Mac登录密码确认授权。这一步跳过会导致后续所有操作失败。
两种方式完成账号或API接入
方法一：用ChatGPT账号直接登录
启动Codex后，界面会引导你用OpenAI账号登录。已有ChatGPT账户的用户可直接输入邮箱和密码，登录后左下角会显示当前额度。注意：免费账户无法使用Codex，必须是付费订阅用户。
方法二：配置第三方API Key（国内常用）
若无法直连OpenAI，需提前准备国产平台API Key（如火山引擎Coding Plan、DeepSeek开放平台）。打开终端，执行：mkdir -p ~/.codex && nano ~/.codex/config.toml
粘贴以下内容并保存（Ctrl+O → 回车 → Ctrl+X）：
model_provider = "volc"<br>preferred_auth_method = "apikey"<br>[model_providers.volc]<br>base_url = "https://api.volcengine.com/api/v1"<br>api_key = "sk-xxxxxxxxxx"
【务必把sk-xxxxxxxxxx替换成你的真实API Key，且分组必须设为codex】
验证是否安装成功
第一步：关闭并重新打开Codex应用。
第二步：在主界面输入“Hello”，按下回车。
第三步：观察右下角状态栏——若出现绿色“Connected”字样，且下方返回文字响应，说明安装与配置全部完成。
若显示“Network error”或长时间无响应，请检查CC Switch是否已开启路由、config.toml中base_url末尾是否有斜杠、API Key是否复制完整。
