Pre-release
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_sandbox_sdk-0.1.27b3.tar.gz.
File metadata
- Download URL: claude_sandbox_sdk-0.1.27b3.tar.gz
- Upload date:
- Size: 63.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
11de2e3d00efcb4fe7d26b81b89ad4421ed935ba91d32be547eccdc440125976
|
|
| MD5 |
5bd1d86c0fbbbb0d856f3bc3c2935a02
|
|
| BLAKE2b-256 |
d8ba9478aee8de882cf5c8421325e7000bad4491853702a3bb5d1bb71146c6bb
|
File details
Details for the file claude_sandbox_sdk-0.1.27b3-py3-none-any.whl.
File metadata
- Download URL: claude_sandbox_sdk-0.1.27b3-py3-none-any.whl
- Upload date:
- Size: 74.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
08362004eb9bb1f559a38ef1fe8af248cc093a5bb4ee01a29d114cf282863960
|
|
| MD5 |
a0d1f9a6c7ae29f5675acee8f33d6cf6
|
|
| BLAKE2b-256 |
225d11ac439e09745f6fb4b9f6919b79301d027cb9cd0306a099fae85f460e9f
|
