Codex CLI 安装配置教程

2026年5月25日 · 7 分钟阅读

#AI #工具 #教程 #Codex #OpenAI

什么是 Codex CLI

Codex CLI 是 OpenAI 开源的 AI 编程助手，和 Claude Code 是竞品。同样在终端里运行，能读代码、改文件、跑命令。开源、免费、可配合 ChatGPT Plus 使用。

GitHub 85k+ stars，社区活跃。

安装过程演示

下面是完整的安装过程录制（可拖动进度条、调整速度）：

安装步骤

1. 安装 Codex CLI

# Linux / WSL / macOS（官方推荐）
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# macOS (Homebrew)
brew install --cask codex

# 或者用 npm
npm install -g @openai/codex

官方脚本会自动检测平台，下载对应二进制文件。

2. 配置中转服务（可选）

如果没有 ChatGPT Plus 订阅，可以使用第三方 API 中转服务。推荐 sbbbbbbbbb.xyz，通过下方链接注册首单享 95 折优惠：

👉 注册地址见文末（首单 95 折）

套餐推荐：

套餐	价格	每日额度	有效期
月卡	¥48.99	$150/天	30 天
周卡	¥16.88	$70/天	7 天

💡 不确定就先买周卡试试。Codex 和 Claude Code 共用同一个中转服务，一个 Key 两边都能用。

注册充值后获取 API Key，然后编辑 ~/.codex/config.toml：

model = "gpt-5.4"
model_provider = "necodex"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
disable_response_storage = true

[model_providers.necodex]
name = "NeCodeX API"
base_url = "https://fast.sbbbbbbbbb.xyz/v1"
experimental_bearer_token = "sk-你的key粘贴到这里"
wire_api = "responses"
supports_websockets = false

💡 将 experimental_bearer_token 替换为你自己的 API Key。配置后 Codex 会通过中转服务调用模型。

3. 验证安装

codex --version

看到类似 codex-cli 0.133.0 就对了。

3. 认证

两种方式：

方式一：中转服务（推荐，上面已配好）

配置文件写好后直接用，不需要额外认证。运行 codex "你好" 验证即可。

方式二：ChatGPT 账号登录

如果你有 ChatGPT Plus/Pro/Enterprise 订阅，也可以直接用官方额度：

codex

首次运行选择 “Sign in with ChatGPT”，浏览器授权即可。不需要配置中转。

基本使用

交互模式

# 进入交互式对话
codex

# 在项目目录中启动
cd my-project
codex

单次命令

# 直接提问
codex "解释这个项目的架构"

# 让它改代码
codex "给这个函数加单元测试"

# 执行任务
codex "找到所有 TODO 注释并修复"

配置

审批模式

Codex 有三种安全模式：

模式	说明	适合场景
Read Only	只读代码，不修改	代码审查、理解项目
Auto	自动执行安全操作，危险操作需确认	日常开发
Full Access	完全自主，不需确认	信任的自动化任务

启动时选择，或用参数指定：

codex --approval-mode auto

模型选择

# 交互中切换
/model

Claude Code vs Codex CLI 对比

维度	Claude Code	Codex CLI
厂商	Anthropic	OpenAI
开源	❌	✅ Apache-2.0
模型	Claude Opus/Sonnet	GPT-4o/o3
认证	API Key 或订阅	ChatGPT 账号或 API Key
审批模式	权限配置文件	三档选择
特色	深度代码理解	社区生态、插件

建议两个都装。 根据任务切换用。复杂重构用 Claude Code，快速问答用 Codex。

小贴士

在项目根目录启动效果最好
/help 查看所有斜杠命令
/model 切换模型和推理强度
支持图片输入（截图报错直接贴）
开源可以自己改，社区插件丰富