Claude Code i narzędzia IDE

Agenci i edytory do programowania łączą się z Kadrarisem przez jeden z dwóch zgodnych endpointów. Claude Code mówi formatem Anthropic, więc trafia na /v1/messages. Cursor, Cline, Continue i większość pozostałych narzędzi korzysta z formatu OpenAI i /v1/chat/completions. W każdym przypadku podmieniasz tylko dwie rzeczy: adres bazowy i klucz.

Zanim zaczniesz, załóż w panelu osobny klucz tylko dla narzędzi do kodu i daj mu miesięczny limit wydatków. Agent pracujący godzinami wysyła masę zapytań, a limit sprawia, że ewentualna pętla nie zje całego salda.

Claude Code

macOS i Linux

export ANTHROPIC_BASE_URL=https://kadraris.com
export ANTHROPIC_AUTH_TOKEN=sk-kd-...
export ANTHROPIC_MODEL=claude-opus-5.5   # nieobowiązkowe
claude

Żeby ustawienia przetrwały zamknięcie terminala, dopisz te linie do ~/.bashrc lub ~/.zshrc.

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://kadraris.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kd-..."
$env:ANTHROPIC_MODEL = "claude-opus-5.5"   # nieobowiązkowe
claude

Ustawienie trwałe dla twojego konta w systemie:

[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_BASE_URL", "https://kadraris.com", "User")
[Environment]::SetEnvironmentVariable(
  "ANTHROPIC_AUTH_TOKEN", "sk-kd-...", "User")

Zmiany zobaczy dopiero nowo otwarty terminal.

Plik settings.json

Konfigurację możesz też trzymać w pliku ustawień Claude Code zamiast w zmiennych powłoki. ~/.claude/settings.json działa we wszystkich projektach, a .claude/settings.json tylko w bieżącym:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kadraris.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kd-...",
    "ANTHROPIC_MODEL": "claude-opus-5.5"
  }
}

Plik projektu z kluczem w środku nie powinien trafić do repozytorium. Klucz wpisz w ustawieniach użytkownika albo w .claude/settings.local.json.

Który model do czego

Model na jedną sesję wybierzesz też flagą: claude --model claude-sonnet-5. Przez /v1/messages dostępne są wyłącznie modele Claude, w tym Claude Opus 5.5 (20,53 zł / 102,64 zł za 1 mln tokenów), Claude Sonnet 5 (17,60 zł / 87,98 zł za 1 mln tokenów), Claude Fable 5.1 (51,32 zł / 256,61 zł za 1 mln tokenów) oraz Claude Haiku 4.5 (7,33 zł / 36,66 zł za 1 mln tokenów).

Czy działa

W Claude Code wpisz /status i zobacz, czy adres bazowy wskazuje Kadraris. Jeśli zapytania odbijają się błędem:

Kontekst 1M tokenów nie jest dostępny. Kadraris wycina bety context-1m-* (oraz końcówkę [1m] w nazwie modelu), dlatego każda sesja działa w zwykłym oknie kontekstu danego modelu.

Ile kosztowała sesja, sprawdzisz, odczytując GET /v1/balance przed i po pracy.

Pułapki po zmianie adresu

• Dwa klucze naraz. Gdy obok tokena Kadrarisa masz ustawione ANTHROPIC_API_KEY z kluczem Anthropic, usuń tę zmienną (unset ANTHROPIC_API_KEY albo kasując ją z settings.json). Inaczej część zapytań pójdzie z niewłaściwym nagłówkiem i dostanie 401.
• Wcześniejsze logowanie subskrypcją. Jeśli byłeś zalogowany planem Pro albo Max, po ustawieniu tokena i adresu Claude Code powinien korzystać z nich, a nie z subskrypcji. Gdy coś się plącze, wyloguj się poleceniem /logout.
• Funkcje wyłączone poza API Anthropic. Według dokumentacji Claude Code z własnym adresem bazowym nie działa Remote Control, a szukanie narzędzi MCP startuje wyłączone. To drugie przywrócisz zmienną ENABLE_TOOL_SEARCH=true.
• Firmowe proxy. Pracując za proxy, sprawdź, czy przepuszcza kadraris.com. Blokada objawia się zwykle długim czekaniem bez żadnej odpowiedzi.

