当前位置： 首页 > news >正文

Codex 新手安装教程（完全小白版）

news 2026/6/7 20:35:01

一、Codex 是什么

Codex 是 OpenAI 推出的 AI 编程助手，可直接在本地电脑上完成以下操作：

  • 读代码— 分析项目结构和代码逻辑
  • 改代码— 根据需求修改、重构代码
  • 跑命令— 执行终端命令、运行测试、安装依赖
  • 修 Bug— 自动发现并修复代码中的问题

三种使用方式

方式适合人群特点
Codex App（桌面应用）新手、不习惯命令行的用户图形界面，最简单
Codex CLI（命令行）开发者功能最全，效率最高
IDE 插件VS Code / Cursor 用户在编辑器内直接使用

推荐路线：新手先装 App 体验，熟悉后再装 CLI 深入使用。

二、安装前的准备工作

账号要求

Codex 需要付费使用，以下账号均可：

  • ChatGPT Plus / Pro
  • ChatGPT Business / Edu / Enterprise
  • OpenAI API Key（按量计费）

个人用户直接用 ChatGPT 账号登录最省心。

Windows 用户注意

  • 推荐 Windows 11 或较新的 Windows 10
  • 安装过程可能需要管理员权限
  • 需要稳定的网络连接

三、安装 Codex App（推荐新手）

第 1 步：下载安装包

  1. 访问 OpenAI 官方 Codex 页面：https://chatgpt.com/codex
  2. 下载对应版本（Windows 或 macOS）
  3. 双击安装包，按提示完成安装

第 2 步：登录账号

  1. 打开 Codex App
  2. 选择Sign in with ChatGPT（推荐）
  3. 浏览器弹出登录页面，用 ChatGPT 账号登录

如果使用"邮箱+密码"注册的 ChatGPT，必须先开启双重验证（MFA）才能使用 Codex。

第 3 步：选择项目目录

  1. 点击选择文件夹
  2. 选择存放代码的目录（或新建一个）
  3. 确认后进入主界面

第 4 步：开始对话

在输入框输入第一个指令：

帮我分析一下这个项目的结构

Codex 会自动扫描目录，返回项目文件结构和架构说明。

四、安装 Codex CLI（开发者推荐）

CLI 版功能更强大，适合日常开发使用。

第 1 步：安装 Node.js

Codex CLI 需要 Node.js 22+ 环境。先检查是否已安装：

node--version
  • 显示v22.x.x或更高版本 -> 跳过此步
  • 低于 v22 或未安装 -> 继续
Windows 安装 Node.js

方法一：官网下载（推荐）

  1. 访问 https://nodejs.org/
  2. 下载LTS（长期支持版）
  3. 双击安装包，一路"下一步"完成
  4. 重启命令提示符，运行node --version验证

方法二：使用 nvm

# 安装 nvm（Windows 版 https://github.com/coreybutler/nvm-windows）nvminstall22nvm use22
macOS 安装 Node.js
# 方法一：官网下载 pkg 安装包# 方法二：使用 Homebrewbrewinstallnode
Linux / Ubuntu 安装 Node.js
curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsnode--versionnpm--version

第 2 步：安装 Codex CLI

确认 Node.js 安装成功后：

npminstall-g@openai/codex

国内用户加速：

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

macOS / Linux 如遇权限错误，加sudo：

sudonpminstall-g@openai/codex

第 3 步：验证安装

codex--version

显示版本号（如0.42.0）即安装成功。

第 4 步：启动并登录

codex

首次运行会提示登录：

  1. 选择Sign in with ChatGPT
  2. 浏览器弹出授权页面
  3. 登录 ChatGPT 账号并完成授权
  4. 授权完成后返回终端

登录失败时，尝试开启网络工具的全局模式（TUN 模式），然后重新运行codex。

五、Codex CLI 的使用

5.1 两种使用模式

模式一：交互模式（推荐日常使用）
codex

进入后像聊天一样连续对话：

>> 帮我分析一下这个项目的结构 >> 给这个函数加上错误处理 >> 运行测试看看有没有问题

有上下文记忆，可连续执行复杂任务。

模式二：命令模式（快速任务）
codex"写一个计算斐波那契数列的 Python 函数"codex"找出项目中所有的 TODO 注释"

执行完即退出，适合一次性任务。

5.2 三种安全模式

模式命令说明
建议模式codex --approval-mode suggest只给建议，不修改文件（最安全）
自动编辑codex --approval-mode auto-edit自动改文件，执行命令需确认（推荐）
全自动codex --approval-mode full-auto自动改文件、自动执行命令（最快）

默认是 suggest 模式，可在交互模式下输入/approval切换。

5.3 常用命令

# 查看帮助codex--help# 使用特定模型codex--modelgpt-5-codex# 进入项目目录后启动cdmy-project codex# 升级 Codex CLInpmupdate-g@openai/codex

六、配置优化

6.1 设置中文回复

在~/.codex/目录下创建AGENTS.md文件：

Windows：

mkdir%USERPROFILE%\.codexechoAlways respondinChinese-simplified>%USERPROFILE%\.codex\AGENTS.md

macOS / Linux：

mkdir-p~/.codexecho"Always respond in Chinese-simplified">~/.codex/AGENTS.md

6.2 使用 API Key 登录（可选）

不想用 ChatGPT 账号登录时，可用 API Key：

临时设置（当前终端有效）：

