← Назад к блогу
OpenClaude: один конфиг вместо десяти команд

OpenClaude: один конфиг вместо десяти команд

OpenClaude: один конфиг вместо десяти команд

Если вы читали статью про Clother, вы знаете боль: каждый раз, когда нужно подключить Claude Code к другому провайдеру — GLM, Kimi, MiniMax, DeepSeek — нужна отдельная команда-обёртка. clother-zai, clother-kimi, clother-minimax, clother-deepseek… Каждая из них выставляет свои переменные окружения, каждая — отдельный симлинк, и каждый новый провайдер — ещё одна запись в PATH.

Но главная проблема не в запоминании команд — а в лимитах. Вы в середине сессии, модель упёрлась в лимит, и теперь нужно остановить процесс, запустить другую команду clother-* и каким-то образом продолжить ту же задачу с другой моделью. Это ручная работа, теряется контекст, теряется время.

OpenClaude решает это по-другому. Вместо отдельных команд для каждого провайдера вы определяете все модели в одном JSON-конфиге — а CLI сам разруливает маршрутизацию.

Немного предыстории: OpenClaude существует благодаря тому, что Anthropic случайно опубликовал исходный код Claude Code. Этот непреднамеренный слив стал настоящим подгоном open-source сообществу — комьюнити форкнуло код, убрало привязку к Anthropic, добавило мульти-провайдерную поддержку, и сейчас проект имеет 26k+ звёзд. Иногда лучшие open-source проекты начинаются с удачной случайности.

Проблема с обёртками по одной на команду

С Clother и аналогичными инструментами ментальная модель такая:

clother-zai        → Z.AI GLM-5
clother-kimi       → Kimi (kimi-k2.5)
clother-minimax    → MiniMax-M2.7
clother-deepseek   → DeepSeek
clother-alibaba    → Alibaba Coding Plan
clother-ollama     → Локальный Ollama
clother-or stepfun → Алиас для OpenRouter

Семь разных команд для семи провайдеров. Добавьте алиасы OpenRouter, кастомных провайдеров, локальные модели — и вы управляете зоопарком.

Основные проблемы:

  • Лимиты убивают поток. Работаете на GLM, квота кончилась — и теперь надо остановиться, переключиться на clother-kimi и возобновить, теряя контекст или вручную его пересоздавая
  • Каждый провайдер — отдельная команда — нельзя микшировать модели в одной сессии
  • Добавление провайдера означает установку нового симлинка и отдельную настройку ключей
  • Маршрутизация агентов — ручная — вы сами решаете, какой терминальный таб запускает какую обёртку

Честная оговорка: OpenClaude как агент для разработки

Буду честен: как кодинг-агент для ежедневной разработки, я по-прежнему предпочитаю официальный CLI от Anthropic. Родной клиент отполированнее, стабильнее и лучше интегрирован с возможностями Claude. OpenClaude — это community-форк, и это чувствуется в шероховатостях при реальной работе.

Но подход к конфигурации — это то, что делает OpenClaude интересным. ~/.openclaude/settings.json с agentModels и agentRouting — это объективно лучший способ управлять несколькими провайдерами, чем отдельные команды-обёртки. Даже если использовать OpenClaude только для экспериментов с этим паттерном — о нём стоит знать.

OpenClaude: всё в ~/.openclaude/settings.json

OpenClaude — это open-source CLI для кодинг-агентов (26k+ звёзд, TypeScript, MIT), который поддерживает несколько провайдеров нативно. Ключевая фишка — маршрутизация агентов.

Портирование реального Clother-конфига

Вот как выглядит реальная миграция. Мой конфиг Clother:

{
  "version": 1,
  "provider_overrides": {
    "kimi": { "model": "kimi-k2.6" },
    "zai": { "model": "glm-5.1" }
  },
  "openrouter_aliases": {
    "deepseek-v4": "deepseek/deepseek-v4-flash:nitro"
  },
  "custom_providers": {
    "sambanova": {
      "base_url": "https://api.sambanova.ai",
      "api_key_env": "SAMBA_API_KEY",
      "default_model": "MiniMax-M2.5"
    }
  }
}

Тот же набор в ~/.openclaude/settings.json:

