Частые вопросы и ответы на них

Подробные инструкции лежат в материалах уроков и в канале Мастерской. Если вопрос относится к базе знаний, хранилищу, скиллам или памяти агента, сначала открывайте соответствующий урок и идите по шагам.

Идите по блоку на платформе, а ссылки из чата используйте как вспомогательные. Для базовой настройки логика такая:

1. Собираем Базу Знаний: СМОТРЕТЬ
2. Покупка сервера Beget или AdminVPS или подготовка компьютера (просто сдуть пыль с компа!)
3. Сборка агента: СМОТРЕТЬ
4. Добавляем агента в мессенджеры (ТГ, Макс, ВК): СМОТРЕТЬ
5. Контент-завод: СМОТРЕТЬ
6. Проводим чек-лист работы агента: СМОТРЕТЬ
7. Решаем свои задачи с агентом (боты, сайты): СМОТРЕТЬ

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

Сначала смотрите на действие, которое нужно сделать: открыть папку, войти в аккаунт, установить расширение, доверить папку или запустить чат агента. Картинка в уроке может немного отличаться от вашего экрана.

Если окно отличается, пришлите скриншот всего экрана агенту или ИИ-чату и напишите:

• где делаете агента: компьютер или сервер;
• какая нейросеть: ChatGPT/Codex или Claude;
• какая инструкция и шаг;
• что именно нажали перед ошибкой.

В Telegram Web функции экспорта нет. Для выгрузки нужен Telegram Desktop: отдельная программа Telegram на компьютере.

CSV подойдет, если другого варианта нет. Если можно выбрать формат, берите JSON.

JSON удобнее для агента: в нем отдельно записаны автор, дата, текст, вложения и ответы на сообщения. Так агенту проще понять, кто что спросил и к какому вопросу относится ответ.

Сам канал или чат и есть текст. Отдельной кнопки «текст» может не быть.

Если нужен только текстовый экспорт, в настройках экспорта уберите галочку «Фото» и запустите экспорт.

Проверьте 2 вещи:

• вы вошли в тот аккаунт Telegram, которому открыт доступ
• ссылка ведет в канал или чат, куда вас уже добавили

Если ссылка из урока ведет на Telegram, а не открывается в браузере, попробуйте открыть ее через приложение Telegram Desktop.

Да. Агент может работать на вашем компьютере или на сервере.

Компьютерный вариант подходит, если вы работаете за своим ноутбуком или ПК и готовы держать его включенным.

Серверный вариант нужен, если агент должен держать ботов и сайты, работать без вашего компьютера и быть доступным с разных устройств.

Это 2 разные настройки: одна на компьютере, другая на сервере.

Они могут делать похожие задачи, но файлы, доступы и папки у них разные. Настройка агента на компьютере не создает такого же агента на сервере.

Для старта достаточно иностранного сервера, если вы настраиваете агента по урокам.

Российский сервер можно подключить позже, когда появятся боты, сайты или задачи с данными клиентов в РФ.

Это нормальное окно. Beget сначала просит пополнить баланс, потому что сервер создается только после оплаты.

Пополните баланс минимум на 100 рублей. После этого вернитесь к созданию сервера: провайдер покажет данные для входа.

SSH нужен только для подключения к серверу.

Если агент установлен на вашем компьютере, надписи вида MYAGENT [SSH...] обычно нет. Это нормально: вы работаете локально, без удаленного подключения.

На старых Windows можно попробовать старую версию VS Code. Последняя версия, которая стабильно работала на Windows 7, 8 и 8.1, - 1.70.3.

Но расширения Codex или Claude Code могут не работать на старой системе. Надежнее обновить Windows или использовать серверный вариант, где все настраивается не на вашем компьютере.

Если не знаете, какой процессор в Mac, выбирайте универсальный файл.

Если знаете процессор, выбирайте так:

• Intel Chip - для старых Mac на Intel
• Apple Silicon - для Mac на M1, M2, M3 или M4

Если агент живет на сервере, к нему можно подключаться с разных устройств.