exportOPENAI_API_KEY="sk-你的API密钥"codex

永久设置（macOS / Linux）：

echo'export OPENAI_API_KEY="sk-你的API密钥"'>>~/.bashrcsource~/.bashrc

永久设置（Windows）：

setx OPENAI_API_KEY"sk-你的API密钥"

七、常见问题

Q1: 安装时提示 “npm: command not found”

原因：Node.js 未正确安装或环境变量未配置。

解决：

  1. 重新安装 Node.js
  2. Windows 用户重启命令提示符
  3. macOS / Linux 用户重启终端或运行source ~/.bashrc

Q2: 安装后提示 “codex: command not found”

原因：npm 全局安装目录不在系统 PATH 中。

解决（Windows）：

npmconfig get prefix

将输出路径下的\bin目录添加到系统环境变量 PATH，重启终端。

解决（macOS / Linux）：

source~/.bashrc# 或nvm use22

Q3: 登录时提示 401 Unauthorized

原因：授权过期或会员到期。

解决：

codexlogoutcodex

重新登录即可。

Q4: 提示 “502 stream error” 或连接失败

原因：网络问题。

解决：

  1. 开启网络工具的全局模式（TUN 模式）
  2. 或设置代理：
exportHTTPS_PROXY=http://127.0.0.1:7890 codex

Q5: Windows 安装时提示权限错误

解决：以管理员身份运行 PowerShell 或命令提示符（右键 -> 以管理员身份运行）。

Q6: 提示 Node.js 版本过低

解决：

# 使用 nvm 升级到 Node.js 22nvminstall22nvm use22nvmaliasdefault22# 重新安装 Codexnpmuninstall-g@openai/codexnpminstall-g@openai/codex

八、快速入门建议

安装完成后按此顺序尝试：

  1. 分析项目：帮我分析当前项目的结构，告诉我主要有哪些模块
  2. 写小功能：帮我写一个计算 BMI 的函数，包含输入验证
  3. 改代码：帮我把这个函数重构一下，加上错误处理
  4. 跑测试：运行项目的测试，看看有没有失败的

九、总结

步骤操作预计时间
1确认有 ChatGPT 付费账号1 分钟
2安装 Node.js（CLI 用户需要）5 分钟
3安装 Codex（App 或 CLI）3 分钟
4登录授权2 分钟
5开始对话使用立即

推荐路线：

  1. 先装 Codex App 体验基本功能
  2. 熟悉后再装 Codex CLI 提高效率
  3. 日常开发中把重复性工作交给 Codex
http://www.gsyq.cn/news/1481967.html

相关文章：

  • CSDN数字营销赔付机制深度拆解：违规判定后72小时内可追偿的4个关键证据链与3份必备材料模板
  • 别再只用默认配置了！MinIO单机部署到CentOS 7的5个生产级安全加固技巧
  • 别再为Cesium加载QGIS切片发愁了！手把手教你用Nginx发布XYZ瓦片服务（附完整代码）
  • Claude Code 免费白嫖 Qwen3.6，Token 无限量
  • 产教融合深度落地！工信部教考中心新能源电池材料修复工程师、工信部新能源三证产教融合辅导专家助力行业人才提质 - 资讯纵览
  • Claude Code Skill 完整工作流，从零构建一个 PDF 生成技能
  • 如何高效使用开源图像浏览器ImageGlass：提升工作效率的完整指南
  • 学习JAVA第7周
  • 别再只盯着传统摄像头了：事件相机在无人机避障和电力线巡检中的实战优势解析
  • DGL实战入门：用空手道俱乐部数据跑通GCN和GAT节点分类全流程
  • 抖音视频批量下载难题：如何轻松保存无水印内容？
  • 调查研究-161 OpenAI AI 设备揭秘:这不是手机,而是下一代入口实验
  • 面试官问：什么是 Harness 工程？AI Agent 时代，测试人必须补上的新能力
  • PPT转图片终极指南：5分钟快速掌握PPT2Image完整教程
  • 索尼相机隐藏功能终极解锁指南：如何免费突破30分钟录制限制
  • 贵州品质旅行社排名：口碑好的定制小包团指南 - 资讯纵览
  • 主标题：新能源培训热门！三电培训落地辅导[地域]企业 备选标题：新能源领域聚焦！三电培训落地辅导[地域]专家企业 - 资讯纵览
  • Java Lambda方法引用的三类傻瓜式对比
  • QLExpress4：颠覆性企业级规则引擎的架构演进与工程实践
  • RocketMQ 4.9.5 集群搭建
  • ULN2803驱动大尺寸数码管：从OC输出原理到动态扫描实战
  • 西服定制店铺实测排行 品质工艺客观对比 - 奔跑123
  • Java Lambda方法引用的三类核心类型、转化逻辑与深度对比
  • Tianshou强化学习库架构革新：资源受限环境下的高性能部署技术深度解析
  • 杭州未来科技城广州菜餐厅实测排行：鲜度与风味对决 - 奔跑123
  • 5分钟搭建抖音直播弹幕监控系统：Go语言实现全解析
  • 3个核心问题，NcmpGui如何让你的网易云音乐重获自由？
  • 2026年企业与个人AI编程工具综合榜单
  • Protel DXP Gerber文件生成全攻略：从原理到实战避坑指南
  • OpenSpeedy终极指南：免费开源游戏加速工具完全解析