Files
BoosAPI/desktop/website/docs/de/guide/gateway.md
T
boos e0a5f57793 feat(desktop): embed BoosAPI Desktop client as a subproject
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as
a monorepo subdirectory under desktop/. Source only — node_modules,
dist, Cargo target and the upstream .git history are excluded.

desktop/ keeps its own independent Cargo workspace (desktop/src-tauri
with crates/*); it is not part of the backend boosapi crate, so a
`cargo check` at the metapi root still compiles only the backend. Build
the desktop app from desktop/src-tauri per desktop/README.md.

Note: app icons are still placeholder assets pending the final BoosAPI
logo. The updater signing keys live outside the repo and are not
included.
2026-06-22 11:32:57 +08:00

2.2 KiB

API-Gateway

Was ist das API-Gateway?

BoosApi enthält einen integrierten lokalen API-Server, der Ihre konfigurierten Anbieter als OpenAI-kompatible, Claude-native und Gemini-native Endpoints exponiert. Jedes Tool oder jeder Client, der eines dieser Protokolle verwendet, kann BoosApi als Backend verwenden — keine separaten API-Schlüssel oder Relay-Dienste erforderlich.

Anwendungsfälle:

  • Führen Sie Claude Code CLI, OpenAI Codex CLI, Gemini CLI oder OpenCode über BoosApi aus.
  • Verbinden Sie Ihre IDE-Erweiterungen mit einem einzigen, lokal verwalteten Endpoint.
  • Teilen Sie einen Satz von Anbieter-Schlüsseln über viele Tools mit schlüsselbasiertem Rate-Limiting.

Erste Schritte

  1. Öffnen Sie Einstellungen → API-Gateway (oder drücken Sie Cmd/Ctrl+Shift+G).
  2. Klicken Sie auf Starten, um den Gateway-Server zu starten.
  3. Standardmäßig lauscht der Server auf 127.0.0.1:8080 (HTTP).

::: tip Aktivieren Sie Auto-Start in den Gateway-Einstellungen, um den Server automatisch beim Start von BoosApi zu starten. :::


API-Schlüsselverwaltung

  1. Gehen Sie zum Tab API-Schlüssel.
  2. Klicken Sie auf Neuen Schlüssel generieren.
  3. Fügen Sie optional eine Beschreibung hinzu (z.B. Claude Code, VS Code).
  4. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt.

Konfigurationsvorlagen

Claude Code CLI

claude config set --global apiUrl http://127.0.0.1:8080
claude config set --global apiKey boosapi-xxxx

OpenAI Codex CLI

export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
export OPENAI_API_KEY=boosapi-xxxx
codex

Gemini CLI

export GEMINI_API_BASE=http://127.0.0.1:8080
export GEMINI_API_KEY=boosapi-xxxx
gemini

Benutzerdefinierter Client

Base URL:  http://127.0.0.1:8080/v1
API-Schlüssel: boosapi-xxxx

Nächste Schritte