sbx/claude是基于Docker沙箱规范的Anthropic Claude Code终端编码代理镜像,通过沙箱代理自动处理API密钥与订阅认证,无需额外手动配置权限即可直接使用AI代码辅助功能。
6 次收藏下载次数: 0状态:社区镜像维护者:sbx仓库类型:镜像最近更新:
镜像概述
sbx/claude是遵循Docker实验性Sandbox Kit v3规范的独立工作负载套件,内置Anthropic官方的Claude Code终端AI编码代理,作为此前sbx run claude内置代理的替代实现,无需复杂配置即可运行在隔离沙箱环境中。镜像内置权限跳过机制避免无人值守时的审批死锁,同时默认关闭遥测上报保障使用隐私,支持API密钥与Claude订阅两种认证方式,通过代理动态注入凭证,容器侧不会留存可用的明文密钥。
核心功能
- 开箱即用的编码代理:以
claude --dangerously-skip-permissions作为入口点,自动绕过重复的权限审批提示,适配无交互沙箱运行场景 - 双模式自动认证:沙箱代理可自动适配Anthropic控制台API密钥或Claude订阅凭证,无需在容器内明文存储敏感密钥
- 会话状态持久化:自动映射5个核心工作目录为块存储卷,容器重建后历史对话、会话状态、任务记录不会丢失
- 默认隐私保护:默认禁用使用行为遥测与崩溃上报,仅保留必要的自更新能力
- 细粒度网络管控:内置v3版本网络策略,仅开放代理运行必需的域名,默认拦截非必要的对外连接出口
使用场景
- 本地开发环境中快速调用Claude Code完成代码生成、仓库总结、Debug辅助等终端交互任务
- CI/CD流水线中以非交互模式运行AI编码校验、代码评审自动化流程
- 自定义隔离沙箱中扩展AI代码辅助能力,搭配code-server等工具构建带AI加持的云端开发环境
- 本地部署场景下对接私有模型运行器,将Claude Code代理路由到本地Ollama等私有推理服务
配置说明
前置配置(可选)
如需通过沙箱代理自动处理Anthropic认证,需提前在宿主机绑定名为anthropic的密钥:
consolesbx secret set anthropic
未配置密钥时,也可进入容器内执行Claude Code原生的/login命令手动完成登录。
运行方式
注意:当前版本sbx工具仍内置claude代理,运行前请确认已升级到移除内置代理的版本,否则会提示"agent 'claude' is already registered"错误。
直接运行官方镜像
consolesbx run "docker.io/sbx/claude:latest"
通过Git源码直接运行
consolesbx run "git+https://github.com/docker/sbx-kits-contrib.git#dir=claude"
本地源码克隆后运行
consolesbx run ./claude/
自定义参数传递
入口点默认拼接为claude --dangerously-skip-permissions,后续追加的所有参数会直接透传给Claude Code原生CLI,例如非交互模式直接生成仓库摘要:
consolesbx run claude -- -p "summarise this repo"
如需禁用代理自更新能力,可在运行时传入环境变量:
consolesbx run -e DISABLE_AUTOUPDATER=1 claude
扩展组合
该镜像支持与6款预定义的mixins套件无缝组合,按需叠加功能:
claude-mem:跨会话持久化AI记忆code-server:搭载Claude Code扩展的Web版VS Code开发环境claude-acp:基于stdio的Claude ACP适配器ecc:"全功能Claude Code"内容能力包claude-model-runner:将请求路由到本地Docker Model Runner私有推理服务claude-mixin:将Claude Code能力作为功能层叠加到你自定义的沙箱环境中
sbx 命名空间的其他可用镜像:
sbx/opencode
Opencode 容器镜像,适合 sbx 维护的 Opencode 工作负载部署
sbx/hermes-agent-image
Hermes Agent Image 容器镜像,适合 sbx 维护的 Hermes Agent Image 工作负载部署
sbx/pi-image
Pi Image 容器镜像,适合 sbx 维护的 Pi Image 工作负载部署
sbx/shell
Shell 容器镜像,适合 sbx 维护的 Shell 工作负载部署
sbx/claude-ollama
Claude Ollama 容器镜像,适合 sbx 维护的 Claude Ollama 工作负载部署
sbx/playwright
Playwright 容器镜像,适合 sbx 维护的 Playwright 工作负载部署
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull sbx/claude:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务