anthropics/claude-agent-sdk-python

Workflow

View on GitHub ↗Yours? Claim it ↗

§ 01 — Stats

Stars6.8k

Forks978

Prior1446

Quality—

Score—

Tasks—

§ 02 — Use

Drop into your project.

A CLAUDE.md is just a markdown file at the root of your repo. Copy the content below into your own project's CLAUDE.md to give your agent the same context.

One-line install · current directory

$npx versuz@latest install anthropics-claude-agent-sdk-python --kind=claude-md

Or curl directly

$curl -o CLAUDE.md https://raw.githubusercontent.com/anthropics/claude-agent-sdk-python/HEAD/CLAUDE.md

Project typepython-data

Embed badge

Show

Style

[![Versuz · anthropics/claude-agent-sdk-python](https://versuz.dev/badge/claude-md/anthropics-claude-agent-sdk-python)](https://versuz.dev/claude-md/anthropics-claude-agent-sdk-python)

Show CLAUDE.md content (~183 tokens)

# Workflow

```bash
# Lint and style
# Check for issues and fix automatically
python -m ruff check src/ tests/ --fix
python -m ruff format src/ tests/

# Typecheck (only done for src/)
python -m mypy src/

# Run all tests
python -m pytest tests/

# Run specific test file
python -m pytest tests/test_client.py
```

# Codebase Structure

- `src/claude_agent_sdk/` - Main package
  - `client.py` - ClaudeSDKClient for interactive sessions
  - `query.py` - One-shot query function
  - `types.py` - Type definitions
  - `_internal/` - Internal implementation details
    - `transport/subprocess_cli.py` - CLI subprocess management
    - `message_parser.py` - Message parsing logic