第 29 卷
macOS 常见问题
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 提示权限不足 | 文件夹权限限制 | 换到用户目录下的项目文件夹 |
| 命令找不到 | PATH 没生效 | 重开 Terminal |
| npm 权限问题 | 全局安装权限问题 | 优先用官方推荐安装方式 |
| 浏览器登录没跳回终端 | 浏览器拦截或网络问题 | 用 device auth |
| 终端不熟悉路径 | 不知道当前目录 | 用 pwd 和 ls |
推荐项目路径:
~/AI-Codex-Projects/hello-codex
常用检查命令:
pwd
ls
codex --version
codex doctor
运行 codex doctor 排查
如果你不知道问题出在哪里,可以先运行:
codex doctor
它适合排查:
安装异常
登录异常
配置异常
终端环境异常
权限问题
系统环境问题
遇到复杂问题时,可以把 doctor 结果发给 Codex,让它帮你分析:
请根据 codex doctor 的输出,帮我判断 CLI 哪里有问题。
新手通用排查流程
| 步骤 | 命令 / 操作 | 目的 |
|---|---|---|
| 1 | codex --version | 检查是否安装成功 |
| 2 | codex login status | 检查是否登录 |
| 3 | pwd / cd | 确认当前项目目录 |
| 4 | git status | 查看项目状态 |
| 5 | codex doctor | 检查环境问题 |
| 6 | /permissions | 检查权限设置 |
| 7 | /diff | 查看文件改动 |
| 8 | /ps | 查看后台任务 |
| 9 | /stop | 停止卡住的命令 |
| 10 | /compact | 对话太长时压缩上下文 |
Codex IDE Extension
把 Codex 直接装进你的代码编辑器里。
你不用单独打开 Codex App,也不用一直切到终端,而是可以在 VS Code、Cursor、Windsurf 这类编辑器侧边栏里直接使用 Codex。
怎么理解 Codex IDE Extension
概念简单来说
| IDE | 写代码的软件,比如 VS Code、Cursor、Windsurf |
|---|---|
| Codex IDE Extension | 装在编辑器里的 Codex |
| 侧边栏 | Codex 出现的位置,像一个聊天面板 |
选中代码你鼠标选中的那一段代码
上下文Codex 能参考的文件、代码、报错和任务说明
简单说:
Codex IDE = 在写代码软件里直接叫 Codex 帮你干活
Codex IDE Extension 适合谁
| 人群 | 是否适合 |
|---|---|
| 用 VS Code 的人 | 适合 |
| 用 Cursor 的人 | 适合 |
| 用 Windsurf 的人 | 适合 |
| 想边看代码边修改的人 | 适合 |
| 想让 Codex 只看当前文件的人 | 适合 |
| 完全不想碰编辑器的人 | 不太适合 |
| 更喜欢图形化任务管理的人 | 更适合 Codex App |
| 更喜欢终端的人 | 更适合 Codex CLI |
Codex IDE Extension 支持哪些编辑器
编辑器说明
| VS Code | 最常见的新手代码编辑器 |
|---|---|
| VS Code Insiders | VS Code 的测试版 |
| Cursor | AI 编辑器,基于 VS Code |
| Windsurf | AI 编辑器,也兼容 VS Code 插件体系 |
| JetBrains IDE | 比如 IntelliJ、PyCharm、WebStorm、Rider |
新手优先推荐:
VS Code 或 Cursor
全站分卷索引 · 72 卷
- 1第 1 卷
- 2第 2 卷
- 3第 3 卷
- 4第 4 卷
- 5第 5 卷
- 6第 6 卷
- 7第 7 卷
- 8第 8 卷
- 9第 9 卷
- 10第 10 卷
- 11第 11 卷
- 12第 12 卷
- 13第 13 卷
- 14第 14 卷
- 15第 15 卷
- 16第 16 卷
- 17第 17 卷
- 18第 18 卷
- 19第 19 卷
- 20第 20 卷
- 21第 21 卷
- 22第 22 卷
- 23第 23 卷
- 24第 24 卷
- 25第 25 卷
- 26第 26 卷
- 27第 27 卷
- 28第 28 卷
- 29第 29 卷
- 30第 30 卷
- 31第 31 卷
- 32第 32 卷
- 33第 33 卷
- 34第 34 卷
- 35第 35 卷
- 36第 36 卷
- 37第 37 卷
- 38第 38 卷
- 39第 39 卷
- 40第 40 卷
- 41第 41 卷
- 42第 42 卷
- 43第 43 卷
- 44第 44 卷
- 45第 45 卷
- 46第 46 卷
- 47第 47 卷
- 48第 48 卷
- 49第 49 卷
- 50第 50 卷
- 51第 51 卷
- 52第 52 卷
- 53第 53 卷
- 54第 54 卷
- 55第 55 卷
- 56第 56 卷
- 57第 57 卷
- 58第 58 卷
- 59第 59 卷
- 60第 60 卷
- 61第 61 卷
- 62第 62 卷
- 63第 63 卷
- 64第 64 卷
- 65第 65 卷
- 66第 66 卷
- 67第 67 卷
- 68第 68 卷
- 69第 69 卷
- 70第 70 卷
- 71第 71 卷
- 72第 72 卷