Codex CLI是OpenAI开发的本地终端编码助手，可以在终端中运行，读取、修改和执行本地代码。

Codex CLI 基础使用

工具特点

• 本地运行：在本地终端中运行的编码代理
• 开源项目：基于Rust构建，速度快效率高
• 代码操作：支持读取、修改和运行本地代码
• 交互式界面：提供友好的终端交互体验

安装方式

npm安装

# 全局安装Codex CLI
npm i -g @openai/codex

# 启动Codex CLI
codex

Homebrew安装

# 使用Homebrew安装
brew install codex

# 启动Codex CLI
codex

系统要求

# 支持平台
- macOS
- Linux
- Windows (实验性支持，推荐使用WSL)

# 账户要求
需要ChatGPT Plus、Pro、Business、Edu或Enterprise计划

更新版本

# 定期更新到最新版本
npm i -g @openai/codex@latest

核心功能

• 交互式编码：在终端中描述任务并执行
• 模型控制：选择模型和推理强度
• 图像输入：支持图像输入处理
• 本地代码审查：审查代码变更和发现问题
• 网络搜索：集成网络搜索功能
• 脚本自动化：支持脚本和自动化任务
• MCP支持：Model Context Protocol集成

命令使用指南

交互式命令

# 启动Codex CLI交互界面
codex

# 在特定目录启动
codex /path/to/project

# 常用交互命令
/init     # 创建AGENTS.md文件，包含Codex使用说明
/status   # 显示当前会话配置
/approvals # 选择Codex可以无需批准执行的操作
/model    # 选择模型和推理强度
/review   # 审查代码变更和发现问题

配置管理

# 模型选择
/model gpt-4o-mini

# 设置推理强度
/model --reasoning-effort high

# 配置批准模式
/approvals auto  # 自动批准所有操作
/approvals ask   # 询问每个操作
/approvals none  # 不批准任何操作

cc-switch 配置管理工具

cc-switch是跨平台桌面应用，用于管理Claude Code和Codex的提供商配置及MCP服务器。

Codex CLI配置管理

• API密钥管理：安全存储和管理OpenAI API密钥
• 模型选择：支持不同Codex模型版本
• 参数调优：温度、最大token数等参数配置
• 成本控制：使用量统计和成本监控

安装方法

Windows

# 下载MSI安装包或便携版zip
# 从Releases页面下载最新版本

macOS

# Homebrew安装
brew tap farion1231/ccswitch
brew install --cask cc-switch

Linux

# 下载DEB包或AppImage
# 从Releases页面下载对应版本

搭配使用指南

Codex CLI配置流程

1. 安装Codex CLI

   使用npm或Homebrew安装Codex CLI

2. 登录账户

   启动Codex CLI并登录OpenAI账户

3. 配置项目

   在项目目录中运行 /init 创建配置

4. 设置批准模式

   使用 /approvals 命令配置操作权限

5. 开始编码

   描述任务，让Codex CLI协助编码

cc-switch集成配置

# 配置Codex CLI集成
- 名称：Codex-CLI
- 类型：终端工具
- 命令：codex
- 工作目录：项目路径

# 启用Codex CLI服务
在cc-switch界面启用Codex CLI集成

国内访问解决方案

方案1：使用代理工具

Clash

# 配置系统代理
set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890

# 使用Codex API

V2Ray

# 配置环境变量
export ALL_PROXY=socks5://127.0.0.1:1080
# 调用Codex API

方案2：使用中转服务

注意：部分第三方服务提供OpenAI API中转

方案3：移动网络

• 部分移动网络可直接访问OpenAI
• 尝试切换不同运营商网络

方案4：cc-switch代理配置

在cc-switch中配置代理设置，自动应用到Codex API调用。

方案5：云服务器部署

1. 购买海外云服务器

   推荐：AWS、Google Cloud、Vultr

2. 部署API代理

   在服务器上部署反向代理服务

3. 配置cc-switch

   将API端点指向代理服务器

实用技巧

代码操作示例

# 在Codex CLI中描述任务
"创建一个Python函数来计算斐波那契数列"

# 生成的代码示例
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

文件操作

# 读取文件内容
"请读取src/main.py文件并解释其功能"

# 修改代码
"在utils.py中添加一个日志记录函数"

# 创建新文件
"创建一个React组件文件，包含状态管理和事件处理"

项目维护

# 依赖管理
"检查package.json中的依赖是否需要更新"

# 代码审查
"使用/review命令检查最近的代码变更"

# 测试运行
"运行项目的测试套件并报告结果"

常见问题

Q: Codex CLI安装失败

A: 检查Node.js版本，确保有ChatGPT Plus以上账户权限

Q: 命令无法执行

A: 使用 /approvals 命令配置操作权限，或手动批准操作

Q: 网络连接问题

A: 检查代理设置，确保能访问OpenAI API

Q: 模型响应慢

A: 使用 /model 命令选择更快的模型，或降低推理强度

Q: 文件权限错误

A: 确保Codex CLI对项目目录有读写权限

最佳实践

交互使用技巧

• 明确描述：清晰描述需要完成的任务
• 分步操作：复杂任务分解为多个小步骤
• 上下文提供：确保Codex了解项目结构和需求
• 审查变更：使用 /review 命令检查所有代码变更

配置优化

• 模型选择：根据任务复杂度选择合适的模型
• 批准模式：根据信任度配置适当的批准级别
• 项目初始化：在新项目中使用 /init 创建配置

安全考虑

• 代码审查：始终审查Codex生成的代码
• 权限控制：谨慎配置 /approvals 设置
• 备份重要文件：在重大修改前备份关键文件

总结

Codex CLI作为本地终端编码助手，为开发者提供了强大的AI编程支持。通过交互式命令和智能代码操作，能够显著提升开发效率。结合cc-switch工具可以更好地管理配置和集成，让Codex CLI的使用更加便捷高效。

贡献者: paiad