CodeWhale (ранее DeepSeek-TUI): интеграция

Подключение CodeWhale к QCode.cc: Claude через провайдер anthropic, GPT и китайские модели через OpenAI-совместимый провайдер

Последняя проверка: 2026-09-18 · 📄 По официальной документации (CodeWhale v0.9.13, выпуск 2026-09-14 (ранее DeepSeek-TUI))

Кратко¶

⚠️ Проект переименован. DeepSeek-TUI теперь называется CodeWhale. Бинарник изменился с deepseek на codewhale, конфигурация переехала из ~/.deepseek/config.toml в ~/.codewhale/config.toml. Откат к старому пути условный: официальное правило миграции — read-with-fallback, write-to-new: при чтении сначала смотрит в ~/.codewhale/ и уходит в ~/.deepseek/ только если старый каталог единственный, а запись всегда идёт в новый каталог. Кроме того, начиная с v0.9.0 команды deepseek и deepseek-tui удалены; точки входа — codewhale, codew (удобный алиас) и codewhale-tui. Старый сайт deepseek-tui.com теперь отдаёт 301 на codewhale.net. URL этой страницы не изменился.

CodeWhale — терминальный AI-агент для программирования с десятками встроенных провайдеров (anthropic, openai, deepseek, ollama, vllm, openrouter и другие; документация называет первоисточником список ProviderKind::ALL в коде, и он меняется между версиями — какие есть у вас, показывает панель /provider. Агент поддерживает и нативный протокол Anthropic Messages, и OpenAI-совместимый Chat Completions; оба можно направить на QCode.cc.

🔴 Сначала прочтите: для Claude нужен провайдер anthropic¶

OpenAI-совместимая точка QCode не принимает модели Claude — если указать claude-… в [providers.openai], вернётся model_not_available_on_endpoint. Таблица совместимости — в Точках доступа и форматах API.

Зачем использовать CodeWhale с QCode¶

• Привычный TUI: режимы Plan / Work / Operate и уровни доступа Ask / Auto-Review / Full Access (Shift+Tab), плюс встроенные MCP / Shell / Git / субагенты
• Один API-ключ: общая квота тарифа QCode с Claude Code и Codex CLI
• Переключение провайдеров: anthropic / openai / ollama / vllm в одном инструменте
• Удобно из материкового Китая: asia.qcode.cc (азиатский узел, поблизости от HK/JP) даёт минимальную задержку
• Полностью открытый код: лицензия MIT, конфигурацию можно проверить

1. Установка¶

Официально первый вариант — скрипт установки из GitHub Releases; npm и Cargo названы в документации вторичными способами упаковки:

# 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

Подробности и ограничения по платформам — в официальной документации по установке.

Проверка (доверяйте фактическому выводу, а не номеру версии из документации):

codewhale --version

2. Настройка Claude (провайдер anthropic)¶

Отредактируйте ~/.codewhale/config.toml:

# ~/.codewhale/config.toml

provider = "anthropic"

[providers.anthropic]
api_key  = "cr_ваш_ключ_QCode"
base_url = "https://api.qcode.cc/api"
model    = "claude-sonnet-5"

Из материкового Китая замените хост на https://asia.qcode.cc/api (азиатский узел, поблизости от HK/JP). Ключ тот же.

Вместо файла можно использовать переменные окружения; документация теперь отдаёт приоритет универсальному набору CODEWHALE_*:

export CODEWHALE_PROVIDER="anthropic"
export CODEWHALE_BASE_URL="https://api.qcode.cc/api"
export CODEWHALE_MODEL="claude-sonnet-5"
export ANTHROPIC_API_KEY="cr_ваш_ключ_QCode"

codewhale

Специфичные для провайдера переменные (ANTHROPIC_BASE_URL / ANTHROPIC_MODEL) тоже принимаются, как и флаг codewhale --provider anthropic.

3. Настройка GPT и китайских моделей (провайдер openai)¶

В одной конфигурации может быть несколько провайдеров; переключение — codewhale --provider <id>:

[providers.openai]
api_key  = "cr_ваш_ключ_QCode"
base_url = "https://api.qcode.cc/openai/v1"
model    = "gpt-6-sol"

base_url — до /openai/v1; CodeWhale сам добавит /chat/completions. Если другому билду нужен другой суффикс, для этого в документации предусмотрен ключ path_suffix внутри [providers.openai] — не подмешивайте его в base_url.

Четыре китайских семейства (glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.8-max …) работают на обоих протоколах, поэтому подойдёт любой провайдер. Идентификаторы — в Китайских моделях.

4. Доступные модели¶

Модели 4.x, такие как claude-sonnet-4-6 и claude-opus-4-8, всё ещё продаются. Полный список и актуальные цены — на qcode.cc/models.

Посмотреть доступные сейчас модели — списки на двух протоколах различаются:

# Claude и китайские модели (протокол Anthropic)
curl https://api.qcode.cc/v1/models -H "Authorization: Bearer cr_ваш_ключ_QCode"

# GPT (протокол OpenAI)
curl https://api.qcode.cc/openai/v1/models -H "Authorization: Bearer cr_ваш_ключ_QCode"

5. Проверка связи¶

KEY="cr_ваш_ключ_QCode"

# Claude (протокол Anthropic) — должен вернуться JSON с полем 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) — должен вернуться JSON с полем 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"}]}'

После проверки запустите:

codewhale

6. Диагностика¶

Смежные документы¶

• Точки доступа и форматы API — таблица «протокол × семейство моделей»
• Китайские модели — идентификаторы и пути GLM / Kimi / DeepSeek / Qwen
• Выбор модели — какая модель для какой задачи