CodeWhale (ehemals DeepSeek-TUI) Integration

CodeWhale mit QCode.cc verbinden: Claude über den anthropic-Provider, GPT und chinesische Modelle über den OpenAI-kompatiblen Provider

Zuletzt überprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (CodeWhale v0.9.13, veröffentlicht am 2026-09-14, ehemals DeepSeek-TUI)

Auf einen Blick¶

⚠️ Das Projekt wurde umbenannt. Aus DeepSeek-TUI wurde CodeWhale. Die Binary änderte sich von deepseek zu codewhale und die Konfigurationsdatei zog von ~/.deepseek/config.toml nach ~/.codewhale/config.toml um. Der Fallback ist bedingt: Das offizielle Migrationsverhalten ist Lesen mit Fallback, Schreiben in neues Verzeichnis — Lesezugriffe schauen zuerst in ~/.codewhale/ und fallen auf ~/.deepseek/ zurück, nur wenn dieses Verzeichnis das einzig vorhandene ist, während alle Schreibzugriffe in das neue Verzeichnis gehen. Außerdem wurden seit v0.9.0 die Befehle deepseek und deepseek-tui entfernt; die Einstiegspunkte sind codewhale, codew (eine praktische Kurzform) und codewhale-tui. Die alte Website deepseek-tui.com leitet nun per 301-Redirect auf codewhale.net weiter. Die URL dieser Seite ist unverändert.

CodeWhale ist ein Terminal-Coding-Agent mit Dutzenden erstklassigen Anbietern (anthropic, openai, deepseek, ollama, vllm, openrouter und weitere; die Dokumentation verweist auf ProviderKind::ALL im Quellcode als die maßgebliche Liste, die sich zwischen Versionen vergrößert und verkleinert — führen Sie /provider aus, um die in Ihrem Build verfügbare Auswahl zu sehen). Das Tool spricht sowohl das native Anthropic-Messages-Protokoll als auch das OpenAI-Chat-Completions-Protokoll, und jeder der beiden Protokolltypen kann auf QCode.cc zeigen.

🔴 Zuerst lesen: Claude erfordert den anthropic-Provider¶

QCodes OpenAI-kompatibler Endpunkt akzeptiert keine Claude-Modelle — claude-… in [providers.openai] einzutragen, führt zu model_not_available_on_endpoint. Siehe die Kompatibilitätstabelle unter Endpunkte & API-Pfade.

Warum CodeWhale mit QCode verwenden¶

• Vertraute TUI: Modi Plan / Work / Operate, mit den Berechtigungsstufen Ask / Auto-Review / Full Access (Shift+Tab) sowie integrierter MCP / Shell / Git / Subagenten-Unterstützung
• Ein API-Key: nutzt das Kontingent Ihres QCode-Tarifs gemeinsam mit Claude Code und Codex CLI
• Anbieterwechsel: Wechseln Sie innerhalb desselben Tools zwischen anthropic / openai / ollama / vllm
• Gut vom chinesischen Festland aus nutzbar: asia.qcode.cc (Asien-Knoten, in der Nähe von Korea / Taiwan / Hongkong) bietet die niedrigste Latenz
• Vollständig Open Source: unter MIT-Lizenz, die Konfigurationsdatei ist auditierbar

1. Installation¶

Die offizielle erste Wahl ist das Installationsskript aus den GitHub Releases; npm und Cargo werden in der Dokumentation als sekundäre Paketierungswege bezeichnet:

# Officially recommended (macOS / Linux): installs the release binary
curl -fsSL https://codewhale.net/install.sh | sh

# npm - the official docs call this a secondary packaging route (Node 18+)
npm install -g codewhale

# Homebrew - add the tap first, otherwise a fresh machine cannot find the formula
brew tap Hmbown/deepseek-tui
brew install codewhale

# Cargo - source build; the crate is codewhale-cli, the command it installs is codewhale
cargo install codewhale-cli --locked

Plattformbeschränkungen und Details: offizielle Installationsdokumentation.

Überprüfen Sie die Installation (verlassen Sie sich auf die tatsächliche Ausgabe, nicht auf eine in irgendeiner Dokumentation genannte Versionsnummer):

codewhale --version

2. Claude konfigurieren (Anbieter anthropic)¶

Bearbeiten Sie ~/.codewhale/config.toml:

# ~/.codewhale/config.toml

provider = "anthropic"

[providers.anthropic]
api_key  = "cr_your_qcode_key"
base_url = "https://api.qcode.cc/api"
model    = "claude-sonnet-5"

Vom chinesischen Festland aus ersetzen Sie den Host durch https://asia.qcode.cc/api (Asien-Knoten, nahe Korea / Taiwan / Hongkong). Der Key bleibt unverändert.

Statt der Konfigurationsdatei funktionieren auch Umgebungsvariablen; die Dokumentation bevorzugt inzwischen die generischen CODEWHALE_*-Variablen:

export CODEWHALE_PROVIDER="anthropic"
export CODEWHALE_BASE_URL="https://api.qcode.cc/api"
export CODEWHALE_MODEL="claude-sonnet-5"
export ANTHROPIC_API_KEY="cr_your_qcode_key"

codewhale

Die anbieterspezifischen Variablen (ANTHROPIC_BASE_URL / ANTHROPIC_MODEL) werden weiterhin akzeptiert, ebenso das Flag codewhale --provider anthropic.

3. GPT und chinesische Modelle konfigurieren (Anbieter openai)¶

Mehrere Anbieter können in einer Konfiguration nebeneinander bestehen; wechseln Sie mit codewhale --provider <id>:

[providers.openai]
api_key  = "cr_your_qcode_key"
base_url = "https://api.qcode.cc/openai/v1"
model    = "gpt-6-sol"

Enden Sie bei base_url mit /openai/v1; CodeWhale hängt /chat/completions an. Falls ein Build ein anderes Suffix benötigt, ist der offizielle Schlüssel dafür path_suffix innerhalb von [providers.openai] – schmuggeln Sie es nicht in base_url.

Die vier chinesischen Modellfamilien (glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.8-max …) funktionieren auf beiden Strecken, sodass Sie jeden der beiden Anbieter verwenden können. Die IDs finden Sie unter Chinesische Modelle.

4. Verfügbare Modelle¶

Modelle der Version 4.x wie claude-sonnet-4-6 und claude-opus-4-8 werden weiterhin angeboten. Die vollständige Liste und die aktuellen Preise finden Sie unter qcode.cc/models.

Lassen Sie sich anzeigen, was Sie aktuell aufrufen können – beachten Sie, dass die beiden Strecken unterschiedliche Listen zurückgeben:

# Claude and Chinese models (Anthropic leg)
curl https://api.qcode.cc/v1/models -H "Authorization: Bearer cr_your_qcode_key"

# GPT (OpenAI leg)
curl https://api.qcode.cc/openai/v1/models -H "Authorization: Bearer cr_your_qcode_key"

5. Verbindung überprüfen¶

KEY="cr_your_qcode_key"

# Claude (Anthropic protocol) — should return JSON containing content
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# GPT (OpenAI protocol) — should return JSON containing choices
curl -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

Dann starten:

codewhale

6. Fehlerbehebung¶

Weiterführende Links¶

• Endpunkte & API-Pfade — Tabelle Protokoll × Modellfamilie
• Chinesische Modelle — GLM- / Kimi- / DeepSeek- / Qwen-IDs und Pfade
• Modellauswahl — welches Modell für welche Aufgabe