---
title: "Советы и устранение проблем"
id: "354"
type: "page"
slug: "tips"
published_at: "2026-05-19T11:30:47+00:00"
modified_at: "2026-10-04T08:47:46+00:00"
url: "https://pastukhov.com/agents/agent/docs/tips"
markdown_url: "https://pastukhov.com/agents/agent/docs/tips.md"
excerpt: "Практические советы, как получить от Pastukhov Agent максимум пользы, ответы на частые вопросы и шаги…"
---

# Советы и устранение проблем

[https://pastukhov.com/agents/agent/docs/tips.md](https://pastukhov.com/agents/agent/docs/tips.md)

Практические советы, как получить от Pastukhov Agent максимум пользы, ответы на частые вопросы и шаги для решения типичных проблем, когда что-то работает не так, как ожидалось.

## Как просить ИИ — несколько советов

- **Будьте конкретны** — чем больше деталей, тем лучше модель поймёт задачу. Вместо «исправь кнопку» скажите: «кнопка отправки в форме обратной связи не проверяет адрес электронной почты — добавь проверку». Хороший запрос уже содержит половину ответа.
- **Делите большие задачи на маленькие** — вместо «сделай всё приложение» начинайте с одной функции за раз. Модель лучше всего работает с понятными, сфокусированными задачами.
- **Используйте навыки** — выбирайте подходящий навык для задачи через селектор навыков. Навык «code review» для одного и того же кода даст другой результат, чем навык «development»: каждый навык — это свои инструкции для модели.
- **Итерируйте** — если первый ответ не идеален, попросите доработать его, а не начинать заново. «Сделай заголовок крупнее и поменяй цвет на синий» — быстрее, чем заново описывать всё требование.
- **Давайте контекст** — упоминайте имена нужных файлов, функций или образцы кода, которым модель должна следовать. Например: «Обнови функцию formatDate в src/utils/date.ts, чтобы она понимала европейский формат даты».

## Частые вопросы

**Как подключить свой собственный проект?**

Задайте свои [переменные окружения](/agents/agent/docs/models)
 (путь к проекту, адрес Git-репозитория, учётные данные) и перезапустите Pastukhov Agent. Подробности — в разделе [Начало работы](/agents/agent/docs/getting-started)
 и в инструкциях по установке для [Windows](/agents/agent/windows)
 или [Docker](/agents/agent/docker)
.

**Можно ли использовать несколько моделей ИИ?**

Да. Создайте несколько [моделей](/agents/agent/docs/models)
 в настройках — по одной на каждую модель ИИ и её API-ключ — и переключайтесь между ними через селектор моделей в области ввода сообщений.

**Что будет, если модель ошибётся?**

Модель видит ошибки сборок и может исправить их сама, если включено [Автоисправление](/agents/agent/docs/autofix)
. Также вы можете просто сказать ей, что пошло не так, и попросить исправить: модель прочитает тексты ошибок из [панели сборки](/agents/agent/docs/build-deploy)
 и использует их как контекст для починки.

**Можно ли переносить навыки между проектами?**

Навыки хранятся в папке `.claude/skills/` внутри проекта и сохраняются вместе с ним. Чтобы перенести навык в другой проект, скопируйте папку навыков, либо попросите модель создать похожие навыки на основе существующих как шаблонов. Подробности — в разделе [Навыки](/agents/agent/docs/skills)
.

**Как сделать резервную копию данных?**

Файлы проекта — в вашем Git-репозитории: делайте коммиты и отправляйте их на сервер регулярно. История чатов и настройки хранятся в локальной базе данных: сохраняйте копию файла базы данных, а для постоянной эксплуатации можно настроить внешнюю базу данных.

**Насколько мои данные приватны?**

Ваш код обрабатывается локально — в вашем собственном контейнере или экземпляре. В облако уходят только сообщения чата, которые вы отправляете поставщику ИИ (например, Anthropic или OpenAI). Данные аналитики остаются локальными, если вы сами не настроили их отправку в ClickHouse для единой отчётности.

## Проблемы с подключением

**ИИ не отвечает:** проверьте, что ваш API-ключ действителен и на балансе у поставщика есть средства. Посмотрите ключ в [конфигурации модели](/agents/agent/docs/models)
. Если сервер выходит в интернет через прокси (например, в корпоративной сети), задайте переменные `HTTP_PROXY` и `HTTPS_PROXY` с адресом прокси, а в `NO_PROXY` перечислите адреса, которые нужно обходить, — тогда запросы к поставщикам ИИ пойдут через прокси.

**Не получается отправить или получить изменения Git:** убедитесь, что учётные данные Git (логин, личный токен доступа) заданы в переменных окружения. Подробности — в разделе [Git](/agents/agent/docs/git)
.

**Контейнер не запускается:** посмотрите журналы Docker на ошибки запуска. Обычные причины — неверные [переменные окружения](/agents/agent/docs/models)
, занятый порт или отсутствующие файлы конфигурации.

**Порт уже занят:** другая программа использует порт, который нужен Pastukhov Agent. Измените порт в конфигурации или остановите конфликтующую программу.

## Советы по скорости

- **Большие проекты** — агент умеет работать с большими кодовыми базами, но скорость зависит от ресурсов вашего контейнера. Для очень крупных проектов увеличьте память и процессорное время, выделенные контейнеру.
- **Длинные разговоры** — очень длинные сессии тратят больше токенов и могут замедляться. Начинайте новый чат, когда прежний контекст уже не нужен для текущей задачи.
- **Скорость сборки** — если полное окружение разработки не нужно, используйте компактный образ Docker — сборки и запуск будут быстрее.
- **База данных** — при большом числе чатов со временем PostgreSQL работает лучше, чем SQLite. Подумайте о переходе, если проект активно растёт.

## Куда обратиться за помощью

Если советы выше не помогли, а проблему решить не удалось:

- **Telegram** — напишите `@maxedant` для личной поддержки (быстрее всего);
- **Электронная почта** — отправьте письмо на `max@pastukhov.com`;
- **FAQ** — посмотрите страницу [FAQ](/agents/agent/faq) , там собраны ответы на частые вопросы.

Обычно отвечаем в течение 12 часов, включая выходные. В обращении опишите проблему, приложите тексты ошибок и шаги, которые приводят к проблеме, — так мы решим её быстрее.

**[← Горячие клавиши](/agents/agent/docs/shortcuts)**

**[MCP-серверы →](/agents/agent/docs/mcp-servers)**