Claude Code API Gateway
codingworkflow/claude-code-api
API OpenAI-compatible para Claude Code CLI com fallback de modelos
Ver no GitHubGateway de API compatível com OpenAI que expõe a CLI Claude Code através de endpoints padrão (`/v1/chat/completions`, `/v1/models`). Suporta streaming, múltiplos modelos Claude com fallback automático e gerenciamento de sessões/projetos.
Instalação
npx convez-ai codingworkflow/claude-code-api1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar Claude Code CLI em aplicações que esperam API OpenAI-compatible
- Construir gateways de API com suporte a múltiplos modelos Claude e retry automático
- Expor CLI local como servidor REST para clientes remotos
Veredito

Solução técnica sólida para quem precisa consumir Claude Code CLI via API padronizada. Bem útil em cenários de integração, mas requer setup local do binário Claude e tem escopo bem específico.
README
A tradução para o português deste README ainda está na fila.
Claude Code API Gateway
OpenAI-compatible API gateway for Claude Code CLI.
What You Get
- OpenAI-style endpoints (
/v1/chat/completions,/v1/models, sessions/projects APIs) - Streaming and non-streaming chat completions
- Claude model aliases and fallback behavior
- Optional
modelfield: if omitted, CLI default model is used
Quick Start (Linux/macOS)
git clone https://github.com/codingworkflow/claude-code-api
cd claude-code-api
make install
make start
Server URLs:
- API:
http://localhost:8000 - OpenAPI docs:
http://localhost:8000/docs - Health:
http://localhost:8000/health
Quick Start (Windows)
Use the provided wrappers:
make.bat install
start.bat
Notes:
start.batstarts the API in dev mode.make.batprovides common project commands.- Claude Code CLI support on Windows may require WSL depending on your local setup.
Supported Models
Model config is in claude_code_api/config/models.json.
Override with CLAUDE_CODE_API_MODELS_PATH.
claude-opus-4-6-20260205claude-opus-4-5-20251101claude-sonnet-4-5-20250929claude-haiku-4-5-20251001
Alias/fallback behavior:
modelis optional in/v1/chat/completions.opus,claude-opus-latest,claude-opus-4-6resolve 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
400witherror.code = model_not_supported.
API Usage
Chat completion:
curl -X POST http://localhost:8000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"messages": [
{"role": "user", "content": "Hello"}
]
}'
List models:
curl http://localhost:8000/v1/models
Streaming:
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"}],
"stream": true
}'
Configuration
Common settings are in claude_code_api/core/config.py:
claude_binary_pathproject_rootdatabase_urlrequire_auth
Bug Reports & Support
For claude-code-api and ai-code-fusion, use this discussion thread for bug reports and troubleshooting:
Developer Docs
For engineering workflows and internal commands:
docs/dev.md
License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.