{
  "agentModels": {
    "glm-5.1": {
      "base_url": "https://api.z.ai/api/anthropic",
      "api_key": "your-zai-key"
    },
    "kimi-k2.6": {
      "base_url": "https://api.kimi.com/coding/",
      "api_key": "your-kimi-key"
    },
    "deepseek-v4-flash": {
      "base_url": "https://openrouter.ai/api/v1",
      "api_key": "your-openrouter-key"
    },
    "MiniMax-M2.5-sambanova": {
      "base_url": "https://api.sambanova.ai",
      "api_key": "your-sambanova-key"
    }
  },
  "agentRouting": {
    "Plan": "glm-5.1",
    "code-review": "glm-5.1",
    "general-purpose": "kimi-k2.6",
    "frontend-dev": "kimi-k2.6",
    "Explore": "deepseek-v4-flash",
    "default": "kimi-k2.6"
  }
}

Четыре провайдера. Один файл. Ноль команд для запоминания. Никаких clother-zai, clother-kimi, clother-or deepseek-v4 — одна команда openclaude.

Секция agentRouting — главная сила: умный GLM-5.1 берёт планирование и код-ревью, Kimi — рутинный кодинг, DeepSeek V4 Flash через OpenRouter — быстрое исследование. Настроили один раз — и забыли.

Что поддерживает OpenClaude

OpenClaude работает с любым OpenAI-совместимым API из коробки, плюс нативная поддержка:

ПровайдерТип
OpenAI (GPT-4o, o3 и т.д.)Облачный API
GeminiОблачный API
GitHub ModelsОблачный API
DeepSeekОблачный API
Любой OpenAI-совместимый (GLM, Kimi, MiniMax и т.д.)Облачный API
OllamaЛокальный
Codex / Codex OAuthОблачный API
Atomic ChatОблачный API

Слеш-команда /provider внутри CLI даёт пошаговую настройку — если не хотите редактировать JSON руками.

Как начать

Установка:

npm install -g @gitlawb/openclaude

Запуск:

openclaude

Внутри CLI запустите /provider для интерактивной настройки провайдера или отредактируйте ~/.openclaude/settings.json вручную.

Быстрый старт с переменными окружения

Для быстрого запуска без правки конфигов:

# OpenAI
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key
export OPENAI_MODEL=gpt-4o
openclaude

# Локальный Ollama
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b
openclaude

Шорткат для Ollama

Если у вас установлен Ollama:

ollama launch openclaude --model qwen2.5-coder:7b

Автоматически маршрутизирует весь API-трафик через локальный инстанс — переменные окружения не нужны.

/provider vs /model — не путайте

Это неочевидный момент, на котором спотыкаешься при первом запуске.

/provider — переключение между провайдерами (Kimi, GLM, DeepSeek, MiniMax). Каждый профиль — это отдельный baseUrl + apiKey + model. Все 4 профиля видны здесь:

Edit provider
 1. Kimi (active)                 OpenAI-compatible API · kimi-k2.6
 2. GLM-5.1 (Z.AI)               OpenAI-compatible API · glm-5.1
 3. DeepSeek V4 Flash (OpenRouter) OpenAI-compatible API · deepseek-v4-flash:nitro
 4. MiniMax (SambaNova)           OpenAI-compatible API · MiniMax-M2.5

/model — переключение модели внутри текущего провайдера. Показывает только модели активного профиля + захардкоженные GPT/Sonnet/Opus. Ваши кастомные модели из других профилей здесь не видны.

На практике: хотите переключиться с Kimi на GLM — используйте /provider, не /model. Это контринтуитивно, но так работает текущая архитектура (v0.10.0). Мы создали issue с предложением показывать все настроенные модели в одном списке /model.

Где что хранится:

  • Профили провайдеров~/.openclaude.jsonproviderProfiles[]
  • Маршрутизация субагентов~/.openclaude/settings.jsonagentModels + agentRouting
  • Стартовый профиль~/.openclaude/.openclaude-profile.json

Clother vs OpenClaude: когда что использовать

Оба инструмента решают проблему мульти-провайдеров для Claude Code, но с разных сторон:

