Roo Code mit der Claude API – Anbietereinrichtung und ein Modell pro Modus

Roo Code ist ein Open-Source-autonomer Coding-Agent für VS Code – ein Fork aus der Cline-Familie, der sich durch sein Modussystem und das Routing von Modellen pro Modus auszeichnet. Es enthält kein eigenes Modell und benötigt daher einen API-Schlüssel. Dieser Leitfaden beschreibt die genaue Einrichtung, um Claude in Roo Code mit einem sk-kn--Schlüssel zu einem Preis von etwa 30% unter dem Listenpreis von Anthropic für die wichtigsten Modelle auszuführen, Konfigurationsprofile zu verwenden, um Geld für leistungsstarke Modelle nur dort auszugeben, wo es sich lohnt, die Kosten einer Sitzung und eine ehrliche Darstellung des Kompromisses gegenüber direkten Aufrufen an Anthropic.

Warum Roo Code einen API-Schlüssel benötigt

Jeder Schritt, den Roo Code ausführt – eine Datei lesen, ein Diff schreiben, einen Befehl ausführen, das Ergebnis lesen – ist ein pro Token berechneter Modellaufruf. Ein claude.ai-Pro- oder Max-Abonnement deckt dies nicht ab: Chat-Tarife und API-Zugriff sind getrennte Produkte, und Roo Code kommuniziert mit der API. Da eine agentische Schleife den wachsenden Aufgabenkontext bei jedem Schritt erneut sendet, ist der Preis pro Token der größte Hebel für die Sitzungskosten – und genau hier liegt der Vorteil eines Gateways: Pay-as-you-go ab einer Aufladung von 10 $, ein Schlüssel, der auch GPT erreicht, und ein Guthaben, das niemals verfällt.

Einrichtung – die drei Felder

Öffnen Sie Settings → Providers und setzen Sie den API-Provider auf OpenAI Compatible. Drei Werte:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...              # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Erstellen Sie den Schlüssel im Dashboard, nachdem Sie sich registriert und Guthaben aufgeladen haben – er wird nur einmal angezeigt, speichern Sie ihn daher sofort; die Claude-API-Schlüsseldokumentation behandelt Rotation und Ausgabenlimits. Wenn Roo Code nach Modellmetadaten wie Kontextfenster oder Output-Limit fragt, übernehmen Sie die Werte von der Modellseite – ein zu klein angegebenes Kontextfenster führt dazu, dass früher als nötig gekürzt wird.

Testen Sie zunächst etwas Kleines, bevor Sie den Code bearbeiten lassen. Ein 401 ist hier fast immer auf den Schlüssel zurückzuführen; ein 404 fast immer auf die Base URL oder einen nicht existierenden Modell-Slug – Kunavo gleicht Slugs exakt ab und verwendet keine Aliase für Namen mit Datumszusatz. Daher liefert claude-sonnet-4-5-20250929 404, während claude-sonnet-4-6 aufgelöst wird.

Modi und Konfigurationsprofile – der Kostenhebel

Roo Code enthält mehrere integrierte Modi – Code, Architect, Ask und Debug – sowie benutzerdefinierte Modi, die Sie selbst definieren. Für die Kosten entscheidend ist, dass Roo Code benannte API-Konfigurationsprofile speichert und sich merkt, welches Profil Sie zuletzt in jedem Modus verwendet haben. Das Modell wird somit zu einer Eigenschaft des Modus und nicht zu etwas, an dessen Änderung Sie denken müssen:

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

Der Grund, warum dies funktioniert, liegt darin, dass die Modi sehr unterschiedliche Tokenprofile haben. Architect umfasst einige reasoning-intensive Durchläufe, bei denen die Modellqualität entscheidet, ob die nächsten zwanzig Schritte produktiv sind – ein kleiner Anteil der Gesamt-Tokens, sodass ein leistungsstarkes Modell absolut wenig kostet. Code umfasst viele mechanische Schritte, die jeweils den Kontext erneut senden; hier summiert sich der Preis pro Token. Ask ist normalerweise ein einmaliger Aufruf und benötigt überhaupt kein Frontier-Modell.

