Mac 安装 OpenAI Codex CLI 完整教程

从零开始，5 分钟在你的 Mac 上跑起 AI 编程助手

2026 年 6 月最新版

🤔 什么是 Codex CLI？

Codex CLI 是 OpenAI 推出的开源命令行 AI 编程代理。它可以直接在你的终端中运行，读取、修改代码，甚至执行命令。

你可以像聊天一样用自然语言告诉它想做的事情，它会自动完成代码编写、调试、部署等操作。

亮点：使用 Rust 构建，高性能；完全开源；支持语音输入；内置多代理协作；可扩展 Skills 技能库。

1环境准备

最低要求

依赖	最低版本	推荐版本
macOS	12+ (Monterey)	14+ (Sonoma)
Node.js	18.0+	22.0+
npm	10.0+	最新版
Git	2.23+	2.40+
内存	4GB	8GB+

检查当前环境

复制$ node --version
v22.12.0
$ npm --version
10.9.0
$ git --version
git version 2.43.0

如果没有 Node.js，先安装

推荐方式：去 nodejs.org 下载 macOS 安装包（选择 LTS 版本），双击安装即可。

备选方式：也可以用 Homebrew 安装：brew install node@22

2安装 Codex CLI

macOS 有两种安装方式，任选其一即可：

方式一：npm（推荐）

方式二：Homebrew

适用平台：macOS / Linux / Windows 全平台通用

复制npm install -g @openai/codex

国内用户加速：如果 npm 下载慢，使用淘宝镜像：

复制npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证安装

复制$ codex --version
codex 0.130.0

看到版本号，说明安装成功 ✅

3配置 API Key / 登录

首次运行 Codex 时，终端会提示你选择登录方式：

复制$ codex

Welcome to Codex!
Choose authentication method:
1. Sign in with ChatGPT (推荐)
2. Use API Key

方式 A：ChatGPT 账号登录（推荐，Plus/Team 用户首选）

输入 1 并回车，浏览器会自动弹出 OpenAI 授权页面，完成登录即可。Plus/Pro 用户享有更高的使用额度。

方式 B：API Key 手动配置

前往 OpenAI Platform 创建 API Key，然后执行：

复制# 临时使用（仅当前终端会话有效）
$exportOPENAI_API_KEY="sk-proj-你的-api-key"
$ codex

想要永久生效？将上述 export 命令加到 ~/.zshrc 文件末尾：

复制# 编辑 ~/.zshrc，在末尾添加：
exportOPENAI_API_KEY="sk-proj-你的-api-key"

# 保存后执行：
$ source ~/.zshrc

4国内用户：使用第三方 API 中转

如果你没有 OpenAI 账号或者 API 访问受限，可以配置国内的 API 中转平台。

Codex 配置文件位于 ~/.codex/config.toml，如果不存在就手动创建：

复制# ~/.codex/config.toml

# 以七牛云 AI 中转为例
openai_base_url = "https://api.qnaigc.com/v1"
model = "deepseek-chat"

# 以硅基流动为例
# openai_base_url = "https://api.siliconflow.cn/v1"
# model = "deepseek-ai/DeepSeek-V3"

服务商	Base URL
七牛云 AI	`https://api.qnaigc.com/v1`
硅基流动	`https://api.siliconflow.cn/v1`
阿里百炼	`https://dashscope.aliyuncs.com/compatible-mode/v1`
DeepSeek 官方	`https://api.deepseek.com/v1`

注意：部分中转平台可能只支持 Chat Completions API，而 Codex 新版使用 Responses API。如果遇到报错，需要多试几家平台，或直接使用 OpenAI 官方 API。

5基本使用指南

启动 Codex

复制# 在任意项目目录中启动
$cd ~/my-project
$ codex

启动后会进入 TUI（终端用户界面），你可以直接用自然语言和它对话。

常用快捷键 & 斜杠命令

命令 / 快捷键	功能
`/plugins`	打开插件管理
`/theme`	切换界面主题
`/copy`	复制最新回复到剪贴板
`/clear` 或 `Ctrl + L`	清屏（保留对话历史）
按住空格键	语音输入（录音转文字）
`$技能名`	调用 Skills 技能库

使用示例

复制# 让 Codex 帮你做事情：
你 > 帮我创建一个 React 项目，配置好 Tailwind CSS
你 > 这段代码有什么 bug？帮我修复
你 > 把当前项目部署到 CloudStudio

小贴士：输入 $ 符号可以呼出 Skills 列表，如 $Deploy to Cloud、$Figma-to-Code 等，让 AI 调用专门的技能模块处理特定任务。

6可选：安装 macOS 桌面应用

如果你更喜欢可视化的图形界面，可以安装 Codex 桌面版。它提供多代理并行管理、可视化操作面板等功能。

前往 openai.com/codex 下载 .dmg 安装包
双击 .dmg 文件，将 Codex 拖入 Applications 文件夹
首次打开时，按引导完成 OpenAI 账号登录

CLI vs 桌面应用：CLI 轻量高效适合日常开发，桌面应用适合需要同时管理多个代理会话的进阶用户。两者可以共存。

教程更新时间：2026 年 6 月 6 日 · 适用于 Codex CLI v0.130+