一、Codex CLI 是什么？

Codex CLI 是一个运行在终端里的 AI 编程助手，由 OpenAI 提供能力支持，可以：

• 自动写代码 / 改代码
• 分析项目结构
• 执行 Shell 命令
• 修复 Bug
• 生成脚本 / Dockerfile

👉 一句话总结：
终端里的 AI 程序员

二、安装前准备

✅ 系统要求

• Ubuntu 20.04+
• Node.js ≥ 18（推荐 20+）

✅ 安装 Node.js（关键）

不要用系统自带旧版本，推荐 NodeSource：

sudo apt update

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt install -y nodejs

验证：

node -v
npm -v

三、安装 Codex CLI

✅ 推荐安装方式

npm install -g @openai/codex

👉 国内环境慢的话：

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

✅ 验证安装

codex --version

四、登录 / 认证方式

✅ 方法1：浏览器登录（最简单）

codex

选择：

Sign in with ChatGPT

👉 浏览器打开后登录即可

✅ 方法2：API Key（推荐服务器）

export OPENAI_API_KEY=你的key

永久生效：

nano ~/.bashrc

加入：

export OPENAI_API_KEY=你的key

source ~/.bashrc

⚠️ 五、国内/内网必看：中转站配置

如果你遇到：

• 登录失败
• 请求超时
• 无法连接 API

👉 必须配置“中转站（代理 API）”

🧭 什么是中转站？

Codex CLI → 中转 API → OpenAI

作用：

• 提高访问成功率
• 解决网络限制
• 提升稳定性

✅ 配置方法（最重要）

临时测试：

export OPENAI_API_KEY=sk-xxxx
export OPENAI_BASE_URL=https://api.xxx.com/v1

永久配置：

nano ~/.bashrc

加入：

export OPENAI_API_KEY=sk-xxxx
export OPENAI_BASE_URL=https://api.xxx.com/v1

source ~/.bashrc

项目级配置（推荐团队）

nano .env

OPENAI_API_KEY=sk-xxxx
OPENAI_BASE_URL=https://api.xxx.com/v1

✅ 可选：本地代理

export HTTPS_PROXY=http://127.0.0.1:7890

✅ Azure 用户（特殊情况）

如果你使用 Microsoft Azure OpenAI：

export OPENAI_API_KEY=你的key
export OPENAI_BASE_URL=https://xxx.openai.azure.com/

六、第一次运行

codex

试试：

帮我写一个 Python HTTP 服务器

七、核心使用方式（重点）

🧩 1. 分析项目

codex

输入：

分析这个项目做什么

✏️ 2. 修改代码

帮我把这个函数改成异步

⚙️ 3. 自动执行命令

安装依赖并运行项目

🐞 4. 修复问题

这个报错怎么解决？

📦 5. 生成文件

帮我写一个 Dockerfile

八、常用命令

九、实战案例（完整流程）

🚀 示例：创建一个 Node 项目

mkdir demo && cd demo
codex

输入：

帮我创建一个 Express 项目并启动

👉 Codex 会自动：

1. 初始化项目
2. 安装依赖
3. 写代码
4. 启动服务

十、常见问题（踩坑总结）

❌ command not found

export PATH=$PATH:$(npm config get prefix)/bin

❌ Node 版本过低

👉 升级 Node

❌ 登录失败

👉 改用 API Key + 中转站

❌ 401 / 404 错误

• Key 错误
• 中转不支持模型

❌ 卡住 / 超时

export HTTPS_PROXY=http://127.0.0.1:7890

❌ 登录冲突

codex logout

十一、进阶玩法（高手必看）

✅ 长期驻场（当同事用）

codex

✅ Git 辅助

帮我写 commit message

✅ 自动化脚本

写一个自动备份脚本

✅ 运维场景

分析服务器日志

✅ 多中转切换

nano switch_api.sh

#!/bin/bash
export OPENAI_API_KEY=$1
export OPENAI_BASE_URL=$2

source switch_api.sh sk-xxx https://api.xxx.com/v1

十二、安全建议（重要）

• ❌ 不要提交 .env
• ✅ 加入 .gitignore
• ✅ 使用限额 Key
• ✅ 定期更换 Key

🎯 最终总结

👉 完整流程其实只有三步：

1. 安装 Node
2. 安装 Codex CLI
3. 配置 Key（必要时加中转）

🚀 一句话理解

👉

终端 + Codex CLI + 中转（可选） = 自动化编程助手

如果你想再进阶，我可以继续帮你整理一版：

• 👉 Codex CLI + Docker + CI/CD 自动开发流
• 👉 企业内网私有网关部署方案
• 👉 或“替代 Cursor 的终端流开发体系”

这些才是真正生产级玩法。