如何在 5 分钟内搭建 CodeRunner 沙箱环境：面向初学者的完整指南

【免费下载链接】coderunnerA local sandbox for your AI agents项目地址: https://gitcode.com/gh_mirrors/coderu/coderunner

CodeRunner 是一款功能强大的本地沙箱工具，专为 AI 代理提供安全的代码执行环境。本指南将帮助你在短短 5 分钟内完成环境搭建，即使你是技术新手也能轻松上手。

📌 准备工作：你需要这些基础条件

在开始前，请确保你的系统满足以下要求：

• 安装了 Git（用于克隆仓库）
• 安装了 Docker 和 Docker Compose（用于容器化部署）
• 稳定的网络连接（用于下载必要资源）

如果你还没有安装 Docker，可以参考 Docker 官方文档 完成安装。

图：CodeRunner 沙箱环境的核心架构展示，包含多个功能模块

⚡ 快速安装：3 个简单步骤

步骤 1：克隆项目仓库

打开终端，执行以下命令克隆 CodeRunner 项目：

git clone https://gitcode.com/gh_mirrors/coderu/coderunner cd coderunner

步骤 2：配置环境

项目提供了便捷的安装脚本，执行以下命令即可完成基础配置：

chmod +x install.sh ./install.sh

该脚本会自动安装所需的依赖包（详见 requirements.txt），并生成默认配置文件。

步骤 3：启动沙箱环境

使用 Docker Compose 快速启动整个环境：

docker-compose up -d

等待几分钟，当终端显示所有服务都已成功启动后，你的 CodeRunner 沙箱环境就准备好了！

🚀 开始使用：运行你的第一个代码

打开浏览器，访问http://localhost:8080即可进入 CodeRunner 界面。让我们尝试运行一个简单的 Python 代码：

1. 在输入框中输入：print('Hello, CodeRunner!')
2. 点击"运行"按钮
3. 你将在下方看到输出结果

图：在 CodeRunner 中执行 Python 代码的实时界面

💡 进阶技巧：解锁更多功能

探索示例项目

项目提供了多个示例，帮助你快速了解不同场景下的使用方法：

• Claude 桌面代理示例
• Gemini CLI 集成示例
• OpenAI 代理示例

使用技能插件

CodeRunner 支持多种实用技能插件，例如：

• 图片裁剪旋转工具
• PDF 文本替换工具

图：使用 CodeRunner 处理视频文件的示例界面

❓ 常见问题解决

如果启动过程中遇到问题，可以尝试以下方法：

1. 检查 Docker 是否正常运行：docker info
2. 查看服务日志：docker-compose logs
3. 重新执行安装脚本：./cleanup.sh && ./install.sh

更多详细的故障排除指南，请参考 INCIDENT_RESPONSE.md。

🎯 总结

通过本指南，你已经成功搭建了 CodeRunner 沙箱环境，并了解了基本使用方法。这个强大的工具可以为你的 AI 代理提供安全、隔离的代码执行环境，无论是学习、开发还是测试，都能满足你的需求。

现在就开始探索 CodeRunner 的更多功能吧！如有任何问题，欢迎查阅 官方文档 或参与 贡献者讨论。

【免费下载链接】coderunnerA local sandbox for your AI agents项目地址: https://gitcode.com/gh_mirrors/coderu/coderunner