Doku

Agenten

Coding-Agenten verbinden Sie über eine eigene URL mit TOKENWERK. Wählen Sie ein Modell mit Tool-Calling und großem Kontextfenster; ersetzen Sie MODELL durch dessen Namen.

Claude Code

Claude Code spricht das Anthropic-Format. Setzen Sie die URL und den API-Key als Umgebungsvariablen, alle Modellrollen zeigen auf ein TOKENWERK-Modell.

terminal 
curl -fsSL https://claude.ai/install.sh | bash

terminal 
export ANTHROPIC_BASE_URL="https://api.tokenwerk.ai"
export ANTHROPIC_AUTH_TOKEN="$TOKENWERK_API_KEY"
export ANTHROPIC_MODEL="MODELL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="MODELL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="MODELL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="MODELL"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="KONTEXTFENSTER"
claude

  • CLAUDE_CODE_MAX_CONTEXT_TOKENS ist das Kontextfenster des Modells (siehe Modellliste). Claude Code kennt die Modelle von TOKENWERK nicht und nimmt sonst 200.000 Tokens an; es würde das Gespräch dann zu spät oder zu früh komprimieren.
  • Den API-Key nur in ~/.claude/settings.json oder .claude/settings.local.json eintragen, nicht in die geteilte .claude/settings.json eines Projekts.
  • Anthropic unterstützt den Betrieb mit anderen Modellen als Claude über Gateways offiziell nicht. Antwortet ein Modell mit 400-Fehlern auf Beta-Funktionen, hilft CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.

Offizielle Anleitung: Claude Code: LLM-Gateways ↗

opencode

opencode bindet TOKENWERK als eigenen Provider über das OpenAI-Format ein. Speichern Sie die Konfiguration als opencode.json im Projekt oder global als ~/.config/opencode/opencode.json.

terminal 
curl -fsSL https://opencode.ai/install | bash

opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenwerk": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TOKENWERK",
      "options": {
        "baseURL": "https://api.tokenwerk.ai/v1",
        "apiKey": "{env:TOKENWERK_API_KEY}"
      },
      "models": {
        "MODELL": {
          "name": "MODELL"
        }
      }
    }
  },
  "model": "tokenwerk/MODELL"
}

  • Tragen Sie unter models.<name>.limit optional context und output ein (Werte unter Modelle), dann komprimiert opencode lange Sitzungen rechtzeitig.

Offizielle Anleitung: opencode: Providers ↗

OpenClaw

OpenClaw bekommt TOKENWERK als eigenen Provider in ~/.openclaw/openclaw.json.

terminal 
npm install -g openclaw@latest
openclaw onboard --install-daemon

~/.openclaw/openclaw.json 
{
  agents: { defaults: { model: { primary: "tokenwerk/MODELL" } } },
  models: {
    mode: "merge",
    providers: {
      tokenwerk: {
        baseUrl: "https://api.tokenwerk.ai/v1",
        apiKey: "${TOKENWERK_API_KEY}",
        api: "openai-completions",
        models: [{ id: "MODELL", name: "MODELL" }],
      },
    },
  },
}

  • Für das Anthropic-Format setzen Sie baseUrl auf https://api.tokenwerk.ai und api auf "anthropic-messages".
  • Jedes Modell muss unter models mit seiner id stehen; contextWindow und maxTokens können Sie dort ergänzen.

Offizielle Anleitung: OpenClaw: Custom Providers ↗

Hermes Agent

Hermes Agent von Nous Research verbindet sich über einen „Custom endpoint“. Am einfachsten mit hermes model, oder direkt in der Konfiguration:

terminal 
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

~/.hermes/config.yaml 
model:
  provider: custom
  base_url: https://api.tokenwerk.ai/v1
  default: MODELL
  key_env: TOKENWERK_API_KEY

  • Hermes braucht ein Modell mit Tool-Calling und mindestens 64 000 Tokens Kontext.

Offizielle Anleitung: Hermes Agent: Providers ↗