Если агент живет на компьютере, он привязан к этому компьютеру и его папкам.

Не запускайте 2 агентов в одной и той же папке одновременно. Они могут начать менять одни и те же файлы и запутать проект.

Можно установить приложение Codex отдельно.

В уроках чаще используется VS Code, потому что там агент видит папки, файлы и проект. Так проще сохранять материалы, править код, работать с хранилищем и проверять результат.

GitHub подключать не нужно для базовой настройки.

Если VS Code предлагает войти через GitHub, выберите продолжение без входа (Continue without Signing In). Это не сломает установку агента.

Если вы настравиаете агента на компьютере, выбирайте вход с помощью ChatGPT.

API-ключ в этом шаге не нужен. Код устройства тоже выбирайте только тогда, когда это прямо показано в вашей инструкции (для агента на сервере).

На экране это черная кнопка «Войти с помощью ChatGPT».

Для базовой настройки агента GitHub не нужен.

Если VS Code предлагает войти в GitHub или подключить GitHub Copilot, этот шаг можно пропустить. Агент будет работать через Codex или Claude, а не через GitHub.

Да, агент будет работать только на платной версии ChatGPT на тарифе Plus (20$).

Можно. Но для одной конкретной папки лучше выбрать одного помощника: Codex или Claude Code.

Не давайте двум помощникам одновременно править одну и ту же папку. Они могут внести разные изменения и запутать проект.

Если хотите использовать оба инструмента, разделите задачи. Например: Claude - для текстов и контент-завода, Codex - для технических задач. Еще вариант - сделать отдельных ботов под Claude и Codex.

Установите русский языковой пакет MS-CEINTL.vscode-language-pack-ru из Marketplace. Marketplace - это магазин расширений внутри VS Code.

Если команда смены языка не срабатывает на Mac, переключите клавиатуру на английскую раскладку и повторите шаг.

Попробуйте по этой ссылке нажать установить, должен перекинуть в VS Code и там будет кнопка Установить

Сначала проверьте 3 вещи:

• расширение Codex установлено
• вы нажали вход через ChatGPT
• вход открывается в том браузере, где вы уже вошли в ChatGPT

Если видите ошибку token_exchange_failed, сделайте скриншот и напишите ИИ-чату, где именно входили: приложение Codex, VS Code, браузер, сервер или компьютер.

Если VS Code пишет, что расширение отключено, потому что папка не доверенная, нужно разрешить работу в этой папке.

Ищите кнопку или ссылку со смыслом (обычно в нижнем левом углу) «доверять папке», «разрешить» или Enable (Workspace).

Claude Code требует авторизации, вы её проходите и получаете ошибку 403. В браузере всё работает.

403 = «Доступ запрещён» - claude видит ваш запрос на авторизацию, но что-то между VS Code и серверами Anthropic блокирует соединение. Если в браузере Claude работает нормально, а в VS Code — нет, значит проблема в самом VS Code или в настройках сети вашего компьютера.

Что может блокировать соединение:

• Регион в вашем инструменте из 3х букв. Возможно, он не поддерживается Anthropic. Чтобы это узнать спросите Claude в браузере: "Поддерживается ли этот регион [УКАЖИТЕ РЕГИОН ИЗ ВПН] в Claude Code". Попробуйте сменить регион, а лучше впн. Иногда даже нужно сменить само приложение, через которое подключаете впн.
• Claude Code установился неправильно. Переустановите расширение Claude Code (удалите и установите заново)
• Антивирус мешает. Kaspersky, ESET и другие могут проверять HTTPS-соединения, что может помешать авторизации в вашем аккаунте через Claude Code. Попробуйте отключить антивирус и авторизоваться еще раз
• Старые токены сохранились в системе и мешают новой авторизации. Либо вы слишком долго подтверждали авторизацию и ваша ссылка устарела. Тогда попробуйте пройти авторизацию заново и не медлить с подтверждением аккаунта по выданной ссылке или коду от Claude Code

Скиллы можно отправлять агенту прямо в чат так же, как в уроке.

