← 返回目录

第 27 卷

第 27 / 72 卷日期：2026-07-04

codex --version

node -v

npm -v

codex doctor

小白建议：

安装后第一件事，不是直接用，而是先运行 codex --version。

能看到版本号，说明基础安装正常。

登录类问题

问题	原因	解决方法
不知道有没有登录	没检查登录状态	运行codex login status
浏览器没有自动打开	默认浏览器异常或远程环境	使用codex login --device-auth
ChatGPT 登录失败	网络、账号、浏览器缓存问题	重新运行codex login
API Key 登录失败	环境变量没设置好	检查 OPENAI_API_KEY
想换账号	本机保存了旧账号	先codex logout，再重新登录

常用命令：

codex login

codex login status

codex logout

codex login --device-auth

新手建议：

本地学习优先用 ChatGPT 账号登录。

API Key 登录更适合开发者、自动化和服务器场景。

项目目录类问题

问题原因解决方法

Codex 读错文件	在错误目录启动	退出后重新进入正确目录
Codex 扫描了太多东西	在桌面、下载目录或 C 盘启动	只在具体项目文件夹里启动
不知道当前在哪	不清楚终端所在路径	Windows 用 cd，Mac 用 pwd
找不到文件	文件不在当前项目内	用 /mention 指定文件，或进入正确目录

推荐方式：

cd D:\AI-Codex-Projects\hello-codex

codex

不推荐：

在 C 盘根目录运行

在桌面运行

在下载文件夹运行

在重要资料文件夹运行

一句话：

你在哪个目录运行 codex，它就默认把哪个目录当成项目。

权限和沙盒类问题

问题	原因	解决方法
Codex 提示需要批准	它要执行敏感操作	看懂后再允许
Codex 不能访问网络	沙盒默认限制联网	需要时手动批准
Codex 不能读取项目外文件	超出 workspace 范围	不建议随便放开
Codex 不能修改某些文件	权限不足或在只读模式	检查 /permissions
Codex 请求完全访问权限	任务需要更大权限	小白不要随便同意

推荐设置：

sandbox：workspace-write

approval：on-request

on-request = 敏感操作先问你

不要随便使用：

danger-full-access

--yolo

--dangerously-bypass-approvals-and-sandbox

看到不懂的权限请求，可以问：

请解释这个操作为什么需要权限，会影响哪些文件，有没有更安全的替代方案。

命令运行类问题

问题	原因	解决方法
npm run dev 失败	依赖没装或脚本不存在	先看 package.json
npm install 失败	网络、源、权限或依赖冲突	让 Codex 先分析错误
npm run build 失败	项目代码本身有报错	让 Codex 复现并最小修复
命令卡住不动	开发服务器一直运行	用 /ps 查看后台任务
想停止命令	命令一直占用终端	用 /stop 停止后台任务

常见命令含义：

命令含义

npm install	安装项目依赖
npm run dev	启动开发环境
npm run build	检查项目能否正式构建
npm test	运行测试
git status	查看项目改动状态
git diff	查看具体改动

不懂命令时，先让 Codex 解释：

请先解释你准备运行的命令，每条命令是干什么的，不要直接执行。

全站分卷索引 · 72 卷