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.30b16
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 | |
|---|---|---|---|---|
| claude_sandbox_sdk-0.1.30b16.tar.gz | 95.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_sandbox_sdk-0.1.30b16-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 202.2 kB
Release files / claude_sandbox_sdk-0.1.30b16.tar.gz
| Download URL | claude_sandbox_sdk-0.1.30b16.tar.gz |
|---|---|
| Size | 95.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb45da9d9b6a7af7296d1ab16fa8da65ca33dbbbb0235ee3e3039206ddb7d5c1
|
|
BLAKE2b-256 checksum How to use checksums |
f02ef72b1184f158116f65f5eb572ed64dab63e4d6edd0bbd417f6f43110c468
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / claude_sandbox_sdk-0.1.30b16-py3-none-any.whl
| Download URL | claude_sandbox_sdk-0.1.30b16-py3-none-any.whl |
|---|---|
| Size | 107.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ddcc5ceee432403e4a2f0426d6e4fc37a7e0636088ae16a084c1af5a6243daad
|
|
BLAKE2b-256 checksum How to use checksums |
c53f866e385add7c46c13da3b42b8466eca0e57d5aa76bb3fcd00159420e099f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Security for claude-sandbox-sdk 0.1.30b16
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.