После отправки дождитесь, пока агент напишет, что установка завершена. Не закрывайте окно во время установки, если агент еще работает.

Такое бывает. На компьютере скиллы могут сохраняться в служебные папки агента, а не прямо в той папке, которую вы выбрали для агента, например, CodexAgent.

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

Проверь, где установлены мои скиллы, и покажи список установленных скиллов

20 минут может быть нормальным временем установки.

Если агент пишет, что работает, и не просит нажать кнопку или ввести команду, просто ждите. Если прошло больше 40 минут без изменений, спросите:

Ты еще работаешь или завис? Напиши короткий статус: что уже сделано и что осталось

Выбирайте вариант, где Claude подготовит точные команды.

После этого Claude напишет команды текстом. Их нужно будет скопировать и вставить в терминал Claude Code вручную, если вам не понятно, что и куда, то просто попросите его пояснить.

Сначала проверьте 2 вещи:

• вы открыли актуальную инструкцию
• в VS Code открыта нужная папка

Если агент пишет, что не хватает файла, скачайте файл по ссылке из урока и положите его туда, куда просит агент.

Если он завис или долго работает, попросите его коротко объяснить текущий статус: «Что ты сейчас делаешь? Какие файлы уже установлены? Что осталось?»

Выбирайте первый вариант: поставить build-essential.

Это технический набор инструментов для сборки. Иногда он нужен, чтобы бот или библиотека установились на сервере.

Хранилище - это главная папка с вашей базой знаний. Внутри лежат правила, карты, шаблоны, заметки, материалы, продукты, аудитория и контент.

Агент читает эту папку, чтобы понимать, кто вы, чем занимаетесь, как писать вашим голосом и куда сохранять новые материалы.

Обычно хранилище называется obsidian-vault.

На этом шаге агент создает пустую структуру базы знаний: папки, правила, карты, шаблоны и инструкции.

Сами заметки, расшифровки, кейсы и материалы можно загрузить позже.

Главная идея: сначала создать систему, а потом постепенно наполнять ее материалами.

Есть два способа:

1. Отправить файл агенту и написать: «Сохрани это в хранилище».
2. Положить файл в 00_Inbox и написать: «Разбери входящие и сохрани в хранилище».

00_Inbox - это папка для новых материалов, которые еще не разобраны. Если скилл хранилища уже загружен, агент сам разложит файлы по нужным разделам.

Заново проходить первичную настройку не нужно.

Положите новые материалы в 00_Inbox и напишите агенту:

Изучи новые данные во входящих и разнеси куда положено

Если хотите сначала проверить, что агент видит, напишите:

Покажи, какие файлы ты видишь во входящих, и предложи план сортировки. Пока ничего не перемещай без моего подтверждения

Да. Базу можно дополнять в любое время.

Если появилось новое направление, продукт или аудитория, напишите агенту, что изменилось, и попросите предложить место для новых материалов. Например:

У меня появилось новое направление: [название]. Предложи, куда добавить материалы в хранилище, и пока ничего не меняй без моего подтверждения

00_Inbox - это папка для входящих материалов.

Туда можно складывать сырые заметки, документы, расшифровки, идеи, отзывы и другие файлы. Потом агент разберет их и разложит по базе знаний.

Это временный вход для новых файлов, а постоянное хранение находится в других папках хранилища.

Папку 00_Inbox нужно очищать внутри: удалять или переносить файлы после обработки.

Саму папку лучше не удалять. Агент ожидает, что она есть в хранилище.

Если 00_Inbox удалили, создайте ее заново или попросите агента:

Создай в хранилище папку /obsidian-vault/00_Inbox

Попросите агента показать точный путь к хранилищу:

Напиши полный путь до папки с хранилищем на моем компьютере

Потом откройте эту папку на компьютере или сервере и положите материалы в 00_Inbox.

Если файлов много, загружайте частями: сначала 5-10 файлов, потом следующую пачку.

Да, можно. Но после изменения структуры скажите агенту, чтобы он обновил правила работы с хранилищем.