ClotherOpenClaude
ПодходКоманды-обёртки вокруг официального Claude CodeСамостоятельный CLI с встроенной поддержкой провайдеров
Конфиг~/.config/clother/config.json + симлинки~/.openclaude/settings.json — один файл
Добавление провайдераНовый симлинк + настройка ключейОдин JSON-блок
Маршрутизация агентовРучная (разные табы терминала)Автоматическая через agentRouting
Нужен Claude CodeДа — оборачивает официальный бинарникНет — автономная замена
Отдельные команды для провайдеровДа (clother-zai, clother-kimi, …)Нет — одна команда openclaude
VS Code расширениеЧерез настройку wrapper в Claude CodeВстроенное расширение
Параллельные провайдерыОтдельные табы терминалаВстроенная маршрутизация в одной сессии

Используйте Clother, когда хотите сохранить официальный Claude Code и просто чисто переключаться между провайдерами.

Используйте OpenClaude, когда хотите один CLI, который нативно работает со всеми провайдерами и автоматически маршрутизирует между моделями.

Почему это важно для оптимизации затрат

Если вы читали Как сэкономить токены в LLM, вы знаете стратегию: дешёвые модели (китайские API, локальный Ollama) для рутины, дорогие модели — для сложных задач.

С обёртками по одной на команду реализация такой стратегии — жонглирование табами, и когда одна модель упирается в лимит, нужно руками останавливать и перезапускать с другой:

  • Таб 1: clother-zai --yolo для массовых рефакторингов → упёрлись в лимит → вручную перезапуск с clother-kimi
  • Таб 2: clother-native для дизайн-обсуждений
  • Таб 3: clother-ollama для конфиденциальной локальной работы

С маршрутизацией агентов в OpenClaude та же стратегия — один блок в конфиге. CLI автоматически отправляет планирование на умный GLM-5.1, рутинный кодинг на Kimi, быстрые задачи на MiniMax (200–400 TPS). Без жонглирования табами, без запоминания команд, без ручных фейловеров.

Стратегия многоуровневых моделей

Практическая схема, которая хорошо работает с китайскими подписками:

УровеньМодельTPS (подписка)ЗадачиПочему
УмныйGLM-5.110–20Планирование, код-ревью, архитектураСильный reasoning, хорош для сложных задач
Рабочая лошадкаKimi (kimi-k2.5)20–60Рутинный кодинг, рефакторинг, тестыНадёжный, хороший баланс скорости и качества
БыстрыйMiniMax-M2.7200–400Исследование, простые правки, поискМолниеносный инференс, самый дешёвый за токен

С Clother такая многоуровневая схема — три отдельных команды и ручное переключение при достижении лимитов. С OpenClaude — три записи в agentRouting, и CLI сам выбирает нужный уровень для каждой задачи.

Что ещё входит

Помимо мульти-провайдерной поддержки, OpenClaude включает:

  • Полный набор инструментов — bash, чтение/запись/редактирование файлов, grep, glob, агенты, задачи, MCP, слеш-команды
  • Стриминг — вывод токенов и прогресс инструментов в реальном времени
  • Веб-поиск — DuckDuckGo фоллбэк для не-Anthropic моделей, интеграция с Firecrawl для JS-тяжёлых страниц
  • Режим gRPC-сервера — запуск OpenClaude без головы для CI/CD или кастомных фронтендов
  • VS Code расширение — интеграция запуска и поддержка тем
  • Работает на Android — да, правда (инструкция по установке)

Итого

Эволюция очевидна:

  1. Shell-алиасы — хрупкие, рассинхронизируются
  2. Clother — чистые обёртки по одной на команду, без утечки конфигов
  3. OpenClaude — все модели в одном конфиге, автоматическая маршрутизация

Лично я по-прежнему использую официальный CLI от Anthropic как основной агент для разработки — для реальной работы с кодом он просто лучше. Но конфигурационный подход к маршрутизации моделей в OpenClaude — это паттерн, который стоит знать. Если вы управляете несколькими провайдерами и устали от жонглирования командами clother-* (особенно когда лимиты бьют в середине сессии), это более чистый подход.


Читайте также: Clother — подход с обёртками, и Как сэкономить токены в LLM — полная стратегия оптимизации затрат.