# Kervan

> Kervan is an API gateway for Claude and GPT models (Anthropic- and OpenAI-compatible). Only the base URL and the API key change.

- Base URL (Anthropic format, Claude Code): https://api-kervan.poly1.fun
- Base URL (OpenAI format, Codex, SDKs, editors): https://api-kervan.poly1.fun/v1
- API keys look like: sk-… (create one at https://kervan.poly1.fun/tr/konsol/anahtarlar)
- Supported: POST /v1/messages, /v1/chat/completions, /v1/responses, GET /v1/models. Not supported: /v1/messages/count_tokens.
- Failed requests are not charged.

## Models
- claude-opus-5-5 (Claude Opus 5.5, context 1M)
- claude-sonnet-5 (Claude Sonnet 5, context 1M)
- claude-opus-5 (Claude Opus 5, context 1M)
- claude-fable-5-1 (Claude Fable 5.1, context 1M) — available after the first top-up
- gpt-6-sol (GPT-6 Sol, context 1.05M)

## Configure Claude Code (macOS / Linux)
```sh
export ANTHROPIC_BASE_URL="https://api-kervan.poly1.fun"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_KEY"
claude
```

## Configure Claude Code (Windows PowerShell)
```powershell
$env:ANTHROPIC_BASE_URL = "https://api-kervan.poly1.fun"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_KEY"
claude
```

## Configure Claude Code permanently (~/.claude/settings.json)
```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api-kervan.poly1.fun",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
  }
}
```

## Configure Codex (~/.codex/config.toml)
```toml
# ~/.codex/config.toml
model = "gpt-6-sol"
model_provider = "kervan"

[model_providers.kervan]
name = "Kervan"
base_url = "https://api-kervan.poly1.fun/v1"
env_key = "KERVAN_API_KEY"
wire_api = "responses"
```
Then: `export KERVAN_API_KEY="sk-YOUR_KEY"`

## Docs
- https://kervan.poly1.fun/tr/dokumanlar (Turkish), https://kervan.poly1.fun/en/dokumanlar (English), https://kervan.poly1.fun/fa/dokumanlar (Persian)
- Pricing: https://kervan.poly1.fun/en/fiyatlar
- Status: https://kervan.poly1.fun/en/durum