Иначе агент может продолжить искать файлы по старым папкам.

Пример:

Я поменяла структуру папок в хранилище. Проверь новую структуру и обнови свои правила работы с ней

Да. Можно открыть файл в VS Code и исправить нужные места вручную.

После правки напишите агенту, какой файл вы изменили и что именно поправили. Так он поймет, что в базе появилась новая версия.

Если создаете новое хранилище по инструкции, выбирайте ~/obsidian-vault или путь, который указан в уроке.

Если хранилище уже есть, выбирайте вариант с существующей папкой и указывайте точный путь до нее.

Obsidian - это программа, в которой удобно смотреть и редактировать базу знаний как обычные заметки.

Для агента важна сама папка с .md-файлами. Obsidian нужен вам, чтобы видеть структуру, читать материалы и править заметки без технического интерфейса.

В Obsidian нажмите «Открыть папку как хранилище» и выберите папку obsidian-vault.

Если хранилище синхронизируется с сервером, после настройки туда подтянутся файлы из серверной папки.

Яндекс.Диск использовать не обязательно. Можно взять другое облако, но тогда настройка будет отличаться от урока.

Если хотите идти точно по инструкции, используйте тот вариант синхронизации, который показан в уроке.

Самый простой способ - смотреть файлы прямо в VS Code.

Откройте папку проекта, найдите нужный файл в левой панели и кликните по нему. Текст откроется в редакторе.

Пример структуры в VS Code:

База и файлы сохранятся на компьютере или сервере.

Если оплата GPT закончилась, временно пропадет доступ к платным возможностям модели. После оплаты можно продолжить работу с теми же файлами.

Постоянные правила фиксируются в системных инструкциях агента, например в AGENTS.md.

Туда можно добавлять правила формата ответа, тона, работы с файлами, клиентами, контентом и памятью. Если не знаете, куда именно сохранять правило, попросите агента:

Сохрани это как постоянное правило и покажи, в какой файл ты его добавил

Основную работу можно делать через агента: давать задания, работать с файлами, базой знаний, контентом и настройками.

Обычный ChatGPT можно оставить для быстрых вопросов, идей и проверки формулировок. Агент нужен там, где нужно видеть папки, сохранять файлы и работать с вашим хранилищем.

Пишите задачу конкретно:

• что нужно сделать;
• в какой папке искать материалы;
• какой результат нужен;
• можно ли менять файлы или сначала показать план.

Хорошая формулировка:

Проверь папку 00_Inbox, покажи список файлов, предложи план сортировки. Пока ничего не перемещай без моего подтверждения

Если задача техническая, добавьте контекст:

Я работаю на [компьютере / сервере], в [Codex / Claude], на шаге [номер]. Вот что хочу сделать: ...

Не пишите только «плохо» или «не так». Распишите по пунктам:

• что именно не понравилось;
• в каком формате или виде контента;
• как должно быть;
• что нужно зафиксировать на будущее.

После этого попросите агента сохранить правило и показать, куда он его записал.

Дайте точный путь или название папки и попросите сохранить это в памяти.

Пример:

Для клиента Кати папка называется "Клиенты/Катя". Сохрани это правило и используй его, когда я прошу работать с материалами Кати

Да. Агент может объяснить ошибку, предложить план, посмотреть папки и иногда проверить технические файлы.

Если задача может что-то удалить, переустановить или изменить доступы, сначала просите план:

Сначала объясни, что ты собираешься сделать. Ничего не меняй без моего подтверждения

Если Telegram-бот пишет, что не может сохранять файлы, он сейчас не имеет доступа к нужной папке. Просто попросите агента исправить это.

Да. Если бот видит obsidian-vault, перечисляет папки и пишет, что может искать по базе, сохранять заметки и обновлять MOC-файлы, доступ к хранилищу подключен.

MOC-файлы - это карты разделов. Они помогают агенту и вам быстро понимать, где что лежит.

Если это просто рекомендация VS Code в правом нижнем углу, устанавливать расширение не обязательно.

