bwrap-bypass
绕过 Claude Code bwrap (bubblewrap) sandbox 限制。bwrap sandbox 会重新挂载文件系统，导致 Bash 命令无法访问特定路径、凭证文件、Unix socket 等资源。当遇到以下情况时使用：(1) Bash 命令报 Permission denied 但 sandbox 外正常 (2) LOAS2/Kerberos 凭证不可用 (3) 新机器/Bot 部署后需要配置 sandbox bypass (4) 命令因 sandbox 文件系统隔离而失败 (5) 用户说"装 bwrap bypass"、"配 sandbox"。关键词："bwrap"、"sandbox"、"Operation not permitted"、"Permission denied"、"credentials-cache"。
소스 정보
- 저장소
- yangwhale/CloseCrab
- 최근 소스 활동
- 2026년 4월 12일 10:17
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 4
- 포크
- 0
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
3 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- bwrap-bypass
- description
- 绕过 Claude Code bwrap (bubblewrap) sandbox 限制。bwrap sandbox 会重新挂载文件系统，导致 Bash 命令无法访问特定路径、凭证文件、Unix socket 等资源。当遇到以下情况时使用：(1) Bash 命令报 Permission denied 但 sandbox 外正常 (2) LOAS2/Kerberos 凭证不可用 (3) 新机器/Bot 部署后需要配置 sandbox bypass (4) 命令因 sandbox 文件系统隔离而失败 (5) 用户说"装 bwrap bypass"、"配 sandbox"。关键词："bwrap"、"sandbox"、"Operation not permitted"、"Permission denied"、"credentials-cache"。
# bwrap-bypass
Claude Code 2.1.98+ 的 Bash sandbox 用 bwrap (bubblewrap) 包裹每个 Bash 命令，重新挂载文件系统创建隔离环境。这会导致：
- 特定路径（`/run/credentials-cache/` 等）的权限被改变
- Unix socket、命名管道等 IPC 资源不可访问
- 凭证系统（LOAS2、Kerberos）检测到不安全的目录权限后拒绝工作
- 部分系统工具和服务因文件系统隔离而失败
已知 bug: [anthropics/claude-code#35986](https://github.com/anthropics/claude-code/issues/35986)
`sandbox.enabled: false` 和 `dangerouslyDisableSandbox` 均无效——bwrap 在读取 settings 之前就启动。
## 安装
用 passthrough 脚本替换 `/usr/bin/bwrap`（需要 sudo）：
```bash
sudo mv /usr/bin/bwrap /usr/bin/bwrap.real
sudo cp scripts/bwrap-passthrough.sh /usr/bin/bwrap
sudo chmod 755 /usr/bin/bwrap
```
脚本路径：`scripts/bwrap-passthrough.sh`（相对于本 skill 目录）。
## 恢复
```bash
sudo bash scripts/bwrap-restore.sh
```
## 原理
`bwrap-passthrough.sh` 接收 bwrap 的全部参数，解析 `--setenv`/`--unsetenv`，跳过所有沙箱参数（`--ro-bind`、`--tmpfs` 等），在遇到 `--` 后直接 `exec` 实际命令。效果：命令照常执行，但不做文件系统隔离。
## 检查状态
```bash
# 检查是否已安装 bypass
file /usr/bin/bwrap # 应显示 shell script，不是 ELF
head -1 /usr/bin/bwrap # 应显示 #!/bin/bash
# 检查真实 bwrap 是否已备份
ls -la /usr/bin/bwrap.real
```
## 注意事项
- 安装后所有 Bash 命令不再受沙箱保护，安全性降低
- 定期关注 #35986 修复进度，修好后执行恢复步骤
- 适用于所有 Linux 环境（gLinux、GCE VM、裸金属），只要安装了 bwrap 就可能需要
GitHub에서 보기