codex在linux mint中卡住需强制终止进程并清理资源：用pkill -f "@openai/codex|codex-desktop|codex-cli"清空进程树，删除~/.codex/cache/sessions/*.lock和state.db-journal，检查端口3000占用，确认node.js≥v22.0.0、目录权限为755、config.toml无隐藏字符。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Linux Mint安装Codex后点击图标无反应、终端执行codex命令卡住不动、进程在后台持续占用CPU但不输出任何结果，说明CLI或Desktop进程已陷入挂起状态，必须人工干预释放资源才能继续调试配置问题。
确认Codex是否真正在运行
打开终端，执行：ps aux | grep codex→ 查看输出中是否有codex或codex-desktop相关进程。若看到类似codex session list或codex login的命令行残留，且CPU%持续高于80%，说明进程已死锁。
注意：不要只看grep自身进程——它会出现在结果里，真正要找的是父进程为codex且状态为R（运行中）或U（不可中断睡眠）的条目。
强制终止所有Codex相关进程
方法一：精准杀掉活跃会话进程
执行codex session list→ 若命令本身卡住，直接跳过；改用pgrep -f "codex.*session" | xargs kill -9→ 强制清除所有会话管理子进程。
方法二：一键清空全部Codex进程树
运行pkill -f "@openai/codex\|codex-desktop\|codex-cli"→ 这条命令能同时匹配Node.js启动脚本、Rust二进制和Electron主进程，比单纯pkill codex更彻底。
【关键提醒】若之前用sudo codex启动过，普通pkill可能无法杀死root权限进程，必须加sudo pkill -f ...，否则残留进程会持续抢占端口和SQLite锁。
释放被锁定的本地资源
第一步：删除会话缓存锁文件
执行rm -f ~/.codex/cache/sessions/*.lock→ Codex在崩溃时未释放文件锁，导致新进程反复尝试获取失败而挂起。
第二步：检查并清理SQLite数据库状态
进入~/.codex/cache/目录→ 执行ls -la *.db*→ 若发现state.db-journal文件存在且大小非零，说明上次写入异常中断，直接删除该journal文件：rm -f state.db-journal。
第三步：验证端口占用情况
Codex Desktop默认监听localhost:3000，执行lsof -i :3000→ 若返回PID，记下该号→ 执行kill -9 PID→ 确保端口空闲后再启动。
重启Codex前的必要检查
① 检查Node.js版本是否合规：运行node --version→ 必须≥v22.0.0，低于此版本会导致顶层await语法报错并静默退出。
② 验证~/.codex目录权限：执行ls -ld ~/.codex→ 输出中第三段应为rwx（如drwxr-xr-x），若显示drw-r--r--则需修复：chmod 755 ~/.codex。
③ 确认config.toml中model = "gpt-5.5"一行未被注释，且前后无不可见Unicode空格——这类字符会让TOML解析器卡在加载阶段不报错也不响应。
