SDK Update 2026-02-24

SDK Versions

Package	Version
@anthropic-ai/claude-code (CLI)	2.1.55
@anthropic-ai/claude-agent-sdk (TS SDK)	0.2.55
claude-agent-sdk (Python SDK)	0.1.42

Docker Images

Pull the latest:

docker pull ghcr.io/cabinlab/claude-code-sdk-docker:typescript
docker pull ghcr.io/cabinlab/claude-code-sdk-docker:python
docker pull ghcr.io/cabinlab/claude-code-sdk-docker:alpine
docker pull ghcr.io/cabinlab/claude-code-sdk-docker:alpine-python

v0.3.1: Alpine tsx fix & variant test suite

Fixed

• Alpine images: tsx failed at runtime due to missing esbuild dependency (cherry-picked binaries instead of copying full /usr/local/bin/)

Added

• scripts/test-variants.sh - Repeatable test suite that builds and validates all 4 Docker image variants

v0.3.0: Migrate to Claude Agent SDK

Breaking Changes

• Migrated from Claude Code SDK to Claude Agent SDK
  • npm: @anthropic-ai/claude-code → @anthropic-ai/claude-agent-sdk
  • pip: claude-code-sdk → claude-agent-sdk
  • Python imports: claude_code_sdk → claude_agent_sdk
  • ClaudeCodeOptions → ClaudeAgentOptions

Changed

• Updated all Dockerfiles, examples, tests, and CI/CD workflows
• Updated versions.json schema for new package names

Full Changelog

v0.2.2...v0.3.0

v0.2.2: Automated Version Updates

What's Changed

🚀 Automated Version Update System

• Daily checks for new Claude Code CLI and Python SDK releases
• Automatic PR creation when updates are detected
• Auto-merge capability after tests pass
• Manual trigger available via GitHub Actions

📦 Updated SDK Versions

• Claude Code CLI: v1.0.64
• Python SDK: v0.0.17

📝 Other Changes

• Added version tracking in versions.json
• Enhanced documentation with automatic update information
• Version comments added to all Dockerfiles

Full Changelog

v0.2.1...v0.2.2

v0.2.1: Subagent Support

🤖 Subagent Scaffolding

Added directory with three example subagent configurations from the official Claude Code documentation:

• code-reviewer: Code review specialist
• debugger: Debugging specialist
• data-scientist: Data analysis expert

These provide starting points for users who want to experiment with Claude Code's new subagent feature.

v0.2.0: Alpine Images & Size Optimizations

🏔️ Alpine Linux Support & Major Size Reductions

New Alpine Variants

• Alpine TypeScript (383MB) - 47% smaller than Debian
• Alpine Python (474MB) - 32% smaller than Debian

Size Optimizations

• Debian TypeScript: 727MB → 607MB (16% reduction)
• Debian Python: 813MB → 693MB (15% reduction)

Improvements

• Binary cleanup removes unused platform-specific files
• Intelligent conditional CI builds to optimize build times
• Multi-stage Docker builds for all variants
• Fixed Alpine permissions and authentication handling

Available Images

• ghcr.io/cabinlab/claude-code-sdk-docker:typescript (607MB)
• ghcr.io/cabinlab/claude-code-sdk-docker:python (693MB)
• ghcr.io/cabinlab/claude-code-sdk-docker:alpine (383MB)
• ghcr.io/cabinlab/claude-code-sdk-docker:alpine-python (474MB)

All containers maintain full Claude Code SDK functionality with long-lived OAuth token support.

v0.1.0 - Initial Release

Claude Code SDK Docker Containers

First public release of Docker containers for the Claude Code SDK.

🎯 Key Features

• TypeScript Container (727MB) - Includes Claude Code CLI + JavaScript/TypeScript SDK
• Python Container (813MB) - Extends TypeScript base with Python SDK support
• Long-lived OAuth Token Support - Solves authentication challenges for Pro and Max subscriptions in containerized environments
• Optimized Images - Multi-stage builds for minimal runtime footprint

📦 Images Available

• ghcr.io/cabinlab/claude-code-sdk:0.1.0
• ghcr.io/cabinlab/claude-code-sdk:typescript
• ghcr.io/cabinlab/claude-code-sdk:python

🚀 Quick Start

# Get OAuth token
claude setup-token

# Run TypeScript container
docker run -it -e CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here \
  ghcr.io/cabinlab/claude-code-sdk:typescript bash

# Or use Docker Compose
#### Typescript
export CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here
docker compose up -d

#### Python
export CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here
docker compose -f compose-python.yaml up -d

📝 Known Limitations

• API key authentication not fully tested

See README for full documentation.