Можно закрыть подсказку крестиком и продолжить урок. Если агент сам попросит Python для конкретной задачи, тогда вернитесь к установке.

Можно разделить задачи так:

• Claude - тексты, контент-завод, презентации, сайты;
• ChatGPT - остальные задачи, проверка, картинки, технические вопросы.

Так задачи меньше смешиваются, а лимиты расходуются ровнее.

Чтобы контент-завод писал ближе к вашему голосу, стиль нужно сохранить в базе агента:

• собрать Tone of Voice;
• дать примеры текстов;
• сохранить правила письма в хранилище;
• попросить агента использовать эти правила при генерации.

Если стиль уже согласован в отдельном чате, попросите агента сделать из него отдельный файл правил. Потом этот файл можно подключать к контент-заводу.

Дайте обратную связь по пунктам:

• что именно сухо;
• какие фразы не похожи на вас;
• какие примеры хороши;
• какой тон нужен;
• где это сохранить.

Потом попросите агента обновить правила стиля и показать, какой файл он изменил.

Попросите агента:

Дай мне путь к папке с моим ботом Telegram

Он должен вывести точный путь. Его и используйте в инструкции.

Путь выглядит примерно так: /home/myagent/agent_bot или C:\Users\...\agent_bot. Копируйте его полностью, без сокращений.

Да. Бота можно создать и пока не запускать для реальных пользователей.

ТЗ редактируйте только под свою задачу: названия призов, описания, тексты сообщений, количество попыток и условия. Картинки для призов можно добавить позже.

Да, если нужные сервисы подключены технически.

Агент получает доступ к CRM, MAX, VK или Telegram только после технического подключения.

Обычно для этого нужны ключи или токены. Это специальные коды доступа, по которым сервис понимает, что агенту можно выполнять действия.

Сначала нужно понимать, через какой сервис идет рассылка и какие доступы есть.

Сам бот не будет автоматически обращаться к двум помощникам одновременно.

Для создания бота выберите одну ветку: Codex или Claude Code. Второго помощника можно использовать позже для проверки или доработки, но не запускайте их одновременно в одной папке, это может привести к конфликтам и ощибкам в обновлении ваших документов, с которыми они будут работать.

Нет, не стоит. Лучше свой аккаунт с ИИ подключать к ботам только для себя. Или еще для 1-2 членов команды. Т.к. иначе есть риск бана за странно большую активность в аккаунте.

Рекомендую подключать ИИ к боту через агрегатора нейростей с API. Например, PolzaAI: https://polza.ai/?referral=TT4TxkVwXZ

Чтобы все настроить, просто скажите агенту, чтобы он настроил ИИ в боте через PolzaAI. Сначала зарегистрируйтесь в этом сервисе сами по ссылке выше, затем дайте ссылку агенту. Он подскажет, что еще ему будет нужно и где это взять.

Да, если нужную задачу можно собрать кодом.

Агент может написать бота или сайт как проект с файлами. Потом этот проект можно править через агента или программиста.

Если раньше вы использовали конструктор только для простой логики, агент может заменить его. Если в конструкторе есть сложные личные кабинеты, оплаты, CRM и другие интеграции, сначала нужно отдельно разобрать задачу.

Агент может жить на одном сервере, а боты и сайты - на другом. Это нормально.

Если бот или сайт собирает данные клиентов, заранее решите, где эти данные будут храниться. Для персональных данных клиентов обычно нужен российский сервер.

HTML-интерактив - это отдельная страница или мини-приложение в файлах.

Сначала проверьте его локально, то есть у себя на компьютере или сервере: текст, кнопки, логику и отображение на телефоне. Когда все работает, можно решать, где публиковать: на хостинге, в GitHub Pages или другим способом.

GitHub Pages - это один из вариантов публикации простой HTML-страницы в интернете.

Сохранится все, что попало в архив на момент создания бэкапа.

Если контент-завод уже был настроен и его папки попали в архив, он тоже сохранится.

Главное - не удалять старый сервер или старую папку, пока не проверили архив на новом месте.

