Codex CLI z Kadrarisem

Codex CLI, terminalowy agent programistyczny od OpenAI, dogadasz z Kadrarisem przez serwer MCP. Kod nadal pisze jego własny model. Kadraris dokłada mu zestaw narzędzi: generowanie wideo, obrazów i muzyki, wycenę przed startem, odczyt salda oraz chat, którym Codex może poprosić Claude'a, Gemini albo DeepSeeka o drugie zdanie. Płacisz z jednego salda, jednym kluczem.

Czy Kadraris może być głównym modelem Codexa?

Obecnie nie. W config.toml da się dopisać własnego dostawcę ([model_providers]), ale aktualna dokumentacja OpenAI dopuszcza dla wire_api tylko wartość "responses", czyli Responses API pod /v1/responses. Kadraris ma dwa formaty czatu - /v1/chat/completions (OpenAI) i /v1/messages (Anthropic) - a /v1/responses nie istnieje. Dlatego taki wpis:

# NIE ZADZIAŁA - Kadraris nie ma /v1/responses
[model_providers.kadraris]
name = "Kadraris"
base_url = "https://kadraris.com/v1"
env_key = "KADRARIS_API_KEY"
wire_api = "responses"

zakończy się 404 już przy pierwszym zapytaniu. Alternatywy:

Za samego Codexa płacisz bez zmian: przez konto ChatGPT albo klucz OpenAI.

1. Osobny klucz dla agenta

1. W panelu otwórz zakładkę Klucze API.
2. Jako nazwę wpisz codex, a w polu Limit miesięczny kwotę, której agent nie przeskoczy, np. 50 zł.
3. Kliknij Utwórz klucz i skopiuj wartość sk-kd-....

2. Klucz w zmiennej środowiskowej

Codex nie przechowuje klucza w konfiguracji. Zapisujesz w niej tylko nazwę zmiennej, z której ma go odczytać.

macOS i Linux

# na Linuksie zwykle ~/.bashrc zamiast ~/.zshrc
echo 'export KADRARIS_API_KEY="sk-kd-..."' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell)

[Environment]::SetEnvironmentVariable(
  "KADRARIS_API_KEY", "sk-kd-...", "User")

Nowa zmienna pojawi się dopiero w świeżo otwartym terminalu. Sprawdzisz ją przez echo $env:KADRARIS_API_KEY w PowerShellu albo echo $KADRARIS_API_KEY na macOS i Linuksie.

3. Rejestracja serwera MCP

Polecenie wygląda tak samo na każdym systemie:

codex mcp add kadraris --url https://kadraris.com/mcp \
  --bearer-token-env-var KADRARIS_API_KEY

Możesz też dopisać wpis ręcznie w ~/.codex/config.toml (na Windows %USERPROFILE%\.codex\config.toml):

[mcp_servers.kadraris]
url = "https://kadraris.com/mcp"
bearer_token_env_var = "KADRARIS_API_KEY"

W bearer_token_env_var podajesz nazwę zmiennej, a nie klucz. Przy łączeniu Codex sam wyśle nagłówek Authorization: Bearer <zawartość zmiennej>.

4. Test połączenia

codex mcp list
codex mcp get kadraris

Na liście powinien być serwer kadraris z adresem https://kadraris.com/mcp. Uruchom teraz codex i wpisz:

Wywołaj get_balance z serwera kadraris i podaj stan mojego konta.

Gdy w odpowiedzi zobaczysz kwotę, konfiguracja jest gotowa.

Przykładowe polecenia dla Codexa

• "Potrzebuję tła do sekcji hero w tym projekcie. Policz koszt kadru 16:9 w Nano Banana Pro i w GPT Image 2.5, weź tańszą opcję i zapisz wynik jako public/img/hero.webp."
• "Zrób 5-sekundowy pionowy klip 9:16 w Seedance 2.5: kubek herbaty na drewnianym parapecie, światło o świcie. Koszt pokaż przed startem."
• "Spytaj claude-sonnet-5 narzędziem chat, czy ten skrypt migracji jest bezpieczny, i zestaw obie odpowiedzi."
• "Wypisz modele wideo, które dają 1080p, i policz dla każdego cenę 10 sekund."

Stawki dla orientacji: Seedance 2.5 od 1,51 zł za sekundę, Nano Banana Pro od 0,411 zł za obraz, GPT Image 2.5 0,293 zł za obraz.

Przy wideo narzędzie generate czeka najwyżej 45 sekund. Jeśli klip jeszcze się liczy, Codex dostaje id zadania i dopytuje o nie przez get_task. Adresy plików wygasają, więc poproś Codexa, żeby od razu zapisał wynik w projekcie.

Reguły na stałe w repozytorium

Codex czyta AGENTS.md z katalogu projektu. Ściągnij gotowy opis Kadraris API i dopisz pod nim własne zasady, np. "przed każdą generacją podaj koszt". Jak to zrobić: Plik AGENTS.md.

Gdy coś nie działa