--- title: "Советы и устранение проблем" id: "354" type: "page" slug: "tips" published_at: "2026-05-19T11:30:47+00:00" modified_at: "2026-07-01T17:00:04+00:00" url: "https://pastukhov.com/agent/docs/tips" markdown_url: "https://pastukhov.com/agent/docs/tips.md" excerpt: "Практические советы для максимального использования Pastukhov Agent, ответы на общие вопросы и шаги по устранению…" --- # Советы и устранение проблем [https://pastukhov.com/agent/docs/tips.md](https://pastukhov.com/agent/docs/tips.md) Практические советы для максимального использования Pastukhov Agent, ответы на общие вопросы и шаги по устранению неполадок, когда что-то работает не так, как ожидалось. ## Советы для эффективного AI-кодирования - **Будьте конкретны** — Чем больше деталей вы дадите, тем лучше AI поймёт ваш запрос. Вместо «исправь кнопку» скажите «кнопка отправки на контактной форме не проверяет формат электронной почты — добавь проверку электронной почты с использованием регулярного выражения» - **Разбивайте большие задачи на меньшие** — Вместо «построй всё приложение», начните с одной функции за раз. AI работает лучше всего с сфокусированными, хорошо определёнными запросами - **Используйте навыки** — Выберите правильный навык для задачи с помощью селектора навыков. Навык «code review» даст другие результаты, чем навык «development» для одного и того же кода - **Итерируйте** — Если первый ответ не идеален, попросите улучшения, вместо того чтобы начинать заново. «Сделай заголовок крупнее и измени цвет на синий» быстрее, чем переописывать всё требование - **Предоставляйте контекст** — Упомяните соответствующие имена файлов, имена функций или шаблоны, которые вы хотите, чтобы AI следовал. «Обнови функцию formatDate в src/utils/date.ts для обработки европейского формата даты» ## Общие вопросы **Как подключить свой собственный проект?** Перенастройте ваши [переменные среды](/agent/docs/environments) (путь к проекту, URL git, учётные данные) и перезапустите Pastukhov Agent. Смотрите раздел [Начало работы](/agent/docs/getting-started) и руководства по установке для [Windows](/agent/windows) или [Docker](/agent/docker) для получения подробной информации. **Могу ли я использовать несколько AI-моделей?** Да. Создайте несколько [окружений](/agent/docs/environments) в настройках, каждое с другой моделью и API-ключом. Переключайтесь между ними с помощью селектора окружений в поле ввода чата. **Что происходит, когда AI совершает ошибку?** AI видит ошибки сборки и может исправить их автоматически, если включена функция [Автоисправление](/agent/docs/autofix) . Вы также можете сказать AI, что пошло не так, и попросить его исправить проблему. AI читает сообщения об ошибках из [панели сборки](/agent/docs/build-deploy) и использует их как контекст для исправлений. **Могу ли я делиться навыками между проектами?** Навыки хранятся в папке `.claude/skills/` внутри проекта и коммитятся вместе с ним. Для совместного использования навыков между проектами вы можете скопировать папку навыков из одного проекта в другой, либо попросить ИИ создать аналогичные навыки на основе существующих как шаблоны. Смотрите раздел [Навыки](/agent/docs/skills) для получения подробной информации. **Как создать резервную копию моих данных?** Ваши файлы проекта находятся в вашем git-репозитории — регулярно делайте коммиты и отправляйте их. История чата и настройки хранятся в локальной базе данных. Создайте резервную копию файла базы данных или настройте постоянную базу данных для производственного использования. **Являются ли мои данные частными?** Ваш код работает локально в вашем собственном контейнере или экземпляре. Сообщения чата отправляются поставщику AI, который вы настроили (например, Anthropic или OpenAI). Данные аналитики остаются локальными, если вы не настроили отправку в ClickHouse для централизованной отчётности. ## Проблемы с подключением **Не удается связаться с AI:** Проверьте, что ваш API-ключ действителен и что у вас есть доступные API-кредиты у вашего поставщика. Проверьте API-ключ в вашей [конфигурации окружения](/agent/docs/environments) . **Не удается отправить или получить изменения Git:** Убедитесь, что ваши учётные данные git (логин, токен личного доступа) настроены в переменных среды. Смотрите раздел [Git](/agent/docs/git) для получения подробной информации. **Контейнер не запускается:** Проверьте журналы Docker на наличие ошибок запуска. Общие причины включают неправильные [переменные среды](/agent/docs/environments) , конфликты портов или отсутствующие файлы конфигурации. **Порт уже используется:** Другая служба использует порт, на котором настроен Pastukhov Agent. Измените порт в вашей конфигурации или остановите конфликтующую службу. ## Советы по производительности - **Большие проекты** — Pastukhov Agent обрабатывает большие кодовые базы, но производительность зависит от выделенных ресурсов вашего контейнера. Увеличьте память и CPU, если вы работаете с очень большими проектами - **Длинные разговоры** — Очень длинные сессии чата используют больше токенов и могут замедлиться. Начните новую сессию, когда контекст разговора больше не актуален для вашей текущей задачи - **Скорость сборки** — Если вам не нужна полная среда разработки, используйте минимальный образ Docker для более быстрых сборок и развёртываний - **База данных** — Для лучшей производительности со временем при многих сессиях чата рассмотрите возможность использования PostgreSQL вместо SQLite ## Получение помощи Если вы попробовали вышеуказанные шаги по устранению неполадок и всё ещё нужна помощь: - **Telegram** — Напишите `@maxedant` для прямой поддержки (самый быстрый ответ) - **Электронная почта** — Отправьте сообщение на `max@pastukhov.com` - **Страница FAQ** — Посетите [FAQ](/agent/faq) для дополнительных ответов на общие вопросы Время ответа обычно в течение 12 часов, включая выходные. При обращении в поддержку включите описание проблемы, любые сообщения об ошибках и шаги для воспроизведения проблемы. **[← Горячие клавиши](/agent/docs/shortcuts)** **[MCP-серверы →](/agent/docs/mcp)**