Импорт вашей настройки
Перенесите инструкции, настройки, навыки, субагентов, команды, хуки и MCP-серверы из агентов, с которыми вы уже работаете.
Начинать с нуля не нужно. Cusp читает распространённые форматы инструкций и настроек прямо там, где они лежат, а импорт переводит остальное в собственные файлы Cusp. Ваши инструкции, навыки, субагенты, хуки и MCP-серверы работают как есть.
На этой странице перечислено, что Cusp читает на месте, что импорт переносит из каждого источника, как уживаются файлы Cusp и общие файлы и что пока не переносится.
Что читается на месте
Эти файлы не нужно импортировать. Откройте проект, где они есть, — и они уже действуют:
| Что | Файлы | Что делает Cusp |
|---|---|---|
| Инструкции | AGENTS.md, CLAUDE.md, GEMINI.md, CLAUDE.local.md, .claude/CLAUDE.md и пользовательские ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, ~/.gemini/GEMINI.md | Загружает как память проекта, локальную и пользовательскую память, с импортами @path глубиной до 4 уровней |
| Правила | .claude/rules/*.md, ~/.claude/rules/*.md | Загружает при старте; правила с paths: во frontmatter загружаются, когда агент работает с подходящим файлом |
| Настройки | .claude/settings.json, .claude/settings.local.json, ~/.claude/settings.json | Объединяет с иерархией настроек: разрешения, хуки, env, песочница, модель и другое |
| Управляемые настройки | системные управляемые файлы в формате settings.json | Учитывает на управляемом уровне, ниже собственного управляемого файла Cusp. См. Развёртывание |
| Правила разрешений | permissions.allow, ask, deny | Bash(npm run test:*), Edit(src/**), WebFetch(domain:github.com), mcp__github__* |
| Навыки | .claude/skills/, .agents/skills/, .codex/skills/ и их пользовательские папки | Находит с полной поддержкой frontmatter, $ARGUMENTS, ${CLAUDE_SKILL_DIR} и подстановки !`command` |
| Команды | .claude/commands/*.md, ~/.claude/commands/*.md | Доступны как /name; навык с тем же именем важнее |
| Субагенты | .claude/agents/*.md, ~/.claude/agents/*.md | Загружает вместе с их инструментами, моделью, режимом разрешений, навыками, MCP-серверами и хуками |
| Хуки | hooks в любом файле настроек | Те же события, матчеры, типы обработчиков, коды выхода и вывод JSON |
| MCP-серверы | .mcp.json, ~/.claude.json (пользовательские и проектные записи) | Подключает по stdio или HTTP с одобрением для проекта |
| Стили ответов | .claude/output-styles/, ~/.claude/output-styles/ | Загружает по имени |
Что переносит импорт
Некоторые агенты хранят настройки в форматах, которые Cusp не читает напрямую. Импорт переводит их в файлы .cusp/. Он копирует и никогда не перемещает и не удаляет исходные файлы.
| Источник | Что переносится |
|---|---|
Claude Code (.claude/, ~/.claude/) | Настройки объединяются в .cusp/settings.json; субагенты, команды, навыки, стили ответов и правила копируются в .cusp/, и проект больше не зависит от .claude/ |
Codex CLI (.codex/config.toml, ~/.codex/) | MCP-серверы; approval_policy и sandbox_mode — как ближайший режим разрешений; промпты из ~/.codex/prompts/ — как команды; AGENTS.override.md — как правило. Профили перечисляются, но не переносятся |
Gemini CLI (.gemini/settings.json, ~/.gemini/) | MCP-серверы, исключённые и разрешённые инструменты — как правила разрешений, TOML-команды — как команды в Markdown ({{args}} становится $ARGUMENTS). Читаются обе схемы настроек. Расширения перечисляются, чтобы вы установили их сами |
Cursor (.cursor/, ~/.cursor/) | .cursor/rules/*.mdc: правила «всегда» становятся правилами, правила по маскам — правилами для путей, правила только с описанием — навыками, ручные — командами. А также устаревший .cursorrules, .cursor/mcp.json, .cursor/commands/*.md и разрешения CLI из .cursor/cli.json |
Секреты не переносятся. API-ключи и токены в файлах MCP и настроек превращаются в ссылки ${VAR}, а в конце импорт перечисляет переменные, которые нужно задать. Настройки, которые пропускают одобрения или перенаправляют трафик, остаются выключенными, пока вы их не выберете.
В десктопном приложении
При первой настройке Cusp шаг Перенесите свои настройки показывает агентов, найденных на компьютере. Посмотреть, что перенесётся показывает каждый пункт с флажком и точные изменения файлов, прежде чем что-то будет записано.
Из CLI
cusp import codex --dry-run # показать изменения, ничего не записывать
cusp import cursor # импортировать настройку Cursor этого проекта
cusp import gemini --user # пользовательские настройки вместо проектныхИсточник — одно из claude-code, codex, gemini или cursor. --all импортирует и проектный, и пользовательский уровень. --force заменяет существующие файлы .cusp/, если они отличаются; по умолчанию они сохраняются.
Как уживаются .cusp/ и общие файлы
Везде, где Cusp читает общий путь в .claude/, он читает и соответствующий путь в .cusp/. На одном уровне побеждает .cusp/:
| Что | Файл Cusp | Общий файл | При конфликте |
|---|---|---|---|
| Настройки проекта | .cusp/settings.json | .claude/settings.json | Побеждает .cusp/ |
| Локальные настройки | .cusp/settings.local.json | .claude/settings.local.json | Побеждает .cusp/ |
| Пользовательские настройки | ~/.cusp/settings.json | ~/.claude/settings.json | Побеждает ~/.cusp/ |
| Инструкции | CUSP.md, .cusp/CUSP.md | AGENTS.md, CLAUDE.md, GEMINI.md | Загружаются все; CUSP.md идёт позже, поэтому при противоречиях побеждает он |
| Навыки | .cusp/skills/ | .claude/skills/, .agents/skills/ | При совпадении имён побеждает найденный первым, сначала .cusp/ |
| Субагенты | .cusp/agents/ | .claude/agents/ | При совпадении имён побеждает .cusp/ |
| MCP-серверы | .cusp/mcp.json, ~/.cusp/mcp.json | .mcp.json, ~/.claude.json | При совпадении имён побеждает .cusp/ |
Так что общие файлы можно и дальше делить с коллегами, которые работают с другими агентами, а настройки только для Cusp держать в .cusp/.
Cusp загружает все найденные файлы инструкций, поэтому в проекте с AGENTS.md и CLAUDE.md загрузятся оба. Если в них написано одно и то же, в контексте это окажется дважды. Чтобы пропустить файл, используйте claudeMdExcludes в настройках.
Имена инструментов и правил
Инструменты Cusp используют те имена и поля ввода, под которые написаны существующие хуки, правила разрешений и навыки: Read, Write, Edit, MultiEdit, Bash, Grep, Glob, WebFetch, Agent, Skill, с полями file_path, old_string, new_string, command и так далее.
Некоторые модели видят другие имена. Модели семейства GPT редактируют через apply_patch и планируют через update_plan, потому что на этом их обучали. Хуки и правила разрешений всегда видят каноническое имя, поэтому правило Edit(src/**) распространяется и на ApplyPatch, и на EditLines. См. Инструменты.
Режимы разрешений
| Режим | Поведение |
|---|---|
default (вручную) | Спрашивает перед правками, командами и доступом к сети |
acceptEdits | Правки файлов в рабочей папке одобряются автоматически |
plan | Только чтение, пока вы не одобрите план |
auto | Быстрая модель-классификатор одобряет действия с низким риском |
bypass | Разрешено всё, кроме правил запрета и защищённых путей. bypassPermissions принимается как синоним |
dontAsk (CLI) | Всё, что потребовало бы вопроса, запрещается |
Настройки проекта и локальные настройки не могут сделать auto или bypassPermissions режимом по умолчанию. Это можно только в пользовательских настройках. См. Разрешения.
Хуки
Cusp поддерживает пять типов обработчиков (command, http, mcp_tool, prompt, agent) и полный список событий, включая PreToolUse, PostToolUse, UserPromptSubmit, Stop, SessionStart и PreCompact. Код выхода 2 блокирует, JSON в stdout принимает решение, заданы и ${CLAUDE_PROJECT_DIR}, и CUSP_PROJECT_DIR, а также CUSP_HOOK_EVENT. См. Хуки.
Скрипт хука, который проверяет tool_name == "Edit", увидит правки моделей GPT как вызовы семейства Edit с именем ApplyPatch. Если скрипт фильтрует по точному имени инструмента, добавьте в список ApplyPatch, MultiEdit и EditLines или проверяйте tool_input.file_path.
Что пока не переносится
- Автопамять, записанная другими агентами, не читается. У Cusp своя автопамять.
- Встроенные расширения интерфейса, которые меняют интерфейс другого агента, в Cusp не имеют аналога.
- Файлы сочетаний клавиш других агентов. Сочетания Cusp перечислены в разделе Сочетания клавиш.
- Расширения Gemini CLI импорт перечисляет, но не устанавливает. Плагины в формате
.claude-pluginустанавливаются черезcusp plugin; см. Hub.
Как проверить, что загрузилось
Выполните /status в CLI, чтобы увидеть демон, сессию, модель и рабочую папку. Файлы настроек, которые не удалось разобрать, показываются с путём и причиной; неверный ключ отбрасывается с предупреждением, а не весь файл целиком.