v2.3.0 - Live Model Discovery & Dynamic Default Sonnet

New Features (PR #46)

• Live /v1/models discovery from Anthropic's Models API when ANTHROPIC_API_KEY is set, cached for 1 hour with thundering-herd protection and a short retry TTL on failure.
• Dynamic default model resolution — DEFAULT_MODEL resolves to the latest Sonnet at startup when ANTHROPIC_API_KEY is configured; falls back to claude-sonnet-4-6 otherwise.
• New env vars: CLAUDE_MODELS_OVERRIDE, FAST_MODEL, MODEL_LIST_CACHE_TTL_SECONDS, MODEL_LIST_ERROR_TTL_SECONDS, MODEL_LIST_REQUEST_TIMEOUT_SECONDS.
• created field (unix timestamp) populated on /v1/models entries to match OpenAI's model object schema.
• Claude 4.6 family added to the static fallback list.

Compatibility

ANTHROPIC_API_KEY remains optional. Bedrock, Vertex, and Claude CLI subscription auth continue to work — /v1/models returns the static fallback list and claude-sonnet-4-6 is used as the default.

Upgrading

git pull origin main
poetry install

No breaking changes. New behavior activates automatically when ANTHROPIC_API_KEY is present.

v2.2.0

What's New in v2.2.0

New Features

• Interactive Landing Page - API explorer at root URL (http://localhost:8000/) with live endpoint testing, light/dark theme toggle, and copy-to-clipboard
• Anthropic Messages API - Native /v1/messages endpoint for Anthropic API compatibility alongside OpenAI format
• Explicit Auth Selection - New CLAUDE_AUTH_METHOD env var (cli, api_key, bedrock, vertex) to prevent auth conflicts
• Tool Execution Fix - enable_tools: true now properly enables Claude Code tools
• Version Endpoint - New /version endpoint returns API version

Documentation

• Condensed Docker documentation for easier reading
• Updated Features and API Endpoints sections with new capabilities
• Cleaned up roadmap section

Contributors

Special thanks to @aaronlippold for the significant contributions in #31!

Full Changelog: v2.1.0...v2.2.0

v2.1.0 - SDK Upgrade & Simplified Setup

What's New in v2.1.0

🚀 SDK Upgrade

• Upgraded claude-agent-sdk from v0.1.6 to v0.1.18
• Access to latest SDK features: rate limit detection, file checkpointing, better concurrency handling

📦 Simplified Setup

• No more Node.js required! Claude Code CLI is now bundled with the SDK
• Fewer prerequisites for new users
• Smaller Docker image (removed Node.js/npm dependencies)

🐳 Docker Improvements

• Leaner Dockerfile without Node.js layer
• Faster builds and smaller image size

Upgrading

git pull origin main
poetry install
# Restart your server - that's it!

Full Changelog
	∙	feat: Upgrade claude-agent-sdk from 0.1.6 to 0.1.18
	∙	docs: Simplify setup with bundled CLI from SDK 0.1.18
	∙	chore: Bump version to 2.1.0

Full Changelog: https://github.com/RichardAtCT/claude-code-openai-wrapper/compare/v2.0.0…v2.1.0

v2.0.0 - Claude Agent SDK Migration & Model Updates

v2.0.0 - Major Update: Claude Agent SDK Migration 🚀

🎉 What's New

This is a major version update migrating from the deprecated claude-code-sdk to the modern claude-agent-sdk v0.1.6, along with a comprehensive update to the latest Claude models.

⚡ Major Changes

🔧 Claude Agent SDK Migration

• Migrated from deprecated claude-code-sdk (v0.0.14) to claude-agent-sdk (v0.1.6)
• No breaking changes for API consumers - full OpenAI API compatibility maintained
• Better performance with modern SDK features and improvements
• Enhanced authentication support and error handling

🤖 Updated Model List

Added support for the latest Claude 4.5 family and all current models:

New Models:

• ⭐ claude-sonnet-4-5-20250929 - Recommended (best coding model, superior reasoning)
• ⚡ claude-haiku-4-5-20251001 - Fast & Cheap (similar to Sonnet 4 at 1/3 cost)
• claude-opus-4-1-20250805 - Upgraded Opus 4 with improved reasoning

All Supported Models (8 total):

• claude-sonnet-4-5-20250929
• claude-haiku-4-5-20251001
• claude-opus-4-1-20250805
• claude-opus-4-20250514
• claude-sonnet-4-20250514
• claude-3-7-sonnet-20250219
• claude-3-5-sonnet-20241022
• claude-3-5-haiku-20241022

📋 Requirements Update

Important: Claude Code CLI 2.0.0+ now required (was: any version)

# Upgrade Claude Code CLI
npm install -g @anthropic-ai/claude-code

# Verify version
claude --version  # Should be 2.0.0+

🔄 Upgrading from v1.x

Simple 4-step upgrade process:

# 1. Update Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 2. Pull latest code
git pull origin main

# 3. Update dependencies
poetry install

# 4. Restart server
poetry run uvicorn main:app --reload --port 8000

That's it! No configuration changes needed.
📚 Documentation Updates

Complete README refresh with v2.0.0 details
All examples updated to use latest models
New migration guides:
    [MIGRATION_STATUS.md](https://claude.ai/code/MIGRATION_STATUS.md) - Detailed migration status
    [UPGRADE_PLAN.md](https://claude.ai/code/UPGRADE_PLAN.md) - Comprehensive technical guide

✅ What's Working

All existing features continue to work:

✅ OpenAI API compatibility (chat completions, streaming)
✅ Multi-provider authentication (API key, Bedrock, Vertex, CLI)
✅ Session continuity and management
✅ Real-time cost and token tracking
✅ Tool usage (optional, disabled by default)
✅ All endpoints (health, models, auth status, sessions)

🐛 Bug Fixes

Fixed f-string syntax error in main.py
Improved error handling and logging
Updated SDK references throughout codebase

📖 Full Changelog

See all commits: v1.0.0...v2.0.0
🙏 Acknowledgments

Special thanks to Anthropic for releasing the Claude Agent SDK and the amazing Claude 4.5 models!

Questions or Issues?

📖 Read the Docs
🐛 Report Issues
💬 Discussions