【Bug已解决】codex: 沙箱阻止操作 — CodeX CLI 无法在沙箱中执行命令解决方案

【Bug已解决】codex: "sandbox mode blocked operation" / Cannot execute in sandbox --- CodeX 沙箱阻止操作解决方案

1. 问题描述

CodeX CLI 在沙箱模式下被阻止执行某些操作：

# 沙箱阻止写入
$ codex --full-auto "修改 src/index.js"
Error: Sandbox blocked write to src/index.js
Directory not in allowedDirectories.

# 或沙箱阻止命令
$ codex --full-auto "运行 npm install"
Error: Sandbox blocked command: npm install
Command not in allowedCommands.

# 或沙箱阻止网络
$ codex --full-auto "运行 curl http://api.example.com"
Error: Sandbox blocked network access
Network access is not allowed in sandbox mode.

# 或沙箱阻止读取
$ codex --full-auto "分析 .env 文件"
Error: Sandbox blocked read of .env
Sensitive file protected by sandbox.

这个问题在以下场景中特别常见：

• 目录不在 allowedDirectories
• 命令不在 allowedCommands
• 网络访问被禁止
• 敏感文件被保护
• 沙箱配置过于严格
• --full-auto 默认沙箱

2. 原因分析

原因分类表

原因分类	具体表现	占比
目录限制	不在 allowed	约 35%
命令限制	不在 allowed	约 25%
网络限制	禁止	约 20%
敏感文件	.env 保护	约 10%
配置严格	默认	约 5%
--full-auto	默认沙箱	约 5%

3. 解决方案

方案一：更新 allowedDirectories（最推荐）

# 步骤 1：检查沙箱配置
cat .codex/config.json | grep -A10 sandbox

# 步骤 2：添加目录
cat > .codex/config.json << 'EOF'
{
  "model": "o1",
  "sandbox": {
    "enabled": true,
    "autoApprove": true,
    "allowedDirectories": ["./src", "./tests", "./docs", "./config"]
  }
}
EOF

# 步骤 3：验证
codex --full-auto "修改 src/index.js" --max-turns 5

# 步骤 4：如果仍被阻止
codex --debug 2>&1 | grep -i "sandbox\|block"

方案二：配置 allowedCommands

# 步骤 1：允许特定命令
cat > .codex/config.json << 'EOF'
{
  "model": "o1",
  "sandbox": {
    "enabled": true,
    "autoApprove": true,
    "allowedDirectories": ["./src", "./tests"],
    "allowedCommands": ["npm", "node", "python3", "git", "ls", "cat"]
  }
}
EOF

# 步骤 2：验证
codex --full-auto "运行 npm install" --max-turns 5

# 步骤 3：如果命令仍被阻止
codex --debug 2>&1 | grep -i "command\|blocked"

# 步骤 4：验证
codex --print "echo hello" --max-turns 1

方案三：使用 --auto-approve 代替 --full-auto

# 步骤 1：--auto-approve 不启用沙箱
codex --auto-approve "修改 src/index.js" --max-turns 5

# 步骤 2：或使用 --print --auto-approve
codex --print --auto-approve "task" --max-turns 10

# 步骤 3：CI/CD 中
codex --print --auto-approve --no-stream "task" --max-turns 10

# 步骤 4：验证
codex --print --auto-approve "echo hello" --max-turns 1

方案四：禁用沙箱

# 步骤 1：在配置中禁用
cat > .codex/config.json << 'EOF'
{
  "model": "o1",
  "sandbox": {
    "enabled": false
  }
}
EOF

# 步骤 2：或命令行禁用
codex --no-sandbox --auto-approve "task" --max-turns 5

# 步骤 3：验证
codex --print --auto-approve "echo hello" --max-turns 1

# 步骤 4：注意安全
# 禁用沙箱后 CodeX 可以修改任何文件

方案五：允许网络访问

# 步骤 1：在配置中允许网络
cat > .codex/config.json << 'EOF'
{
  "model": "o1",
  "sandbox": {
    "enabled": true,
    "autoApprove": true,
    "allowedDirectories": ["./src"],
    "allowNetwork": true
  }
}
EOF

# 步骤 2：验证
codex --full-auto "运行 npm install" --max-turns 5

# 步骤 3：或禁用沙箱
codex --no-sandbox --auto-approve "task" --max-turns 5