Die konkreten Zahlen finden Sie unten: Drei Architect-Schritte mit Opus 5 plus siebzehn Code-Schritte mit Sonnet 5 ergeben etwa 1.06 $ gegenüber 0.87 $ für den vollständig mit Sonnet ausgeführten Ablauf – ungefähr 23% mehr für eine deutlich bessere Planung und deutlich günstiger, als alles mit Opus auszuführen.

Die native Anthropic-Route (und warum Sie sie verwenden könnten)

Roo Code bietet außerdem einen nativen Anthropic-Provider mit einem benutzerdefinierten Base-URL-Feld. Wenn Sie ihn auf https://api.kunavo.com verweisen – nur den Origin, ohne /v1, da dieser Client selbst /v1/messages anhängt –, läuft die Verbindung über die native Messages API. Das Einfügen der /v1-Form hier erzeugt einen 404, der wie ein fehlendes Modell aussieht.

Dieser Weg bietet Prompt-Caching: cache_control wird unverändert durchgereicht und gecachter Input mit 10 % des Input-Tarifs berechnet (so funktioniert es). Bei einer Schleife, die in jedem Schritt ein stabiles Präfix erneut sendet, ist dies die größte verfügbare einzelne Ersparnis – größer als jeder Modellwechsel. Beide Wege funktionieren; OpenAI Compatible ist für den Einstieg einfacher, und der Wechsel zwischen ihnen ist eine Einstellungssache.

Welches Claude-Modell welchem Modus zugeordnet werden sollte

Alle verwenden denselben Schlüssel und denselben Endpunkt – nur der Modell-Slug unterscheidet sich, sodass ein Profilwechsel eine Änderung an einem Wort ist. Die vollständigen Preise pro Modell im Vergleich zum offiziellen Listenpreis von Anthropic finden Sie in der Preisliste der Anthropic Claude API; der aktuelle Katalog befindet sich auf der Preisseite.

Roo Code auf Kunavo vs. direkter Aufruf von Anthropic

Der ehrliche Vergleich, einschließlich der Fälle, in denen der direkte Weg die bessere Wahl ist:

Diese Kapazitätszeile ist der eigentliche Zielkonflikt, klar ausgesprochen. Wenn Sie ein garantiertes Kontingent, ein vertragliches SLA oder eine Beschaffungsbeziehung mit dem Modellanbieter benötigen, gehen Sie direkt — dafür bezahlen Sie den Preisunterschied. Für einzelne Entwickler oder kleine Teams, die Roo Code ausführen, fällt der Kompromiss üblicherweise umgekehrt aus.

Was eine Roo-Code-Sitzung tatsächlich kostet

Agentische Tools verbrauchen konstruktionsbedingt viele Token: Bei jedem Schritt werden System-Prompt, Aufgabenverlauf und neuer Dateikontext erneut gesendet. Realistische Zahlen zu Kunavo-Preisen:

Die ausführbare Rechnung:

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One Code-mode step: Roo resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Die Rechnung niedrig halten

1. Starten Sie neue Aufgaben, statt eine Aufgabe endlos zu verlängern. Roo Code sendet bei jedem Schritt die gesamte Konversation erneut, sodass die Kosten einer einzigen lang laufenden Aufgabe quadratisch steigen. Eine neue Aufgabe bedeutet einen neuen, kleinen Kontext — die Gewohnheit mit dem größten Hebel.
2. Binden Sie pro Modus ein Profil. Wie oben beschrieben: Dadurch wird das Modellrouting zu einer Konfiguration, an die Sie sich während der Aufgabe nicht erinnern müssen.
3. Verwenden Sie zum Caching die native Anthropic-Route. Gecachter Input zu 10 % des Input-Tarifs ist die größte strukturelle Einsparung bei einer Schleife, die ein stabiles Präfix erneut sendet.
4. Geben Sie dem Editor einen eigenen, ausgabenbegrenzten Schlüssel. Erstellen Sie im Dashboard einen separaten Schlüssel und prüfen Sie nach einer tatsächlichen Woche die Nutzung — nur so lässt sich ehrlich einschätzen, was Sie das kostet.

Häufig gestellte Fragen