Linux 服务器 Codex 执行 pwd、ls 无响应：bubblewrap(sandbox\bwrap) 沙箱卡死的解决方案

codex 方便快速执行：

c 复制代码

codex --ask-for-approval never

Linux 服务器 Codex 执行 `pwd`、`ls` 无响应：bubblewrap 沙箱卡死的解决方案

一、问题现象

在 Linux 服务器上通过 OpenAI 官方安装脚本安装 Codex CLI 后，Codex 可以正常启动、登录和调用模型：

bash 复制代码

codex

但当 Codex 尝试读取或修改本地文件时，会提示：

text 复制代码

暂未修改文件：当前终端执行异常，连 pwd、ls 等基础只读命令都持续无响应，因此无法安全读取、编辑并验证目标脚本。

直接测试 Codex 沙箱也会超时：

bash 复制代码

timeout 15 codex sandbox -- /bin/pwd
echo $?

text 复制代码

124 表示命令被 timeout 强制终止，说明问题不是 pwd 或 ls 命令本身，而是 Codex 的 Linux 沙箱没有成功启动。

二、问题原因

Codex CLI 安装成功，只代表 Codex 主程序可以正常启动，并不代表 Linux 本地沙箱环境一定正常。

Codex 在 Linux 上执行本地命令时，需要使用 bubblewrap，其命令名为：

bash 复制代码

bwrap

本次问题的根因是：

Conda 环境中的 bwrap 被替换成了一个异常的 Bash 脚本；
该脚本只有 132 字节，运行 bwrap --version 时会一直卡住；
系统自带的 /usr/bin/bwrap 版本为 0.3.0，版本较旧；
Codex优先使用 PATH 中排在前面的 Conda bwrap，导致沙箱启动一直无响应。

通过下面的命令可以查看当前使用的 bwrap：

bash 复制代码

type -a bwrap
command -v bwrap
file "$(command -v bwrap)"

异常情况下可能显示：

text 复制代码

bwrap is /home/用户名/anaconda3/bin/bwrap
bwrap is /usr/bin/bwrap

并且：

text 复制代码

/home/用户名/anaconda3/bin/bwrap: a /usr/bin/env bash script

正常的 bubblewrap 应该是 ELF 二进制文件，而不是 Bash 脚本。

三、解决思路

正确的解决方案是：

使用独立 Conda 环境安装新版 bubblewrap；
使用全新的 Conda 包缓存，避免继续读取损坏的缓存；
使用 --copy，避免 Conda 硬链接再次污染软件包缓存；
为 Codex建立独立的 bwrap 命令路径；
将该路径放到 PATH 最前面；
验证 Codex 沙箱是否恢复正常。

以下操作不需要 sudo 权限。

四、备份异常的 Conda bwrap

先检查当前 Conda 中的 bwrap：

bash 复制代码

ls -lh "$HOME/anaconda3/bin/bwrap"
file "$HOME/anaconda3/bin/bwrap"

如果它是异常脚本，先进行备份：

bash 复制代码

if [ -e "$HOME/anaconda3/bin/bwrap" ]; then
    mv "$HOME/anaconda3/bin/bwrap" \
       "$HOME/anaconda3/bin/bwrap.broken.$(date +%Y%m%d_%H%M%S)"
fi

hash -r

不要直接修改或覆盖 Conda 包目录中的文件。

五、清理旧的独立环境和损坏缓存

删除之前可能创建的不完整环境：

bash 复制代码

conda env remove \
  -p "$HOME/.local/opt/codex-bwrap" \
  -y 2>/dev/null || true

rm -rf "$HOME/.local/opt/codex-bwrap"

删除原 Conda 缓存中损坏的 bubblewrap 包：

bash 复制代码

rm -rf \
  "$HOME/anaconda3/pkgs/bubblewrap-0.11.2-h424e585_1"

rm -f \
  "$HOME/anaconda3/pkgs/bubblewrap-0.11.2-h424e585_1.conda" \
  "$HOME/anaconda3/pkgs/bubblewrap-0.11.2-h424e585_1.tar.bz2"

检查是否清理干净：

bash 复制代码

find "$HOME/anaconda3/pkgs" \
  -maxdepth 1 \
  -name 'bubblewrap-0.11.2-h424e585_1*' \
  -print

没有输出表示对应缓存已经删除。

六、使用全新缓存安装 bubblewrap 0.11.2

创建一个独立的软件包缓存目录：

bash 复制代码

rm -rf "$HOME/.cache/conda-codex-pkgs"
mkdir -p "$HOME/.cache/conda-codex-pkgs"

使用该缓存创建专门供 Codex 使用的 bubblewrap 环境：

bash 复制代码

CONDA_PKGS_DIRS="$HOME/.cache/conda-codex-pkgs" \
conda create \
  -y \
  --copy \
  --override-channels \
  -p "$HOME/.local/opt/codex-bwrap" \
  -c conda-forge \
  bubblewrap=0.11.2

参数说明：

text 复制代码

CONDA_PKGS_DIRS

指定一个全新的软件包缓存目录，防止继续使用原来损坏的 Conda 缓存。

text 复制代码

--copy

