This release is a pre-release and may not be stable for production use.
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— 运行中的进程 PIDport— 当前使用的端口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
1 maintainer
Metadata
1 maintainer
Release files for claude-sandbox-sdk 0.1.30b31
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| claude_sandbox_sdk-0.1.30b31.tar.gz | 100.9 kB | Without provenance | Details for claude_sandbox_sdk-0.1.30b31.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| claude_sandbox_sdk-0.1.30b31-py3-none-any.whl | Python 3 | none | any | Details for claude_sandbox_sdk-0.1.30b31-py3-none-any.whl |
Total release size: 208.8 kB
Release files / claude_sandbox_sdk-0.1.30b31.tar.gz
| Download URL | claude_sandbox_sdk-0.1.30b31.tar.gz |
|---|---|
| Size | 100.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
adb04f0526db74c03863d80b2714ae2d49f76d9a2de9d161be83a48d378f40f4
|
|
BLAKE2b-256 checksum How to use checksums |
7e4b9d6a0e5caa103694b770ba4c433a9abbb5e66e9dc33940447f9abbba1ee6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / claude_sandbox_sdk-0.1.30b31-py3-none-any.whl
| Download URL | claude_sandbox_sdk-0.1.30b31-py3-none-any.whl |
|---|---|
| Size | 107.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
625b59ef2578fe347994cd124c4e46ca31954ce20163c4eb83763e739eacb46f
|
|
BLAKE2b-256 checksum How to use checksums |
e2f7fa35e56b37e3859b46a24d24ad123c951b799c91abbdaea1316949a4ffa8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for claude-sandbox-sdk 0.1.30b31
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
