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.30b14
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.30b14.tar.gz | 110.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_sandbox_sdk-0.1.30b14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 219.7 kB
Release files / claude_sandbox_sdk-0.1.30b14.tar.gz
| Download URL | claude_sandbox_sdk-0.1.30b14.tar.gz |
|---|---|
| Size | 110.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7f6a95972f7bc2a60e988a0caeb36489ff144c693108a4e51ccefd7135f3c226
|
|
BLAKE2b-256 checksum How to use checksums |
a17518816e0d8f4d23964e569d9fe12a6324e7fb60b8fc783072a08ec5e3236a
|
| 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.30b14-py3-none-any.whl
| Download URL | claude_sandbox_sdk-0.1.30b14-py3-none-any.whl |
|---|---|
| Size | 108.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7546b8a8a293b49ef93861ddf72b0cb3297421ce63755146a2321229a353daa8
|
|
BLAKE2b-256 checksum How to use checksums |
3282c6ca20a4bda3e689cc1e6332aa809e69cf35b8282b94e65c7e3bfc03e11a
|
| 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.30b14
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.