Wideo, obrazy i muzyka prosto z Claude Code (MCP)

Claude Code potrafi też zlecać generacje mediów. Wystarczy dodać serwer MCP Kadrarisa jednym poleceniem:

claude mcp add --transport http kadraris https://kadraris.com/mcp \
  --header "Authorization: Bearer sk-kd-..."

Potem możesz napisać choćby: "przygotuj 5-sekundową rolkę 9:16 w Seedance 2.5 z parującą kawą, najpierw podaj koszt". Narzędzia serwera, zakresy (--scope user) i zasady bezpieczeństwa opisuje strona Serwer MCP.

Cursor

1. Wejdź w Settings, a potem w Models.
2. W polu OpenAI API Key wklej klucz sk-kd-....
3. Zaznacz Override OpenAI Base URL, a w polu adresu podaj https://kadraris.com/v1.
4. Dopisz model, którego id pochodzi z katalogu Kadrarisa (np. claude-sonnet-5 lub gpt-6-sol), i przełącz na niego czat.

Cline

W ustawieniach rozszerzenia:

Continue

Plik ~/.continue/config.yaml:

models:
  - name: Kadraris Claude Sonnet 5
    provider: openai
    model: claude-sonnet-5
    apiBase: https://kadraris.com/v1
    apiKey: sk-kd-...
  - name: Kadraris DeepSeek
    provider: openai
    model: deepseek-v4-flash
    apiBase: https://kadraris.com/v1
    apiKey: sk-kd-...

Roo Code

Roo Code konfigurujesz identycznie jak Cline. Jako dostawcę (API Provider) ustaw OpenAI Compatible, a potem podaj adres https://kadraris.com/v1, klucz sk-kd-... i model, na przykład claude-sonnet-5.

OpenCode

Plik opencode.json w katalogu projektu albo w ~/.config/opencode/:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kadraris": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kadraris",
      "options": {
        "baseURL": "https://kadraris.com/v1",
        "apiKey": "{env:KADRARIS_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-6-sol": { "name": "GPT-6 Sol" }
      }
    }
  }
}

Klucz trzymaj w zmiennej KADRARIS_API_KEY. W tym samym pliku dopiszesz serwer MCP do generowania mediów - przykład jest na stronie Serwer MCP.

Aider

Na macOS albo Linuksie:

export OPENAI_API_BASE=https://kadraris.com/v1
export OPENAI_API_KEY=sk-kd-...
aider --model openai/claude-sonnet-5

Windows (po setx otwórz nowy terminal):

setx OPENAI_API_BASE https://kadraris.com/v1
setx OPENAI_API_KEY sk-kd-...
aider --model openai/claude-sonnet-5

Przedrostek openai/ informuje Aidera, że rozmawia z endpointem w formacie OpenAI. Za nim wpisujesz id modelu z katalogu Kadrarisa.

Zed

Fragment settings.json w Zedzie:

{
  "language_models": {
    "openai_compatible": {
      "Kadraris": {
        "api_url": "https://kadraris.com/v1",
        "available_models": [
          { "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}

Klucza nie dawaj do settings.json - Zed prosi o niego w swoim panelu AI, przy konfiguracji tego dostawcy. Wartość max_tokens określa, ile kontekstu Zed może wysłać - 200000 jest bezpieczne, a dokładne okno każdego modelu podaje jego strona w katalogu.

Pozostałe narzędzia w formacie OpenAI

Narzędzia zbudowane na SDK OpenAI najczęściej odczytują te zmienne:

export OPENAI_BASE_URL=https://kadraris.com/v1
export OPENAI_API_KEY=sk-kd-...

Jeśli w ustawieniach widzisz pole w rodzaju "base URL", "custom endpoint" lub "OpenAI-compatible provider", wpisujesz to samo: https://kadraris.com/v1, swój klucz i id modelu z listy w Modelach.

Zestawienie wszystkich narzędzi (VS Code, Claude Desktop, Codex CLI i innych) jest na stronie Integracje.