.tar.gz - это архив из Linux. Windows не всегда открывает его обычным двойным кликом.

Попробуйте распаковать через 7-Zip в два шага:

1. Сначала распаковать .tar.gz.
2. Потом распаковать получившийся .tar.

Скачать 7-Zip можно тут: СКАЧАТЬ

Напишите в поддержку хостинга.

Коротко опишите ситуацию: вы сделали архив сервера, скачали его, но архив не открывается или внутри не хватает файлов. Спросите, есть ли у провайдера автоматический бэкап старого сервера.

Проверьте, что в архиве есть:

• obsidian-vault;
• папка с ботом или проектом;
• системные инструкции агента;
• память агента, если она уже создана;
• рабочие файлы проекта;
• правила и скиллы, если они лежат в папке агента.

Не нажимайте наугад. Сделайте скриншот всего окна, чтобы были видны левая панель, верхняя строка и сообщение об ошибке. И отправьте агенту или любому ИИ-чату.

К скриншоту напишите:

• какие инструкции проходите;
• какой шаг и что именно сейчас сделали;
• компьютер или сервер;
• Codex или Claude;
• что именно пытаетесь сделать.

Сначала определите, где вы работаете: Windows, Mac, Linux, сервер или обычный компьютер.

Интерфейс может отличаться, но действие обычно то же самое: открыть папку, войти в аккаунт, установить расширение, доверить папку или запустить чат агента.

Если сомневаетесь, не продолжайте вслепую. Пришлите скриншот и свой вопрос агенту или ИИ-чату и он подскажет.

Выберите вариант со смыслом «Разрешить», «Доверяю этой папке» или Trust.

Так VS Code поймет, что этой папке можно запускать расширения и команды.

Проверьте:

• открыта ли правильная папка в VS Code;
• файл лежит в папке агента, а не в случайном месте на компьютере;
• материалы лежат в 00_Inbox, если вы хотите загрузить их в базу;
• нет ли лишнего уровня вложенности, например 00_Inbox/0;
• агент работает на компьютере или на сервере.

Если не уверены, попросите агента:

Покажи полный путь к папке, в которой ты сейчас работаешь, и список файлов внутри

Откройте настройки VS Code и найдите параметр externalBrowser.

Впишите нужный браузер, например chrome, чтобы ссылки для входа открывались там, где вы уже авторизованы в ChatGPT.

Если это просто всплывающая подсказка VS Code, ее можно закрыть или игнорировать.

Для базовой работы агента в этом месте Git устанавливать не обязательно.

Сначала проверьте, что вы подключены к серверу, а не пишете пароль в локальном терминале компьютера.

Если соединение оборвалось, закройте VS Code и подключитесь к серверу заново по инструкции. После нового подключения попробуйте ввести пароль еще раз.

Проверьте, установлено ли расширение Remote - SSH.

Как его установить, смотрите в инструкции под этим уроком: ЧИТАТЬ

Для подключения к серверу в VS Code обычно нужно выбрать вариант SSH в списке удаленных окон.

Файлы и база не исчезают.

Временно может не работать платная модель или Codex. После восстановления лимитов или оплаты можно продолжить работу с теми же папками.

Если бот собирает персональные данные клиентов, хранить их нужно на российских серверах.

К персональным данным относятся имя, телефон, заявка, переписка и другая информация, по которой можно узнать человека. Перед запуском такого бота заранее продумайте российский сервер и схему хранения.

Для более подробной информации по перс.данным смотрите эфир с юристом: СМОТРЕТЬ

Лучше не запускать 2 агентов в одной папке одновременно.

Они могут изменить одни и те же файлы в разное время, и потом будет трудно понять, какая версия правильная.

Если хотите использовать Codex и Claude, разделите задачи или создайте отдельные папки/ботов.

Не удаляйте папки агента, хранилище, 00_Inbox, файлы бота, архивы и системные инструкции, если не уверены, что они больше не нужны.

Перед удалением попросите агента:

Проверь, что можно безопасно удалить, и сначала покажи мне список