Codex CLI

Codex CLI spricht ausschließlich die Responses API (/v1/responses). TOKENWERK leitet sie weiter, sie funktioniert mit Modellen, die diese API unterstützen.

terminal 
npm install -g @openai/codex

~/.codex/config.toml 
model = "MODELL"
model_provider = "tokenwerk"

[model_providers.tokenwerk]
name = "TOKENWERK"
base_url = "https://api.tokenwerk.ai/v1"
env_key = "TOKENWERK_API_KEY"
wire_api = "responses"

Offizielle Anleitung: Codex: Konfiguration ↗

Aider

Aider nutzt das OpenAI-Format; dem Modellnamen wird openai/ vorangestellt.

terminal 
python -m pip install aider-install
aider-install

terminal 
export OPENAI_API_BASE="https://api.tokenwerk.ai/v1"
export OPENAI_API_KEY="$TOKENWERK_API_KEY"
aider --model openai/MODELL

  • Warnungen zu unbekannten Modellen können Sie ignorieren, Aider kennt nur die Modelle großer Anbieter.

Offizielle Anleitung: Aider: OpenAI-kompatible APIs ↗

Cline, Roo Code, Kilo Code

Die drei VS-Code-Erweiterungen haben einen Provider „OpenAI Compatible“. Tragen Sie in den Einstellungen ein:

Feld Wert
API Provider OpenAI Compatible
Base URL https://api.tokenwerk.ai/v1
API Key Ihr API-Key (tw-…)
Model ID MODELL
  • Unter den Modelleinstellungen können Sie Kontextfenster, maximalen Output und Bildeingabe angeben.
  • Kilo Code bietet zusätzlich „Anthropic Messages“ an, dann mit der URL https://api.tokenwerk.ai.
  • Roo Code arbeitet nur mit Modellen, die Tool-Calling unterstützen.

Offizielle Anleitungen: Cline ↗ · Roo Code ↗ · Kilo Code ↗

Continue

In der config.yaml von Continue (in der Erweiterung über die Einstellungen zu öffnen) ergänzen Sie ein Modell mit dem Provider openai:

config.yaml 
models:
  - name: TOKENWERK MODELL
    provider: openai
    model: MODELL
    apiBase: https://api.tokenwerk.ai/v1
    apiKey: tw-...
    capabilities:
      - tool_use
    roles:
      - chat
      - edit
      - apply

Offizielle Anleitung: Continue: config.yaml ↗

Goose

Goose bekommt TOKENWERK als eigenen Provider: Legen Sie die Datei an und wählen Sie den Provider danach in goose configure aus.

terminal 
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

~/.config/goose/custom_providers/tokenwerk.json 
{
  "name": "tokenwerk",
  "engine": "openai",
  "display_name": "TOKENWERK",
  "description": "TOKENWERK API",
  "api_key_env": "TOKENWERK_API_KEY",
  "base_url": "https://api.tokenwerk.ai/v1/chat/completions",
  "models": [{ "name": "MODELL", "context_limit": 128000 }],
  "supports_streaming": true,
  "requires_auth": true
}

  • Setzen Sie context_limit auf das Kontextfenster des Modells (siehe Modelle).

Offizielle Anleitung: Goose: Providers ↗

Zed

Zed bindet TOKENWERK als OpenAI-kompatiblen Provider in seiner settings.json ein. Den API-Key liest Zed für den Provider tokenwerk automatisch aus TOKENWERK_API_KEY, alternativ fragt Zed beim ersten Aufruf danach.

settings.json 
{
  "language_models": {
    "openai_compatible": {
      "tokenwerk": {
        "api_url": "https://api.tokenwerk.ai/v1",
        "available_models": [
          { "name": "MODELL", "display_name": "MODELL", "max_tokens": 128000 }
        ]
      }
    }
  }
}

  • max_tokens ist das Kontextfenster des Modells (siehe Modelle).

Offizielle Anleitung: Zed: API-Zugang ↗