Metadata-Version: 2.4
Name: claude-sandbox-sdk
Version: 0.1.5
Summary: Claude Sandbox SDK — 管理 Claude Agent 沙盒服务的 CLI 工具
Project-URL: Homepage, https://github.com/ai302/claude-sandbox-sdk
Project-URL: Repository, https://github.com/ai302/claude-sandbox-sdk
Project-URL: Issues, https://github.com/ai302/claude-sandbox-sdk/issues
Author: AI302
License: MIT
License-File: LICENSE
Keywords: agent,claude,sandbox,sdk,websocket
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: claude-agent-sdk>=0.2.91
Requires-Dist: fastapi>=0.100.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.0
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: uvicorn[standard]>=0.23.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# Claude Sandbox SDK

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

## 安装

```bash
pip install claude-sandbox-sdk
```

## 使用

### 启动服务

```bash
# 前台运行
claude-sandbox start

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

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

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

### 停止服务

```bash
claude-sandbox stop

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

### 重启服务

```bash
claude-sandbox restart

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

### 查看状态

```bash
claude-sandbox status
```

### 查看日志

```bash
# 查看最近 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` — 服务日志

## 开发

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

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

# 运行测试
pytest

# 代码检查
ruff check .
mypy app/
```

## 发布

```bash
# 构建
python -m build

# 上传到 PyPI
twine upload dist/*
```

## API 端点

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

## License

MIT