要求 Conda 复制文件，而不是使用硬链接，避免修改环境文件时污染缓存中的原始文件。

text 复制代码

--override-channels

只使用本次指定的 conda-forge 通道。

text 复制代码

-p

将 bubblewrap 安装到独立目录，不污染 Conda base 环境。

七、验证新版 bubblewrap

设置变量：

bash 复制代码

BWRAP_NEW="$HOME/.local/opt/codex-bwrap/bin/bwrap"

检查文件：

bash 复制代码

echo "路径：$BWRAP_NEW"

ls -lh "$BWRAP_NEW"

stat -c '大小：%s bytes' "$BWRAP_NEW"

file "$BWRAP_NEW"

ldd "$BWRAP_NEW"

正常结果应满足：

text 复制代码

大小约为 83136 bytes
ELF 64-bit LSB shared object

不能再显示：

text 复制代码

132 bytes
a /usr/bin/env bash script

检查版本：

bash 复制代码

/usr/bin/timeout -k 1 5 \
  "$BWRAP_NEW" --version

echo "version_exit=$?"

正常输出：

text 复制代码

bubblewrap 0.11.2
version_exit=0

八、测试 bubblewrap 沙箱

直接使用新安装的 bubblewrap 执行一个只读命令：

bash 复制代码

/usr/bin/timeout -k 2 10 \
  "$BWRAP_NEW" \
  --ro-bind / / \
  --proc /proc \
  --dev /dev \
  /bin/pwd

echo "bwrap_test_exit=$?"

正常情况下，会输出当前工作目录：

text 复制代码

/home/用户名/work/codex_test

并返回：

text 复制代码

bwrap_test_exit=0

这表示：

bubblewrap 二进制文件正常；
当前用户可以创建所需命名空间；
Linux 服务器内核支持 bubblewrap 沙箱；
不需要管理员修改 user namespace 参数。

九、为 Codex创建专用 bwrap 路径

创建一个专门放置 Codex 沙箱命令的目录：

bash 复制代码

mkdir -p "$HOME/.local/codex-sandbox-bin"

创建软链接：

bash 复制代码

ln -sfn \
  "$HOME/.local/opt/codex-bwrap/bin/bwrap" \
  "$HOME/.local/codex-sandbox-bin/bwrap"

将该目录放到当前终端 PATH 最前面：

bash 复制代码

export PATH="$HOME/.local/codex-sandbox-bin:$HOME/.local/bin:$PATH"
hash -r

验证 Codex实际会找到哪个 bwrap：

bash 复制代码

command -v bwrap
readlink -f "$(command -v bwrap)"
bwrap --version

正确结果类似：

text 复制代码

/home/用户名/.local/codex-sandbox-bin/bwrap
/home/用户名/.local/opt/codex-bwrap/bin/bwrap
bubblewrap 0.11.2

十、测试 Codex 沙箱

注意，当前版本的测试命令应使用：

bash 复制代码

codex sandbox -- 命令

不要在 sandbox 后面额外添加 linux。

测试当前目录：

bash 复制代码

/usr/bin/timeout -k 2 20 \
  codex sandbox -- /bin/pwd

echo "codex_sandbox_exit=$?"

正常情况下会输出当前目录，并返回：

text 复制代码

codex_sandbox_exit=0

测试读取项目目录：

bash 复制代码

/usr/bin/timeout -k 2 20 \
  codex sandbox -- \
  /bin/ls -la "$HOME/work/codex_test"

echo "codex_ls_exit=$?"

正常情况下会列出目录内容，并返回：

text 复制代码

codex_ls_exit=0

如果使用下面这种命令：

bash 复制代码

codex sandbox linux /bin/pwd

Codex可能会把 linux 当成要执行的程序，从而出现：

text 复制代码

Failed to execvp linux: Permission denied

因此应使用：

bash 复制代码

codex sandbox -- /bin/pwd

十一、永久配置 PATH

确认新版 bubblewrap 和 Codex 沙箱均正常后，将路径配置写入 ~/.bashrc：

bash 复制代码

cat >> "$HOME/.bashrc" <<'EOF'

# Codex Linux sandbox: use bubblewrap 0.11.2
export PATH="$HOME/.local/codex-sandbox-bin:$HOME/.local/bin:$PATH"
EOF

建议将该配置放在 ~/.bashrc 中 Conda 初始化代码之后，确保不会再次被 Conda 的 PATH 覆盖。

重新加载配置：

bash 复制代码

source "$HOME/.bashrc"
hash -r

最终验证：

bash 复制代码

command -v bwrap
readlink -f "$(command -v bwrap)"
bwrap --version

然后测试 Codex 沙箱：

bash 复制代码

timeout 20 codex sandbox -- /bin/pwd
echo "sandbox_exit=$?"

如果返回：

text 复制代码

sandbox_exit=0

说明配置已经永久生效。

十二、重新启动 Codex

进入项目目录：

bash 复制代码

cd "$HOME/work/codex_test"

正常启动 Codex：

bash 复制代码

codex \
  --sandbox workspace-write \
  --ask-for-approval on-request

进入 Codex 后，可以让它执行：

text 复制代码

