A simple, focused OpenAI-compatible API gateway for Claude Code with streaming support. Leverage the Claude Code SDK use mode. Don't hack the token credentials.

Use the Makefile to install the project or pip/uv.

# Clone and setup git clone https://github.com/codingworkflow/claude-code-api cd claude-code-api # Install dependencies & module make install # Start the API server make start

• There might be a limit on maximum input below normal "Sonnet 4" input as Claude Code usually doesn't ingest more than 25k tokens (despite the context being 100k).
• Claude Code auto-compacts context beyond 100k.
• Currently runs with bypass mode to avoid tool errors.
• Claude Code tools may need to be disabled to avoid overlap and background usage.
• Runs only on Linux/Mac as Claude Code doesn't run on Windows (you can use WSL).
• Note that Claude Code will default to accessing the current workspace environment/folder and is set to use bypass mode.

• Claude-Only Models: Supports exactly the 4 Claude models that Claude Code CLI offers
• OpenAI Compatible: Drop-in replacement for OpenAI API endpoints
• Streaming Support: Real-time streaming responses
• Simple & Clean: No over-engineering, focused implementation
• Claude Code Integration: Leverages Claude Code CLI with streaming output

• claude-opus-4-20250514 - Claude Opus 4 (Most powerful)
• claude-sonnet-4-20250514 - Claude Sonnet 4 (Latest Sonnet)
• claude-3-7-sonnet-20250219 - Claude Sonnet 3.7 (Advanced)
• claude-3-5-haiku-20241022 - Claude Haiku 3.5 (Fast & cost-effective)

• Python 3.10+
• Claude Code CLI installed and accessible
• Valid Anthropic API key configured in Claude Code (ensure it works in current directory src/)

# Clone and setup git clone https://github.com/codingworkflow/claude-code-api cd claude-code-api # Install dependencies make install # Run tests to verify setup make test # Start the API server make start-dev

The API will be available at:

• API: http://localhost:8000
• Docs: http://localhost:8000/docs
• Health: http://localhost:8000/health

make install # Install production dependencies make install-dev # Install development dependencies  make test # Run all tests make start # Start API server (production) make start-dev # Start API server (development with reload)

make test # Run all tests make test-fast # Run tests (skip slow ones) make test-hello # Test hello world with Haiku make test-health # Test health check only make test-models # Test models API only make test-chat # Test chat completions only make quick-test # Quick validation of core functionality

make dev-setup # Complete development setup make lint # Run linting checks make format # Format code with black/isort make type-check # Run type checking make clean # Clean up cache files

make help # Show all available commands make models # Show supported Claude models make info # Show project information make check-claude # Check if Claude Code CLI is available

curl -X POST http://localhost:8000/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{  "model": "claude-3-5-haiku-20241022",  "messages": [  {"role": "user", "content": "Hello!"}  ]  }'

curl http://localhost:8000/v1/models

curl -X POST http://localhost:8000/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{  "model": "claude-3-5-haiku-20241022",   "messages": [  {"role": "user", "content": "Tell me a joke"}  ],  "stream": true  }'

claude-code-api/ ├── claude_code_api/ │ ├── main.py # FastAPI application │ ├── api/ # API endpoints │ │ ├── chat.py # Chat completions │ │ ├── models.py # Models API │ │ ├── projects.py # Project management │ │ └── sessions.py # Session management │ ├── core/ # Core functionality │ │ ├── auth.py # Authentication │ │ ├── claude_manager.py # Claude Code integration │ │ ├── session_manager.py # Session management │ │ ├── config.py # Configuration │ │ └── database.py # Database layer │ ├── models/ # Data models │ │ ├── claude.py # Claude-specific models │ │ └── openai.py # OpenAI-compatible models │ ├── utils/ # Utilities │ │ ├── streaming.py # Streaming support │ │ └── parser.py # Output parsing │ └── tests/ # Test suite ├── Makefile # Development commands ├── pyproject.toml # Project configuration ├── setup.py # Package setup └── README.md # This file 

The test suite validates:

• Health check endpoints
• Models API (Claude models only)
• Chat completions with Haiku model
• Hello world functionality
• OpenAI compatibility (structure)
• Error handling

Run specific test suites:

make test-hello # Test hello world with Haiku make test-models # Test models API make test-chat # Test chat completions

make dev-setup

make format # Format code make lint # Check linting make type-check # Type checking

make quick-test # Test core functionality

make deploy-check

make start-prod # Start with multiple workers

Use http://127.0.0.1:8000/v1 as OpenAPI endpoint

Key settings in claude_code_api/core/config.py:

• claude_binary_path: Path to Claude Code CLI
• project_root: Root directory for projects
• database_url: Database connection string
• require_auth: Enable/disable authentication

1. Simple & Focused: No over-engineering
2. Claude-Only: Pure Claude gateway, no OpenAI models
3. Streaming First: Built for real-time streaming
4. OpenAI Compatible: Drop-in API compatibility
5. Test-Driven: Comprehensive test coverage

curl http://localhost:8000/health

Response:

{ "status": "healthy", "version": "1.0.0", "claude_version": "1.x.x", "active_sessions": 0 }

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.