必须完成安装、配置、验证三步闭环才能运行codex cli：安装需node.js≥22并全局安装@openai/codex；配置需替换为国内api端点（如ace data cloud或七牛云ai）；验证需重启终端后运行codex --version并首次执行/init生成agents.md。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在本地终端里让 Codex CLI 真正跑起来、读代码、改文件、执行命令，必须完成安装、配置、验证三步闭环。只装不配会报 401，只配不验会卡在空白 TUI 界面，漏掉任何一环都进不了项目。
安装 Codex CLI
第一步：确认 Node.js 版本不低于 22，执行 node -v 和 npm -v，输出版本号低于 22.0.0 就要重装 LTS 版本。
第二步：全局安装命令（推荐）：npm install -g @openai/codex@latest。这条命令会把可执行文件放到 npm 全局 bin 目录，不是当前项目 node_modules 下。
第三步：关闭所有终端窗口，重新打开一个新的终端——【这是关键动作，旧终端不会自动加载新 PATH】，再运行 codex --version。如果返回类似 codex 0.131.0 的版本号，说明二进制已就位。
配置国内可用的 API 后端
默认情况下 Codex CLI 会直连 https://api.openai.com/v1，国内无法访问。必须手动切换为国内兼容端点，否则首次启动必报错 Failed to connect to api.openai.com。
方法一：使用 Ace Data Cloud（需提前在控制台申请 API Token）
① 把 Token 写入 shell 配置文件：echo 'export ACEDATACLOUD_API_KEY="sk-xxx"' >> ~/.zshrc（macOS）或 ~/.bashrc（Linux/WSL），然后执行 source ~/.zshrc。
② 创建配置目录：mkdir -p ~/.codex。
③ 编辑 ~/.codex/config.toml，填入以下内容：
model_provider = "acedatacloud"<br>model = "gpt-5"<br>[model_providers.acedatacloud]<br>name = "Ace Data Cloud"<br>base_url = "https://api.acedata.cloud/v1"<br>env_key = "ACEDATACLOUD_API_KEY"<br>wire_api = "responses"
方法二：使用七牛云 AI（无需注册，开箱即用）
直接创建 ~/.codex/config.toml，写入：
openai_base_url = "https://api.qnaigc.com/v1"<br>model = "deepseek-v4-pro"<br>sandbox_mode = "workspace-write"<br>web_search = "disabled"
【注意：不要同时写 openai_base_url 和 model_provider，二者互斥】
首次启动并加载项目
进入你要操作的代码目录，例如：cd ~/my-project。
运行 codex 命令，Codex CLI 会自动进入 TUI 界面——这不是黑屏，而是带对话区、输入框和状态栏的全屏终端界面。
第一次进入时，光标停在输入框，直接输入斜杠命令 /init → 回车。
这一步会扫描整个项目结构，读取 package.json、requirements.txt、Cargo.toml 等元信息，并自动生成 AGENTS.md 文件，里面包含技术栈识别、代码风格总结、架构约定和 AI 指令四部分。
生成完成后，TUI 状态栏会显示 ✅ AGENTS.md written，此时你已经拥有了一个上下文完备的编程 Agent，可以开始输入自然语言指令，例如：给 login.py 加上 JWT 过期时间校验 或 把 tests/ 下所有 pytest 测试改成异步方式。
