Matpeshka CLI

Zero-config доступ к Claude Code через Matryoshka Studio.

CLI сам авторизует пользователя, настраивает ~/.claude/settings.json, ставит или обновляет @anthropic-ai/claude-code и запускает Claude Code через Anthropic-compatible proxy Matryoshka.

Быстрый старт

npx matpeshka

Что произойдёт:

1. Откроется авторизация на https://matpeshka.ru.
2. CLI дождётся подтверждения через /auth/poll.
3. Токен сохранится в ~/.matpeshka/config.json.
4. Claude Code settings будут записаны в ~/.claude/settings.json.
5. Запустится claude с моделью Matryoshka.

Глобальная установка:

npm install -g matpeshka
matpeshka

Команды

| Команда | Что делает | |---------|------------| | matpeshka | Авторизует при необходимости, настраивает Claude Code и запускает TUI | | matpeshka start | То же самое, что matpeshka | | matpeshka login | Принудительная авторизация через браузер | | matpeshka logout | Удаляет локальный токен и Matryoshka env из Claude settings | | matpeshka status | Показывает аккаунт, тариф, режим, лимиты и использование | | matpeshka balance | Показывает API-баланс, trial и поставщика мощностей | | matpeshka pay [api$] | Создаёт оплату API-баланса и открывает браузер | | matpeshka mode elite | Переключает Claude Code на Opus 4.6 Thinking | | matpeshka mode pro | Переключает Claude Code на Sonnet 4.6 | | matpeshka mode fast | Переключает Claude Code на быстрый режим Gemini | | matpeshka code [path] | Ставит расширение Claude Code для VS Code и открывает проект | | matpeshka update | Проверяет и ставит последнюю версию matpeshka | | matpeshka help | Показывает справку |

Режимы

| Режим | Модель | Thinking | |-------|--------|----------| | elite | claude-opus-4-6-thinking | xhigh, до 31999 | | pro | claude-sonnet-4-6 | high, до 16000 | | fast | matpeshka-gemini-fast | medium, до 8000 |

Пример:

matpeshka mode elite
matpeshka

Как это работает

[matpeshka CLI]
       │  авторизация через https://matpeshka.ru
       │  пишет ~/.claude/settings.json
       ▼
[Claude Code]
       │  ANTHROPIC_BASE_URL=https://claude-opus.shop
       │  ANTHROPIC_AUTH_TOKEN=<mtp_token>
       ▼
[Matryoshka API Bridge (claude-opus.shop)]
       │  /v1/messages, /v1/models, /v1/messages/count_tokens
       ▼
[CLIProxy / Kiro / Antigravity]
       ▼
[Claude / Gemini / другие модели]

CLI не использует ANTHROPIC_API_KEY. Перед запуском Claude Code он удаляет конфликтующие переменные окружения, чтобы Claude Code не переключался на чужой Anthropic-аккаунт.

Выход из Matryoshka

Чтобы отключить Matryoshka от Claude Code:

matpeshka logout

Команда:

1. Удаляет локальный Matryoshka token из ~/.matpeshka/config.json.
2. Убирает из ~/.claude/settings.json Matryoshka env:
   • ANTHROPIC_BASE_URL
   • ANTHROPIC_AUTH_TOKEN
   • Matryoshka model defaults
   • Matryoshka telemetry/permission overrides
3. Сохраняет чужие настройки Claude Code, если они не относятся к Matryoshka.

После этого можно снова авторизоваться своим Anthropic-аккаунтом:

claude login

или использовать свой ключ:

export ANTHROPIC_API_KEY=sk-ant-...
claude

Что пишет CLI

~/.matpeshka/config.json

Локальный конфиг CLI:

{
  "token": "mtp_...",
  "email": "[email protected]",
  "deviceId": "...",
  "mode": "pro",
  "loggedInAt": "2026-05-02T..."
}

Файл создаётся с правами 600.

~/.claude/settings.json

Claude Code получает:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-opus.shop",
    "ANTHROPIC_AUTH_TOKEN": "...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "DISABLE_TELEMETRY": "1"
  },
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

Баланс и оплата

Проверить баланс:

matpeshka balance

Создать оплату:

matpeshka pay 5000

CLI отправляет:

POST https://matpeshka.ru/api/auth/billing/create-payment

с источником:

{
  "source": "npm_cli"
}

Требования

• Node.js 18+
• Доступ к npm
• Для matpeshka code: установленный VS Code CLI code

Разработка пакета

Проверка синтаксиса:

node --check bin/matpeshka.js

Локальный запуск из папки пакета:

node bin/matpeshka.js help

Проверка состава npm-пакета:

npm pack --dry-run

Публикация:

npm publish

Лицензия

ISC