coderunner

为AI智能体提供本地沙箱环境,安全执行代码与操作。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:coderunner。
它的用途是:为AI智能体提供本地沙箱环境,安全执行代码与操作。
完整的 Skill 内容见:https://321skill.com/skills/coderunner/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我写一个Python脚本,爬取这个网页的标题并保存到文件。”,它会通过CodeRunner沙箱安全地执行爬虫脚本,并将结果文件保存在隔离的容器内,不会影响你的本地系统。或者,在Claude Code CLI中,你可以直接要求AI执行复杂的系统命令来调试环境,所有操作都被限制在沙箱中。

介绍

CodeRunner 是一个专为AI智能体设计的本地沙箱环境。它解决了在运行AI代理(如Claude Code)时,因代码执行可能带来的数据泄露、系统污染或安全风险等核心问题。

用户通过简单的安装脚本即可在本地(目前支持macOS Apple Silicon)快速部署一个隔离的容器环境。安装后,AI智能体(如通过MCP服务器集成的Claude Desktop,或Claude Code CLI插件)的所有代码执行、文件操作等行为都将被限制在这个沙箱内,与主机系统完全隔离。

这个工具非常适合智能体开发者、全栈开发者以及任何需要在本地安全地测试和运行AI生成代码或自动化脚本的用户。它让开发者能够放心地赋予AI更强的执行能力,而无需担心安全问题。

使用建议:在开始前请确保系统满足要求(macOS + Apple Silicon + Python 3.10+)。对于需要持久化的工作(如安装的包、创建的文件),使用container stopcontainer start来暂停和恢复沙箱,而非直接删除。

核心特点

与单纯提供代码执行环境的工具不同,CodeRunner通过容器技术提供了完整的系统级隔离,不仅能运行代码,还能安全地进行文件操作、安装依赖等,真正模拟了一个安全的开发环境。其与Claude生态(Claude Desktop, Claude Code CLI)的原生MCP集成,使得安全执行能力可以无缝嵌入到现有AI工作流中。

注意事项

目前仅支持macOS(Apple Silicon芯片)系统,暂不支持Windows和Linux。

常见问题

CodeRunner支持Windows吗?

目前不支持,仅支持macOS(Apple Silicon芯片,如M1/M2/M3/M4)。

如何彻底重置沙箱环境?

运行 `container delete coderunner && ./install.sh` 即可删除旧容器并重新安装一个全新的沙箱。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/coderunner/raw/index.md 读取 coderunner 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。