DeepSeek-TUI (CodeWhale 0.10.2) и QCode

CodeWhale v0.10.2 (2026-10-24), ранее DeepSeek-TUI: бинарник codewhale, конфиг ~/.codewhale/config.toml, QCode.cc через anthropic или openai.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

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

Кратко¶

⚠️ Проект переименован. 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 (азиатский узел, поблизости от Кореи / Тайваня / Гонконга) ближе всего к материковому Китаю
• Полностью открытый код: лицензия 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 - full name taps and trusts in one step (the two-step form fails on Homebrew 7.x)
brew install Hmbown/deepseek-tui/codewhale

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

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

Изменение, проверенное 2026-10-26: официальная страница установки теперь указывает, что двухшаговая форма (brew tap Hmbown/deepseek-tui, затем brew install codewhale) не работает в Homebrew 7.x; используйте полное имя выше или сначала выполните brew trust hmbown/deepseek-tui. Версия этой страницы от 2026-09-18 показывала двухшаговую форму.

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

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 (азиатский узел, поблизости от Кореи / Тайваня / Гонконга). Ключ тот же.

Вместо файла можно использовать переменные окружения; документация теперь отдаёт приоритет универсальному набору 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.

Изменения v0.10.1–v0.10.2, влияющие на эту конфигурацию (2026-10-26)¶

Имя бинарника (codewhale) и путь конфигурации (~/.codewhale/config.toml) не изменились в официальных документах по установке и настройке, проверенных 2026-10-26. После v0.10.0 есть два изменения, связанных с конфигурацией:

• v0.10.1 — у ключей верхнего уровня теперь одно значение: «A top-level base_url or api_key in config.toml now means one thing everywhere.» Старые файлы продолжают работать: ключи читаются как [providers.deepseek] (или как провайдер, которому принадлежит официальный хост), при следующем сохранении переносятся туда с однократной резервной копией и одной строкой пояснения; codewhale config doctor показывает, что реально используется (примечания к релизу). В конфигурации выше api_key и base_url записаны внутри [providers.anthropic] / [providers.openai], поэтому её это не затрагивает.
• v0.10.2 (2026-10-24) — официальная команда установки позволяет закрепить версию: curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.10.2" sh (примечания к релизу). Команда без версии на странице установки curl -fsSL https://codewhale.net/install.sh | sh по-прежнему доступна.

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
• Выбор модели — какая модель для какой задачи
• DeepSeek Harness (dsh) — агентский харнесс с формой Custom model API

Enterprise →