claude-sandbox-sdk 0.1.17

Claude Sandbox SDK — 管理 Claude Agent 沙盒服务的 CLI 工具

Claude Sandbox SDK

管理 Claude Agent 沙盒服务的 CLI 工具。

安装

pip install claude-sandbox-sdk

使用

启动服务

# 前台运行
claude-sandbox start

# 后台运行
claude-sandbox start --daemon

# 指定端口
claude-sandbox start --port 8300

# 指定地址和端口
claude-sandbox start --host 127.0.0.1 --port 8300

停止服务

claude-sandbox stop

# 强制终止
claude-sandbox stop --force

重启服务

claude-sandbox restart

# 重启并更换端口
claude-sandbox restart --port 8300

查看状态

claude-sandbox status

查看日志

# 查看最近 50 行
claude-sandbox logs

# 实时跟踪
claude-sandbox logs --follow

# 查看最近 100 行
claude-sandbox logs --lines 100

配置

配置优先级: CLI 参数 > 环境变量 > 默认值

配置项	环境变量	默认值
host	CLAUDE_SANDBOX_HOST	0.0.0.0
port	CLAUDE_SANDBOX_PORT	8200
log_level	CLAUDE_SANDBOX_LOG_LEVEL	INFO

数据目录

服务运行时数据存储在 ~/.claude-sandbox/:

• pid — 运行中的进程 PID
• port — 当前使用的端口
• server.log — 服务日志

开发

# 克隆仓库
git clone https://github.com/ai302/claude-sandbox-sdk.git
cd claude-sandbox-sdk

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

# 代码检查
ruff check .
mypy app/

发布

# 构建
python -m build

# 上传到 PyPI
twine upload dist/*

API 端点

端点	方法	说明
/health	GET	健康检查
/sessions	GET	列出会话
/sessions/{id}	GET	获取会话信息
/sessions/{id}/messages	GET	获取会话消息
/ws/chat	WebSocket	聊天接口

License

MIT