一、前置安装 Node.js官网下载https://nodejs.org/ 推荐 LTS 长期支持版安装时勾选Add to PATH必须否则npm命令找不到新开终端验证node-vnpm-v输出版本号代表成功。二、npm安装 / 更新 Codex CLI# 全局安装国内慢就加淘宝镜像npminstall-gopenai/codex# 国内加速版npminstall-gopenai/codex--registry[https://registry.npmmirror.com](https://registry.npmmirror.com)# 更新Codex升级新版本npmupdate-gopenai/codex# 验证是否安装成功codex--version输出版本号如codex-cli 0.146.0代表安装完成三、配置 DeepSeek两种方案一键脚本推荐 / 手动改config.toml前置去 DeepSeek开放平台 https://platform.deepseek.com/ 注册创建API Key提前复制保存Key✅ 方案1DeepSeek官方一键配置脚本推荐自动生成所有配置文件Windows PowerShell管理员打开irmhttps://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1|iex执行后菜单选项1配置 deepseek-flash日常开发首选粘贴你的 DeepSeek API Key等待脚本写入~/.codex/config.toml出现OK即完成Mac / Linuxbash(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.tomlMac/Linux路径~/.codex/config.toml打开config.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进入。快速切换模型命令临时单次使用codex--providerdeepseek--modeldeepseek-flash四、进入 Codex TUI 终端界面程序员常用快捷键 操作进入终端直接输入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权限设置最重要控制能不能读写文件、跑命令# 可选4种权限模式 permission_mode ask # read_only只读不能修改任何文件安全审计 # ask默认所有修改/执行命令弹窗询问推荐日常开发 # auto_approve自动放行常规操作高危操作询问 # full_access完全放开⚠️不推荐高危其他常用配置追加到 config.toml# 设置工作根目录AI只能访问这个目录 workspace_root /path/your/project # 启用/关闭功能开关 [features] unified_exec true shell_snapshot false查看、启用/关闭功能flagcodex features list codex featuresenableunified_exec codex features disable shell_snapshot六、常用外部命令终端不在codex会话内# 指定项目目录直接启动codexcodex--cd/your/project/path# 只让codex只读防止乱改代码codex--permissionread_only# 查看当前配置加载信息codex info七、测试验证是否正常工作终端输入codex进入界面输入帮我写一个简单的node hello worldAI正常返回代码代表DeepSeek配置成功。八、常见坑codex命令找不到重启终端确认Node安装时勾选PATHWindows重启PowerShellAPI报错检查DeepSeek Key是否正确、余额是否充足base_url不要多加/v1网络DeepSeek API国内可直连不需要代理权限首次AI修改文件、执行shell会弹出确认框/approve同意九、快速上手开发工作流示例cdmy-project codex# 输入梳理项目结构找出所有接口生成swagger文档# AI读取文件给出方案需要执行命令时输入 /approve运行codex出现报错那么就需要在 C:\Users\xxxx.codex 里面修改 config.toml 配置文件[windows]sandboxelevated改成[windows]sandboxunelevated