Codex failed to start. EPERM: operation not permitted, mkdir xxx 解决方法
Codex Windows版因用户目录含非ASCII字符导致启动时报错,无法创建默认SQLite路径。解决方案有两种:1)设置环境变量CODEX_HOME和CODEX_SQLITE_HOME指向英文路径(推荐);2)修改config.toml配置文件。具体步骤包括:创建英文目录、设置环境变量、检查权限、完全退出Codex后重启。文档确认环境变量优先级高于默认路径,该方法能有效规避Unicode路径
·
报错对应的 GitHub issue 显示,Codex Windows 版启动时会去创建:
C:\Users\你的用户名\.codex\sqlite
而这个问题和 Windows 用户目录里的 Unicode/非 ASCII 字符 有关,触发后会报 EPERM ... mkdir ... .codex\sqlite。(GitHub)
同时,Codex 官方仓库文档写明了:
- SQLite 状态库位置可以通过
sqlite_home配置项控制 - 或者通过环境变量
CODEX_SQLITE_HOME控制 - 如果没设,就会退回到
CODEX_HOME之类的默认目录。(GitHub)
方案 :设置环境变量到英文路径
先手动创建两个目录,比如:
C:\CodexDataC:\CodexData\sqlite
然后在 Windows 里设置这两个用户环境变量:
CODEX_HOME=C:\CodexData
CODEX_SQLITE_HOME=C:\CodexData\sqlite
图形界面设置方法
- 打开“开始菜单”
- 搜索并打开:编辑系统环境变量
- 点 环境变量
- 在“用户变量”里点 新建
- 分别添加:
变量名:
CODEX_HOME
变量值:
C:\CodexData
再添加一个:
变量名:
CODEX_SQLITE_HOME
变量值:
C:\CodexData\sqlite
- 确定保存
- 彻底退出 Codex
- 在任务管理器里确认 Codex 没有残留进程
- 重新打开 Codex
更多推荐



所有评论(0)