Быстрый старт
Начните первую сессию Cusp — в десктопном приложении или в терминале.
Это руководство проведёт вас от свежей установки до агента, который прочитал ваш проект и внёс изменение. Вам понадобится установленный Cusp и API-ключ любого поддерживаемого провайдера или запущенный локальный сервер моделей.
Вставьте ключ
Откройте Cusp. На экране приветствия вставьте API-ключ любого провайдера: Anthropic, OpenAI, Google, OpenRouter, DeepSeek, Moonshot, Z.ai и так далее.
Остальное Cusp сделает сам:
- Определит провайдера по префиксу ключа (
sk-ant-,sk-or-,AIza,xai-, …) или по базовому URL, если вы его указали. - Параллельно опросит конечные точки, чтобы узнать, какие протоколы отвечают. Проверки не тратят токены.
- Получит список доступных моделей и выберет основную модель для агента, а также небольшую быструю — для заголовков и сводок.
Ключ сохраняется в системной связке ключей. Cusp хранит только ссылку на него.
Для шлюза или своего сервера укажите также базовый URL. Для Ollama или LM Studio укажите локальный адрес (http://localhost:11434 или http://localhost:1234); ключ не нужен.
Выберите папку
Выберите Открыть папку… (⌘O в macOS, Ctrl+O в других системах) и укажите проект. Cusp прочитает его файлы инструкций (CUSP.md, CLAUDE.md, AGENTS.md) и всю найденную конфигурацию в .cusp/ или .claude/.
Когда вы впервые открываете папку, Cusp спрашивает, доверяете ли вы ей. Пока вы не подтвердите доверие, настройки проекта не могут добавлять хуки, переменные окружения, MCP-серверы и разрешающие правила.
Спросите
Напишите, что вам нужно, в поле ввода и нажмите Enter. Хороший первый запрос — вопрос о коде:
How does authentication work in this project? Point me to the main files.Затем попросите внести небольшое изменение:
Add a --verbose flag to the CLI entry point and log the resolved config when it's set.Пока агент работает, вы видите индикатор размышлений с прошедшим временем и числом токенов. Каждый вызов инструмента появляется в переписке. Когда агент хочет изменить файл или выполнить команду, Cusp сначала спрашивает вас. Разрешить можно один раз, до конца сессии или навсегда.
Когда ход завершается, Cusp показывает итог в одну строку: сколько времени это заняло, сколько инструментов было запущено и сколько токенов израсходовано.
Запуск Cusp без интерфейса
Неинтерактивный режим выполняет один запрос, выводит результат и завершается. Он подходит для скриптов, git-хуков и CI:
cusp -p "Summarize the changes on this branch in three bullet points"Можно передать данные на вход и получить структурированный результат:
git diff main | cusp -p "Review this diff for bugs" --output-format jsonНеинтерактивный запуск не может остановиться и что-то у вас спросить. Вызовы инструментов, которым нужно подтверждение, отклоняются, если вы не разрешили их заранее:
cusp -p "Fix the failing unit tests" \
--allowedTools "Bash(npm test *)" Edit \
--max-turns 30Все флаги и формат вывода JSON описаны в справочнике CLI.
Выбор другой модели
Cusp выбирает модель за вас, но её можно сменить в любой момент.
- В десктопном приложении — через выбор модели в поле ввода.
- В CLI введите
/model, чтобы выбрать из списка, или/model openrouter:z-ai/glm-5.3, чтобы переключиться сразу. - Из командной строки запустите
cusp -m anthropic:claude-sonnet-5-5.
Уровень рассуждений определяет, как долго модель думает перед ответом. Задайте его командой /effort high или флагом --effort high. См. Модели и уровень рассуждений.
Руководство по проекту
Выполните /init в новом проекте. Cusp прочитает кодовую базу и создаст в корне репозитория CUSP.md с командами сборки, тестов и линтера, обзором архитектуры и соглашениями. Если в проекте уже есть CUSP.md, AGENTS.md или CLAUDE.md, Cusp улучшит этот файл. Каждая следующая сессия начинается с этим контекстом. См. Память.