Refactoring tests

Author: Mehdi-Bl

README.md

@@ -1,277 +1,102 @@
 # Claude Code API Gateway
 
-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.
+OpenAI-compatible API gateway for Claude Code CLI.
 
-## Getting Started
+## What You Get
 
-Use the Makefile to install the project or pip/uv.
+- OpenAI-style endpoints (`/v1/chat/completions`, `/v1/models`, sessions/projects APIs)
+- Streaming and non-streaming chat completions
+- Claude model aliases and fallback behavior
+- Optional `model` field: if omitted, CLI default model is used
 
-![API Started](assets/api.png)
+## Quick Start (Linux/macOS)
 
-![Cline use](assets/cline.png)
-
-![Cursor](assets/cursor.png)
-
-![OpenWebUI](assets/openwebui.png)
-
-![Roo Code config](assets/roocode.png)
-
-![Roo Code chat](assets/roo_code.png) 
-
-### Python Implementation
 ```bash
-# 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 install
 make start
 ```
 
-## Limitations
-
-- 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.
-
-
-## Features
-
-- **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
-
-## Supported Models
-
-Model definitions live in `claude_code_api/config/models.json`.
-Override with `CLAUDE_CODE_API_MODELS_PATH` to point at a custom JSON file.
-
-- `claude-opus-4-5-20250929` - Claude Opus 4.5 (Most powerful)
-- `claude-sonnet-4-5-20250929` - Claude Sonnet 4.5 (Latest Sonnet)
-- `claude-haiku-4-5-20250929` - Claude Haiku 4.5 (Fast & cost-effective)
-
-## Quick Start
+Server URLs:
+- API: `http://localhost:8000`
+- OpenAPI docs: `http://localhost:8000/docs`
+- Health: `http://localhost:8000/health`
 
-### Prerequisites
-- Python 3.10+
-- Claude Code CLI installed and accessible
-- Valid Anthropic API key configured in Claude Code (ensure it works in current directory src/)
+## Quick Start (Windows)
 
-### Installation & Setup
+Use the provided wrappers:
 
-```bash
-# 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
+```bat
+make.bat install
+start.bat
 ```
 
-The API will be available at:
-- **API**: http://localhost:8000
-- **Docs**: http://localhost:8000/docs  
-- **Health**: http://localhost:8000/health
+Notes:
+- `start.bat` starts the API in dev mode.
+- `make.bat` provides common project commands.
+- Claude Code CLI support on Windows may require WSL depending on your local setup.
 
-## Makefile Commands
-
-### Core Commands
-```bash
-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)
-```
+## Supported Models
 
-### Testing
-```bash
-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
-```
+Model config is in `claude_code_api/config/models.json`.
+Override with `CLAUDE_CODE_API_MODELS_PATH`.
 
-### Development
-```bash
-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
-```
+- `claude-opus-4-6-20260205`
+- `claude-opus-4-5-20251101`
+- `claude-sonnet-4-5-20250929`
+- `claude-haiku-4-5-20251001`
 
-### Information
-```bash
-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
-```
+Alias/fallback behavior:
+- `model` is optional in `/v1/chat/completions`.
+- `opus`, `claude-opus-latest`, `claude-opus-4-6` resolve to Opus 4.6.
+- If Opus 4.6 is rejected at runtime, gateway retries once with latest configured Opus 4.5.
+- If all attempted models are rejected, API returns `400` with `error.code = model_not_supported`.
 
 ## API Usage
 
-### Chat Completions
+Chat completion:
 
 ```bash
 curl -X POST http://localhost:8000/v1/chat/completions \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "claude-sonnet-4-5-20250929",
     "messages": [
-      {"role": "user", "content": "Hello!"}
+      {"role": "user", "content": "Hello"}
     ]
   }'
 ```
 
-### List Models
+List models:
 
 ```bash
 curl http://localhost:8000/v1/models
 ```
 
-### Streaming Chat
+Streaming:
 
 ```bash
 curl -X POST http://localhost:8000/v1/chat/completions \
   -H "Content-Type: application/json" \
   -d '{
     "model": "claude-sonnet-4-5-20250929",
-    "messages": [
-      {"role": "user", "content": "Tell me a joke"}
-    ],
+    "messages": [{"role": "user", "content": "Tell me a joke"}],
     "stream": true
   }'
 ```
 
-## Project Structure
-
-```
-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
-```
-
-## Testing
-
-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:
-```bash
-make test-hello    # Test hello world with Haiku
-make test-models   # Test models API
-make test-chat     # Test chat completions
-```
-
-## Development
-
-### Setup Development Environment
-```bash
-make dev-setup
-```
-
-### Code Quality
-```bash
-make format        # Format code
-make lint          # Check linting
-make type-check    # Type checking
-```
-
-### Quick Validation
-```bash
-make quick-test    # Test core functionality
-```
-
-## Deployment
-
-### Check Deployment Readiness
-```bash
-make deploy-check
-```
-
-### Production Server
-```bash
-make start-prod    # Start with multiple workers
-```
-Use http://127.0.0.1:8000/v1 as OpenAPI endpoint
-
 ## Configuration
 
-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
-
-## Design Principles
-
-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
+Common settings are in `claude_code_api/core/config.py`:
+- `claude_binary_path`
+- `project_root`
+- `database_url`
+- `require_auth`
 
-## Health Check
+## Developer Docs
 
-```bash
-curl http://localhost:8000/health
-```
-
-Response:
-```json
-{
-  "status": "healthy",
-  "version": "1.0.0", 
-  "claude_version": "1.x.x",
-  "active_sessions": 0
-}
-```
+For engineering workflows and internal commands:
+- `docs/dev.md`
 
 ## License