Codex 完整教程（Node.js安装 + npm安装Codex + DeepSeek配置 + 快捷键 + 设置）

一、前置：安装 Node.js

官网下载：https://nodejs.org/ 推荐 LTS 长期支持版
安装时勾选 Add to PATH（必须，否则npm命令找不到）
新开终端验证

bash 复制代码

node -v
npm -v

输出版本号代表成功。

二、npm安装 / 更新 Codex CLI

bash 复制代码

# 全局安装（国内慢就加淘宝镜像）
npm install -g @openai/codex
# 国内加速版
npm install -g @openai/codex --registry=[https://registry.npmmirror.com](https://registry.npmmirror.com)

# 更新Codex（升级新版本）
npm update -g @openai/codex

# 验证是否安装成功
codex --version

输出版本号如 codex-cli 0.146.0 代表安装完成

三、配置 DeepSeek（两种方案：一键脚本推荐 / 手动改config.toml）

前置：去 DeepSeek开放平台 https://platform.deepseek.com/ 注册，创建API Key，提前复制保存Key

✅ 方案1：DeepSeek官方一键配置脚本（推荐，自动生成所有配置文件）

Windows PowerShell（管理员打开）

powershell 复制代码

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

执行后菜单：

选项1：配置 deepseek-flash（日常开发首选）
粘贴你的 DeepSeek API Key
等待脚本写入 ~/.codex/config.toml，出现OK即完成

Mac / Linux

bash 复制代码

bash <(curl -fsSL [https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh](https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh))

同样选择模型，填入API Key。

📄 方案2：手动编辑 config.toml（适合懂配置文件）

先运行一次 codex，自动生成 .codex 文件夹，然后退出
- Windows路径：C:\Users\你的用户名\.codex\config.toml
- Mac/Linux路径：~/.codex/config.toml
打开 config.toml，替换全部内容：

toml 复制代码

# 默认使用deepseek
model_provider = "deepseek"

[model_providers.deepseek]
base_url = "[https://api.deepseek.com/](https://api.deepseek.com/)"
api_key = "你的DeepSeek API Key"
wire_api = "responses"
model = "deepseek-flash"

保存文件，重启终端输入 codex 进入。

快速切换模型命令（临时单次使用）

bash 复制代码

codex --provider deepseek --model deepseek-flash

四、进入 Codex TUI 终端界面：程序员常用快捷键 & 操作

进入：终端直接输入

bash 复制代码

codex

核心快捷键（TUI交互界面）

按键	作用
Enter	提交消息，继续当前任务
Tab	预写下一条追问，排队在下一轮执行
Esc（连续按2次）	编辑上一条你发的消息；多次Esc回溯历史对话，回车从该点分叉对话
`!` 开头（例如 `!npm install`）	在Codex内直接执行本地shell命令，输出会交给AI分析
Ctrl + C	终止当前AI正在执行的任务（非常常用）
Ctrl + D	退出Codex会话
↑ ↓	上下翻看历史对话
/	搜索对话历史

常用内置命令（Codex内部输入）

复制代码

/help        # 查看全部命令
/clear       # 清空当前会话上下文（不会删除项目文件）
/reset       # 重置整个会话
/approve     # 批量同意AI的文件修改/命令执行
/reject      # 拒绝AI接下来要执行的操作
/history     # 查看完整对话记录
/model       # 查看当前使用模型
/provider    # 查看当前模型提供商

五、Codex 核心设置（权限、功能开关，config.toml）

权限设置（最重要！控制能不能读写文件、跑命令）

toml 复制代码

# 可选4种权限模式
permission_mode = "ask"
# read_only：只读，不能修改任何文件，安全审计
# ask：默认，所有修改/执行命令弹窗询问（推荐日常开发）
# auto_approve：自动放行常规操作，高危操作询问
# full_access：完全放开，⚠️不推荐，高危！

其他常用配置追加到 config.toml

toml 复制代码

# 设置工作根目录，AI只能访问这个目录
workspace_root = "/path/your/project"

# 启用/关闭功能开关
[features]
unified_exec = true
shell_snapshot = false

查看、启用/关闭功能flag：

bash 复制代码

codex features list
codex features enable unified_exec
codex features disable shell_snapshot

六、常用外部命令（终端，不在codex会话内）

bash 复制代码

# 指定项目目录直接启动codex
codex --cd /your/project/path

# 只让codex只读，防止乱改代码
codex --permission read_only

# 查看当前配置加载信息
codex info

七、测试验证是否正常工作

终端输入 codex 进入界面
输入：帮我写一个简单的node hello world
AI正常返回代码，代表DeepSeek配置成功。

八、常见坑

codex 命令找不到：重启终端，确认Node安装时勾选PATH；Windows重启PowerShell
API报错：检查DeepSeek Key是否正确、余额是否充足；base_url不要多加 /v1
网络：DeepSeek API国内可直连，不需要代理
权限：首次AI修改文件、执行shell，会弹出确认框，/approve 同意

九、快速上手开发工作流示例

bash 复制代码

cd my-project
codex
# 输入：梳理项目结构，找出所有接口，生成swagger文档
# AI读取文件，给出方案；需要执行命令时输入 /approve

运行codex出现报错

那么就需要在 C:\Users\xxxx.codex 里面修改 config.toml 配置文件

bash 复制代码

[windows]
sandbox = "elevated"

改成

bash 复制代码

[windows]
sandbox = "unelevated"