执行 pwd 和 ls -la，只读取当前项目内容，不要修改文件。

此时 Codex应该能够正常：

执行 pwd；
执行 ls；
读取项目文件；
编辑工作区文件；
验证修改结果。

十三、一键检查命令

后续遇到类似问题时，可以先运行下面的检查脚本：

bash 复制代码

echo "========== Codex =========="
command -v codex
codex --version

echo
echo "========== bwrap =========="
type -a bwrap
command -v bwrap
readlink -f "$(command -v bwrap)"
file "$(command -v bwrap)"
bwrap --version

echo
echo "========== bubblewrap test =========="
timeout 10 bwrap \
  --ro-bind / / \
  --proc /proc \
  --dev /dev \
  /bin/pwd

echo "bwrap_exit=$?"

echo
echo "========== Codex sandbox test =========="
timeout 20 codex sandbox -- /bin/pwd

echo "codex_sandbox_exit=$?"

正常情况下，最后两个退出码都应为：

text 复制代码

十四、完整安装命令汇总

下面是精简后的完整正确流程：

bash 复制代码

# 1. 备份异常的 Conda bwrap
if [ -e "$HOME/anaconda3/bin/bwrap" ]; then
    mv "$HOME/anaconda3/bin/bwrap" \
       "$HOME/anaconda3/bin/bwrap.broken.$(date +%Y%m%d_%H%M%S)"
fi

hash -r

# 2. 删除旧环境
conda env remove \
  -p "$HOME/.local/opt/codex-bwrap" \
  -y 2>/dev/null || true

rm -rf "$HOME/.local/opt/codex-bwrap"

# 3. 创建全新 Conda 缓存
rm -rf "$HOME/.cache/conda-codex-pkgs"
mkdir -p "$HOME/.cache/conda-codex-pkgs"

# 4. 安装 bubblewrap 0.11.2
CONDA_PKGS_DIRS="$HOME/.cache/conda-codex-pkgs" \
conda create \
  -y \
  --copy \
  --override-channels \
  -p "$HOME/.local/opt/codex-bwrap" \
  -c conda-forge \
  bubblewrap=0.11.2

# 5. 验证 bubblewrap
BWRAP_NEW="$HOME/.local/opt/codex-bwrap/bin/bwrap"

file "$BWRAP_NEW"
"$BWRAP_NEW" --version

timeout 10 "$BWRAP_NEW" \
  --ro-bind / / \
  --proc /proc \
  --dev /dev \
  /bin/pwd

# 6. 创建 Codex 专用软链接
mkdir -p "$HOME/.local/codex-sandbox-bin"

ln -sfn \
  "$BWRAP_NEW" \
  "$HOME/.local/codex-sandbox-bin/bwrap"

# 7. 设置 PATH
export PATH="$HOME/.local/codex-sandbox-bin:$HOME/.local/bin:$PATH"
hash -r

# 8. 检查实际版本
command -v bwrap
readlink -f "$(command -v bwrap)"
bwrap --version

# 9. 测试 Codex 沙箱
timeout 20 codex sandbox -- /bin/pwd
echo "sandbox_exit=$?"

# 10. 永久写入 bashrc
grep -qxF \
  'export PATH="$HOME/.local/codex-sandbox-bin:$HOME/.local/bin:$PATH"' \
  "$HOME/.bashrc" || \
echo 'export PATH="$HOME/.local/codex-sandbox-bin:$HOME/.local/bin:$PATH"' \
  >> "$HOME/.bashrc"

source "$HOME/.bashrc"
hash -r

十五、总结

Codex能够启动和登录，但无法执行 pwd、ls，通常不是 Codex主程序安装失败，而是 Linux 本地沙箱中的 bubblewrap 异常。

问题的关键点是：

text 复制代码

Conda 中的 bwrap 是损坏的 132 字节 Bash 脚本

正确处理方式不是反复重装 Codex，而是：

text 复制代码

使用独立 Conda 环境安装真正的 bubblewrap 0.11.2
使用全新的 Conda 缓存
使用 --copy 避免硬链接污染
将新版 bwrap 放到 PATH 最前面
使用 codex sandbox -- /bin/pwd 验证

完成配置后，Codex即可正常执行本地命令、读取代码、修改文件并验证运行结果。

Linux 服务器 Codex 执行 pwd、ls 无响应：bubblewrap(sandbox\bwrap) 沙箱卡死的解决方案

Linux 服务器 Codex 执行 pwd、ls 无响应：bubblewrap 沙箱卡死的解决方案

一、问题现象

二、问题原因

三、解决思路

四、备份异常的 Conda bwrap

五、清理旧的独立环境和损坏缓存

六、使用全新缓存安装 bubblewrap 0.11.2

七、验证新版 bubblewrap

八、测试 bubblewrap 沙箱

九、为 Codex创建专用 bwrap 路径

十、测试 Codex 沙箱

十一、永久配置 PATH

十二、重新启动 Codex

十三、一键检查命令

十四、完整安装命令汇总

十五、总结

Linux 服务器 Codex 执行 `pwd`、`ls` 无响应：bubblewrap 沙箱卡死的解决方案