# 步骤 4：验证
codex --print "echo hello" --max-turns 1

方案六：检查文件权限

# 步骤 1：检查文件权限
ls -la src/index.js

# 步骤 2：修复权限
chmod u+w src/index.js
sudo chown $(whoami) src/index.js

# 步骤 3：检查目录权限
ls -la src/
chmod -R u+rw src/

# 步骤 4：验证
codex --full-auto "修改 src/index.js" --max-turns 5

4. 各方案对比总结

方案	适用场景	推荐指数	难度
方案一：allowedDirectories	目录	⭐⭐⭐⭐⭐	低
方案二：allowedCommands	命令	⭐⭐⭐⭐⭐	低
方案三：--auto-approve	替代	⭐⭐⭐⭐⭐	低
方案四：禁用沙箱	全开放	⭐⭐⭐	低
方案五：允许网络	网络	⭐⭐⭐⭐	低
方案六：文件权限	EACCES	⭐⭐⭐⭐	低

5. 常见问题 FAQ

5.1 沙箱是什么

CodeX 的安全机制，限制可以修改的目录和执行的命令。

5.2 --full-auto 默认启用沙箱吗

是的。--full-auto 默认启用沙箱保护。

5.3 如何禁用沙箱

codex --no-sandbox --auto-approve "task"
# 或 config.json: {"sandbox": {"enabled": false}}

5.4 allowedDirectories 是什么

沙箱配置，指定 CodeX 可以读取/修改的目录列表。

5.5 allowedCommands 是什么

沙箱配置，指定 CodeX 可以执行的命令列表。

5.6 .env 被保护

在沙箱配置中排除 .env 保护，或使用 --no-sandbox。

5.7 网络被阻止

配置 "allowNetwork": true 或使用 --no-sandbox。

5.8 --auto-approve 和 --full-auto 的区别

• --auto-approve: 仅自动审批，不启用沙箱
• --full-auto: 全自动模式，启用沙箱

5.9 如何查看被阻止的操作

codex --debug 2>&1 | grep -i "block\|denied\|sandbox"

5.10 排查清单速查表

□ 1. cat config.json | grep sandbox 检查
□ 2. allowedDirectories 添加目录
□ 3. allowedCommands 添加命令
□ 4. --auto-approve 代替 --full-auto
□ 5. --no-sandbox 临时禁用
□ 6. allowNetwork: true 允许网络
□ 7. sandbox.enabled: false 禁用
□ 8. chmod u+w 修复文件权限
□ 9. sudo chown 修复所有者
□ 10. codex --debug | grep block 查看

6. 总结

1. 根本原因：沙箱阻止操作最常见原因是目录不在 allowedDirectories（35%）和命令不在 allowedCommands（25%）
2. 最佳实践 ：在 config.json 中配置 allowedDirectories 和 allowedCommands
3. --auto-approve ：使用 --auto-approve 代替 --full-auto（不启用沙箱）
4. 禁用沙箱 ：codex --no-sandbox --auto-approve "task" 或 "sandbox": {"enabled": false}
5. 最佳实践建议 ：配置 allowedDirectories: ["./src", "./tests"] 和 allowedCommands: ["npm", "node", "git"]

故障排查流程图

flowchart TD A[沙箱阻止操作] --> B{是目录问题?} B -->|是| C[添加到 allowedDirectories] B -->|否| D{是命令问题?} C --> E["./src ./tests ./docs"] E --> F[codex 验证] D -->|是| G[添加到 allowedCommands] D -->|否| H{是网络问题?} G --> I["npm node git python3"] I --> F H -->|是| j[allowNetwork: true] H -->|否| K[使用 --auto-approve] j --> F K --> L[codex --auto-approve "task"] L --> F F --> M{成功?} M -->|是| N[✅ 问题解决] M -->|否| O[使用 --no-sandbox] O --> P[codex --no-sandbox --auto-approve "task"] P --> Q{成功?} Q -->|是| N Q -->|否| R[检查文件权限] R --> S[chmod u+w] S --> T[sudo chown $(whoami)] T --> F F --> U{成功?} U -->|是| N U -->|否| V[禁用沙箱配置] V --> W[config.json: sandbox.enabled: false] W --> F N --> X[长期: allowedDirectories + allowedCommands] X --> Y[✅ 长期方案]