codex安装教程
OpenAI Codex 是 OpenAI 推出的 AI 编程助手，支持桌面端和命令行（CLI）两种使用方式。以下是详细的安装与配置教程。
桌面端安装（适合新手与日常使用）
桌面端操作最直观，适合不想折腾命令行的用户。
访问官网：打开 OpenAI Codex 官网，页面会自动识别你的系统。
下载安装包：点击对应的 Download for Mac 或 Download for Windows 按钮。
执行安装：
macOS：下载
.dmg文件后双击挂载，将 Codex 图标拖入「应用程序」文件夹即可。首次打开若提示无法验证开发者，请进入「系统设置 → 隐私与安全性」点击「仍要打开」。Windows：下载
.exe或.msix安装包，双击运行并按向导提示完成安装。登录账号：打开应用，使用你的 ChatGPT / OpenAI 账号扫码或输入密码登录（通常需要 Plus 或 Pro 订阅才能使用完整功能）。
命令行端安装（适合开发者与自动化）
如果你习惯在终端工作，或者想将 Codex 接入其他工具，可以使用 CLI 版本。
准备环境：确保电脑已安装 Node.js（版本 18 或更高，推荐 22+）和 npm。
全局安装：在终端或 PowerShell 中执行以下命令：
标准安装：
npm install -g @openai/codex国内加速：如果 npm 下载慢，可以加上镜像源：
npm install -g @openai/codex --registry=https://registry.npmmirror.comMac 用户备选：如果你使用了 Homebrew，也可以直接运行
brew install --cask codex。验证安装：安装完成后，输入
codex --version，如果终端返回了版本号，说明安装成功。登录使用：在终端输入
codex，浏览器会自动弹出授权页面，完成登录后即可在命令行中使用。
配置 API Key 与接入国产模型
如果你没有 ChatGPT 订阅，或者想接入 DeepSeek、Kimi 等国产模型，可以通过配置 API Key 来实现。
获取 API Key：登录对应的模型开放平台（如 DeepSeek 开放平台），在后台创建并复制你的 API Key。
配置环境变量：在终端中执行命令将 Key 加入环境变量（以 macOS/Linux 为例）：
export OPENAI_API_KEY="你的 sk- 开头的密钥"（Windows PowerShell 用户可使用：$env:OPENAI_API_KEY="你的 sk- 开头的密钥"）配置模型参数：你可以创建或编辑
~/.codex/config.toml配置文件，将模型名称修改为你想要的模型（例如model = "deepseek-chat"）。使用本地路由工具：由于 Codex 默认走 OpenAI 的接口格式，而国产模型格式不同，很多开发者会搭配 CCSwitch 或类似的本地路由工具进行协议翻译。在路由工具中添加供应商和 API Key，开启本地路由后，Codex 就能正常调用国产模型了。
常见问题与避坑指南
网络限制：官方服务对地区有限制，国内直连经常不稳定或无法登录。如果无法访问，请检查网络环境，或者改用上述的“接入国产模型”方案。
权限模式设置：首次进入桌面端时，务必将权限模式设置为「自动审查」。这样 Codex 在执行危险操作（如删除文件、运行复杂命令）前会询问你，防止误删项目代码。
API Key 安全：API Key 相当于你的账号密码和钱包，千万不要截图发给别人或上传到公开的代码仓库。如果不小心泄露，请立即去后台作废并重新生成。
Windows 环境变量报错：如果 Windows 版打开提示
Unable to locate the Codex CLI binary，可以通过 PowerShell 设置环境变量CODEX_CLI_PATH，指向你电脑上codex.exe的实际安装路径。
