codex cli 在无 git 仓库的空目录中报 fatal: not a git repository 错误，因默认启用 git 集成；可通过 --no-git 标志、临时 git init 或配置 enable_git = false 绕过。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在刚新建的空文件夹或解压出来的项目里直接用 Codex CLI，但每次一输入 codex 就报 fatal: not a git repository 错误，根本进不去交互界面。
确认当前目录确实没有 Git 仓库
先执行 git status，如果返回 fatal: not a git repository，说明当前路径下没有 .git 目录。这本身不是问题——Codex CLI 并不要求必须有 Git，但它的某些默认行为（比如自动读取 diff、提交建议、版本对比）会触发底层 git 命令，从而暴露这个错误。
运行 ls -a | grep "\.git"（macOS/Linux）或 dir /ah .git（Windows）确认 【.git 目录不存在】。如果存在但被隐藏或损坏，后续步骤不适用，请先修复 Git 状态。
绕过 Git 依赖的三种启动方式
方法一：用 --no-git 标志强制禁用所有 Git 集成
直接在终端中运行：codex --no-git。这会让 Codex 跳过所有与 git 相关的初始化检查和功能调用，包括 diff 分析、commit 提示、branch 检测等。它仍能读写文件、执行命令、修改代码，只是不会尝试调用任何 git 子命令。
方法二：临时初始化一个轻量 Git 仓库（推荐用于短期调试）
执行 git init && git add . && git commit -m "init for codex"。这一步非常快，不需要远程仓库，也不影响你后续是否使用 Git。Codex 启动后就不会再报 fatal 错误，且能正常使用 diff 查看改动——【注意：此操作会真实生成 .git 目录并记录一次提交，不可逆】。
方法三：通过配置文件全局关闭 Git 自动检测
编辑或新建 ~/.codex/config.toml，在文件末尾添加：
[features]enable_git = false
保存后重启 Codex（关闭再重新运行 codex）。该设置对本机所有非项目级配置生效，但不会影响已存在 .codex/config.toml 的项目目录。
进入交互后限制提示词范围
第一步：启动成功后，立刻输入一句明确指令，例如：“请列出当前目录下的所有文件，不要尝试读取 git 日志或显示未暂存更改。”
第二步：避免使用含 Git 语义的词汇，如“上次提交”“对比 master”“生成 patch”“查看改动历史”。Codex 在非 Git 环境下若收到这类请求，可能静默失败或返回空结果。
第三步：需要验证修改效果时，改用显式命令代替隐式行为。例如，不写“运行测试并报告失败项”，而写“执行 npm test，把完整输出贴给我”。Codex 不会因缺少 Git 上下文而拒绝执行 shell 命令。
