Source: https://harnsy.dev/ru/getting-started

> Выберите AI-программу и компьютер, установите harnsy шаг за шагом и познакомьтесь со своей первой командой. Linux, macOS и Windows.

# Начало работы

Установите harnsy и познакомьтесь со своей первой командой. Выберите AI-программу и компьютер, и шаги раскроются по одному.

[Лучше посмотреть? Видео на 33 минуты: от установки до готового сайта ↓](#video)

## Или попросите об этом свою AI-программу

Вставьте это в свою AI-программу. Она прочитает короткую инструкцию, написанную для агентов, скажет, что меняет установка, и дождётся вашего «да».

`Установи harnsy по инструкции: https://harnsy.dev/llms.txt`

## 1. Установка

## Claude Code на Linux

> **Перед началом (страницы Anthropic, прочитаны 8 ноября 2026):** Claude Code нужен аккаунт Pro, Max, Ultra, Team, Enterprise или Console; бесплатный план claude.ai его не включает; нужно жить в стране, где Anthropic предлагает Claude Code; Ubuntu 20.04+/Debian 10+ (Alpine 3.19+), 4 ГБ памяти, интернет. Ссылки: [инструкция Anthropic](https://code.claude.com/docs/en/setup), [цены](https://claude.com/pricing), [руководство по терминалу](https://code.claude.com/docs/en/terminal-guide). Цен в тексте нет.

> Вы входите на странице провайдера. Код идёт прямо в программу на этом компьютере, и она хранит вход там, где хранит всегда. harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у программы, вошли ли вы. Прежде чем изменить файл настроек программы, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»).

1. Откройте терминал
   Терминал — окно, куда вводят команды. Linux: откройте приложение терминала. Установщики не просят прав администратора.
   
   **Вы увидите:** окно с мигающим курсором.
2. Заведите аккаунт Claude и выберите план
   В браузере откройте [claude.ai](https://claude.ai), создайте аккаунт и на странице цен Anthropic выберите план, в который входит Claude Code; оплатите его там.
   
   **Вы увидите:** вы вошли на claude.ai.
3. Установите Claude Code
   Команда Anthropic (не harnsy; скрипт можно прочитать до запуска, открыв адрес в браузере):
   
   Shell
   
   ```bash
   curl -fsSL https://claude.ai/install.sh | bash
   ```
   
   **Вы увидите:** пока идёт загрузка, ничего не движется. На Alpine или без `curl`/`bash` на странице Anthropic перечислены нужные пакеты.
4. Проверьте
   Откройте **новое** окно терминала и выполните `claude --version`.
   
   **Вы увидите:** номер версии. Если `claude` не найден, папка установки ещё не в PATH: исправление есть на странице Anthropic.
5. Войдите
   Выполните `claude` в любой папке, следуйте подсказкам в браузере и войдите со своим аккаунтом Claude; когда вошли, закройте его (дважды Ctrl+C).
   
   **Вы увидите:** Claude Code просит войти, потом открывается.
6. Установите harnsy
   Это можно сделать двумя способами. Оба ведут к одному и тому же установщику.
   
   **Способ A: попросите Claude Code.** Откройте Claude Code (наберите `claude`) и скажите ему:
   
   ```text
   Read https://harnsy.dev/llms.txt and help me install and set up harnsy.
   ```
   
   Claude Code прочитает короткую инструкцию, написанную для агентов. Прежде чем ставить, он скажет, что установка меняет (файлы настроек Claude Code и Codex: хуки и запись «разрешить harnsy», чтобы агенты могли обращаться к harnsy без запроса, во всех ваших сессиях Claude Code на этом компьютере; резервная копия сохраняется), и дождётся вашего «да». Потом установит harnsy за вас. Claude Code может попросить вас выполнить команду установщика самому, в своём терминале; это та же команда, что в способе B, и она ни о чём вас не спрашивает. Не ищите обходной путь: это собственная защита Claude Code. Потом Claude Code проверит, что harnsy работает, и задаст **один** вопрос, кнопками: с какой папки начать. Он заведёт вашу компанию и первый проект, откроет лида и откроет браузер на вашем чате с лидом. Окно терминала можно закрыть, когда он об этом скажет. Первый запуск (шаг 5) Claude Code проведёт с вами на вашем языке.
   
   **Способ B: наберите команду.** Скрипт можно прочитать до запуска: откройте https://harnsy.dev/install.sh в браузере. Пробный запуск ничего не меняет; он показывает, что сделает установщик:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run
   ```
   
   **Вы увидите:** каждый шаг, который сделал бы установщик. Ничего не записывается.
   
   Теперь установите. На компьютере, где harnsy ещё не было, добавьте `--first-run`:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run
   ```
   
   **Вы увидите:** с `--first-run` установщик ни о чём вас не спрашивает. Он заранее отвечает «да» на собственный набор harnsy: агенты могут открываться в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, и агенты могут обращаться к harnsy без запроса каждый раз. Это меняет файлы настроек Claude Code и Codex (хуки); каждое изменение показывается, и резервная копия сохраняется. Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить (`harnsy uninstall`). На компьютере, где harnsy уже был (в том числе удалён, но с сохранёнными данными), `--first-run` игнорируется, и установщик спрашивает как обычно.
   
   **Проверьте, что он работает.** Откройте `http://127.0.0.1:7788` в браузере.
   
   **Вы увидите:** дашборд harnsy. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.
   
   *Ваши агенты запускаются в tmux, если он установлен (3.1 или новее), а иначе — в собственном терминальном хосте harnsy; ставить ничего не нужно, а дашборд показывает каждого агента вживую. `--first-run` выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.*

## Claude Code на macOS

> **Перед началом (страницы Anthropic, прочитаны 8 ноября 2026):** Claude Code нужен аккаунт Pro, Max, Ultra, Team, Enterprise или Console; бесплатный план claude.ai его не включает; нужно жить в стране, где Anthropic предлагает Claude Code; macOS 13+, 4 ГБ памяти, интернет. Ссылки: [инструкция Anthropic](https://code.claude.com/docs/en/setup), [цены](https://claude.com/pricing), [руководство по терминалу](https://code.claude.com/docs/en/terminal-guide). Цен в тексте нет.

> Вы входите на странице провайдера. Код идёт прямо в программу на этом компьютере, и она хранит вход там, где хранит всегда. harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у программы, вошли ли вы. Прежде чем изменить файл настроек программы, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»).

1. Откройте терминал
   Терминал — окно, куда вводят команды. macOS: откройте Терминал (Программы › Утилиты › Терминал). Установщики не просят прав администратора.
   
   **Вы увидите:** окно с мигающим курсором.
2. Заведите аккаунт Claude и выберите план
   В браузере откройте [claude.ai](https://claude.ai), создайте аккаунт и на странице цен Anthropic выберите план, в который входит Claude Code; оплатите его там.
   
   **Вы увидите:** вы вошли на claude.ai.
3. Установите Claude Code
   Команда Anthropic (не harnsy; скрипт можно прочитать до запуска, открыв адрес в браузере):
   
   Shell
   
   ```bash
   curl -fsSL https://claude.ai/install.sh | bash
   ```
   
   Если вы уже пользуетесь Homebrew, можно выполнить вместо этого (нужна macOS 13 или новее; тоже команда Anthropic; установка через Homebrew сама не обновляется: как обновить, написано на странице Anthropic):
   
   Shell
   
   ```bash
   brew install --cask claude-code
   ```
   
   **Вы увидите:** пока идёт загрузка, ничего не движется. На Alpine или без `curl`/`bash` на странице Anthropic перечислены нужные пакеты.
4. Проверьте
   Откройте **новое** окно терминала и выполните `claude --version`.
   
   **Вы увидите:** номер версии. Если `claude` не найден, папка установки ещё не в PATH: исправление есть на странице Anthropic.
5. Войдите
   Выполните `claude` в любой папке, следуйте подсказкам в браузере и войдите со своим аккаунтом Claude; когда вошли, закройте его (дважды Ctrl+C).
   
   **Вы увидите:** Claude Code просит войти, потом открывается.
6. Установите harnsy
   Это можно сделать двумя способами. Оба ведут к одному и тому же установщику.
   
   **Способ A: попросите Claude Code.** Откройте Claude Code (наберите `claude`) и скажите ему:
   
   ```text
   Read https://harnsy.dev/llms.txt and help me install and set up harnsy.
   ```
   
   Claude Code прочитает короткую инструкцию, написанную для агентов. Прежде чем ставить, он скажет, что установка меняет (файлы настроек Claude Code и Codex: хуки и запись «разрешить harnsy», чтобы агенты могли обращаться к harnsy без запроса, во всех ваших сессиях Claude Code на этом компьютере; резервная копия сохраняется), и дождётся вашего «да». Потом установит harnsy за вас. Claude Code может попросить вас выполнить команду установщика самому, в своём терминале; это та же команда, что в способе B, и она ни о чём вас не спрашивает. Не ищите обходной путь: это собственная защита Claude Code. Потом Claude Code проверит, что harnsy работает, и задаст **один** вопрос, кнопками: с какой папки начать. Он заведёт вашу компанию и первый проект, откроет лида и откроет браузер на вашем чате с лидом. Окно терминала можно закрыть, когда он об этом скажет. Первый запуск (шаг 5) Claude Code проведёт с вами на вашем языке.
   
   **Способ B: наберите команду.** Скрипт можно прочитать до запуска: откройте https://harnsy.dev/install.sh в браузере. Пробный запуск ничего не меняет; он показывает, что сделает установщик:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run
   ```
   
   **Вы увидите:** каждый шаг, который сделал бы установщик. Ничего не записывается.
   
   Теперь установите. На компьютере, где harnsy ещё не было, добавьте `--first-run`:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run
   ```
   
   **Вы увидите:** с `--first-run` установщик ни о чём вас не спрашивает. Он заранее отвечает «да» на собственный набор harnsy: агенты могут открываться в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, и агенты могут обращаться к harnsy без запроса каждый раз. Это меняет файлы настроек Claude Code и Codex (хуки); каждое изменение показывается, и резервная копия сохраняется. Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить (`harnsy uninstall`). На компьютере, где harnsy уже был (в том числе удалён, но с сохранёнными данными), `--first-run` игнорируется, и установщик спрашивает как обычно.
   
   **Проверьте, что он работает.** Откройте `http://127.0.0.1:7788` в браузере.
   
   **Вы увидите:** дашборд harnsy. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.
   
   > Примечание
   > 
   > в собственных заметках harnsy сказано, что установка на macOS ещё не проверена на настоящем Mac. Установщик не меняет ваш PATH: если `~/.local/bin` в нём нет, установщик скажет об этом, и вы добавите его сами. Если при первом запуске агента macOS покажет окно установки инструментов разработчика, сначала выполните `xcode-select --install`.
   
   *Ваши агенты запускаются в tmux, если он установлен (3.1 или новее), а иначе — в собственном терминальном хосте harnsy; ставить ничего не нужно, а дашборд показывает каждого агента вживую. `--first-run` выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.*

## Claude Code на Windows

> **Перед началом (страницы Anthropic, прочитаны 8 ноября 2026):** Claude Code нужен аккаунт Pro, Max, Ultra, Team, Enterprise или Console; бесплатный план claude.ai его не включает; нужно жить в стране, где Anthropic предлагает Claude Code; Windows 10 1809+, 4 ГБ памяти, интернет. Ссылки: [инструкция Anthropic](https://code.claude.com/docs/en/setup), [цены](https://claude.com/pricing), [руководство по терминалу](https://code.claude.com/docs/en/terminal-guide). Цен в тексте нет.

> Вы входите на странице провайдера. Код идёт прямо в программу на этом компьютере, и она хранит вход там, где хранит всегда. harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у программы, вошли ли вы. Прежде чем изменить файл настроек программы, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»).

1. Откройте терминал
   Терминал — окно, куда вводят команды. Windows: откройте PowerShell (меню «Пуск», наберите «PowerShell») (не CMD: в строке приглашения стоит `PS C:\`). Установщики не просят прав администратора.
   
   **Вы увидите:** окно с мигающим курсором.
2. Заведите аккаунт Claude и выберите план
   В браузере откройте [claude.ai](https://claude.ai), создайте аккаунт и на странице цен Anthropic выберите план, в который входит Claude Code; оплатите его там.
   
   **Вы увидите:** вы вошли на claude.ai.
3. Установите Claude Code
   Команда Anthropic; нужна Windows 10 1809 или новее и не нужны права администратора; Git for Windows необязателен и лишь добавляет Claude Code инструмент Bash.
   
   PowerShell
   
   ```powershell
   irm https://claude.ai/install.ps1 | iex
   ```
   
   **Вы увидите:** пока идёт загрузка, ничего не движется. Если PowerShell пишет `The token '&&' is not a valid statement separator`, вы в PowerShell, и для этой команды это правильно; если пишет `'irm' is not recognized`, вы в CMD: откройте PowerShell.
4. Проверьте
   Откройте **новое** окно PowerShell и выполните `claude --version`.
   
   **Вы увидите:** номер версии. Если `claude` не найден, папка установки ещё не в PATH: исправление есть на странице Anthropic.
5. Войдите
   Выполните `claude` в любой папке, следуйте подсказкам в браузере и войдите со своим аккаунтом Claude; когда вошли, закройте его (дважды Ctrl+C).
   
   **Вы увидите:** Claude Code просит войти, потом открывается.
6. Установите harnsy
   Это можно сделать двумя способами. Оба ведут к одному и тому же установщику.
   
   **Способ A: попросите Claude Code.** Откройте Claude Code (наберите `claude`) и скажите ему:
   
   ```text
   Read https://harnsy.dev/llms.txt and help me install and set up harnsy.
   ```
   
   Claude Code прочитает короткую инструкцию, написанную для агентов. Прежде чем ставить, он скажет, что установка меняет (файлы настроек Claude Code и Codex: хуки и запись «разрешить harnsy», чтобы агенты могли обращаться к harnsy без запроса, во всех ваших сессиях Claude Code на этом компьютере; резервная копия сохраняется), и дождётся вашего «да». Потом установит harnsy за вас. Claude Code может попросить вас выполнить команду установщика самому, в своём терминале; это та же команда, что в способе B, и она ни о чём вас не спрашивает. Не ищите обходной путь: это собственная защита Claude Code. Потом Claude Code проверит, что harnsy работает, и задаст **один** вопрос, кнопками: с какой папки начать. Он заведёт вашу компанию и первый проект, откроет лида и откроет браузер на вашем чате с лидом. Окно терминала можно закрыть, когда он об этом скажет. Первый запуск (шаг 5) Claude Code проведёт с вами на вашем языке.
   
   **Способ B: наберите команду.** Скрипт можно прочитать до запуска: откройте https://harnsy.dev/install.ps1 в браузере. Пробный запуск ничего не меняет; он показывает, что сделает установщик:
   
   PowerShell
   
   ```powershell
   $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex
   ```
   
   **Вы увидите:** каждый шаг, который сделал бы установщик. Ничего не записывается.
   
   Теперь установите. На компьютере, где harnsy ещё не было, добавьте `--first-run`:
   
   PowerShell
   
   ```powershell
   $env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex
   ```
   
   **Вы увидите:** с `--first-run` установщик ни о чём вас не спрашивает. Он заранее отвечает «да» на собственный набор harnsy: агенты могут открываться в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, и агенты могут обращаться к harnsy без запроса каждый раз. Это меняет файлы настроек Claude Code и Codex (хуки); каждое изменение показывается, и резервная копия сохраняется. Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить (`harnsy uninstall`). На компьютере, где harnsy уже был (в том числе удалён, но с сохранёнными данными), `--first-run` игнорируется, и установщик спрашивает как обычно.
   
   **Проверьте, что он работает.** Откройте `http://127.0.0.1:7788` в браузере.
   
   **Вы увидите:** дашборд harnsy. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.
   
   > Примечание
   > 
   > установщик добавляет свою папку в PATH пользователя: набирайте `harnsy` в **новом** окне PowerShell. Windows Security иногда помечает `harnsy.exe`; мы считаем это ложным срабатыванием (см. «Устранение неполадок»).
   
   *Ваши агенты запускаются в собственном терминальном хосте harnsy (ConPTY); ставить ничего не нужно, а дашборд показывает каждого агента вживую. `--first-run` выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.*

## Codex на Linux

> **Перед началом (страницы OpenAI, прочитаны 8 ноября 2026):** на странице цен OpenAI сказано, что Codex входит в планы ChatGPT Free, Go, Plus, Pro, Business, Edu и Enterprise (возможности зависят от плана, действуют лимиты использования), а вместо этого можно платить за использование API по ключу API. Ссылки: [Codex CLI](https://learn.chatgpt.com/docs/codex/cli), [цены](https://learn.chatgpt.com/docs/pricing), [способы входа](https://learn.chatgpt.com/docs/auth). Цен в тексте нет. Нужно также жить в стране, где OpenAI предлагает ChatGPT и Codex (список — на страницах OpenAI).

> Вы входите на странице провайдера. Код идёт прямо в программу на этом компьютере, и она хранит вход там, где хранит всегда. harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у программы, вошли ли вы. Прежде чем изменить файл настроек программы, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»).

1. Откройте терминал
   Терминал — окно, куда вводят команды. Linux: откройте приложение терминала. Установщики не просят прав администратора.
   
   **Вы увидите:** окно с мигающим курсором.
2. Заведите аккаунт ChatGPT на плане, в который входит Codex
   В браузере откройте [chatgpt.com](https://chatgpt.com), при необходимости создайте аккаунт и выберите план на странице цен OpenAI (Codex входит в Free, Go, Plus, Pro, Business, Edu и Enterprise; действуют лимиты использования). Или используйте ключ API и платите за использование API (страница цен OpenAI). Ключ API — секрет: храните его в своём окружении (например, `OPENAI_API_KEY`); не кладите его в запрос, файл или сообщение агенту и не вставляйте в harnsy.
   
   **Вы увидите:** вы вошли на chatgpt.com.
3. Установите Codex
   Команда OpenAI (не harnsy; скрипт можно прочитать до запуска, открыв адрес в браузере):
   
   Shell
   
   ```bash
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   ```
   
   На странице OpenAI есть и вкладки для npm и Homebrew; читайте их там.
   
   **Вы увидите:** установщик заканчивает, и `codex` можно запустить в **новом** терминале.
4. Войдите
   В папке проекта выполните `codex`. При первом запуске выберите «Sign in with ChatGPT» и завершите вход в браузере. На машине без браузера OpenAI рекомендует `codex login --device-auth` (бета; код вводится на странице OpenAI). С ключом API: `printenv OPENAI_API_KEY | codex login --with-api-key`. Проверить: `codex login status`.
   
   **Вы увидите:** страницу входа в браузере, потом открывается Codex. Закройте его, когда вошли.
5. Установите harnsy
   *Способ «попросите свою AI-программу» написан для Claude Code; с Codex его не пробовали. Если вы его используете и Codex просит одобрить команду, сначала прочитайте команду.*
   
   **Способ B: наберите команду.** Скрипт можно прочитать до запуска: откройте https://harnsy.dev/install.sh в браузере. Пробный запуск ничего не меняет; он показывает, что сделает установщик:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run
   ```
   
   **Вы увидите:** каждый шаг, который сделал бы установщик. Ничего не записывается.
   
   Теперь установите. На компьютере, где harnsy ещё не было, добавьте `--first-run`:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run
   ```
   
   **Вы увидите:** с `--first-run` установщик ни о чём вас не спрашивает. Он заранее отвечает «да» на собственный набор harnsy: агенты могут открываться в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, и агенты могут обращаться к harnsy без запроса каждый раз. Это меняет файлы настроек Claude Code и Codex (хуки); каждое изменение показывается, и резервная копия сохраняется. Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить (`harnsy uninstall`). На компьютере, где harnsy уже был (в том числе удалён, но с сохранёнными данными), `--first-run` игнорируется, и установщик спрашивает как обычно.
   
   **Проверьте, что он работает.** Откройте `http://127.0.0.1:7788` в браузере.
   
   **Вы увидите:** дашборд harnsy. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.
   
   *Ваши агенты запускаются в tmux, если он установлен (3.1 или новее), а иначе — в собственном терминальном хосте harnsy; ставить ничего не нужно, а дашборд показывает каждого агента вживую. `--first-run` выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.*

## Codex на macOS

> **Перед началом (страницы OpenAI, прочитаны 8 ноября 2026):** на странице цен OpenAI сказано, что Codex входит в планы ChatGPT Free, Go, Plus, Pro, Business, Edu и Enterprise (возможности зависят от плана, действуют лимиты использования), а вместо этого можно платить за использование API по ключу API. Ссылки: [Codex CLI](https://learn.chatgpt.com/docs/codex/cli), [цены](https://learn.chatgpt.com/docs/pricing), [способы входа](https://learn.chatgpt.com/docs/auth). Цен в тексте нет. Нужно также жить в стране, где OpenAI предлагает ChatGPT и Codex (список — на страницах OpenAI).

> Вы входите на странице провайдера. Код идёт прямо в программу на этом компьютере, и она хранит вход там, где хранит всегда. harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у программы, вошли ли вы. Прежде чем изменить файл настроек программы, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»).

1. Откройте терминал
   Терминал — окно, куда вводят команды. macOS: откройте Терминал (Программы › Утилиты › Терминал). Установщики не просят прав администратора.
   
   **Вы увидите:** окно с мигающим курсором.
2. Заведите аккаунт ChatGPT на плане, в который входит Codex
   В браузере откройте [chatgpt.com](https://chatgpt.com), при необходимости создайте аккаунт и выберите план на странице цен OpenAI (Codex входит в Free, Go, Plus, Pro, Business, Edu и Enterprise; действуют лимиты использования). Или используйте ключ API и платите за использование API (страница цен OpenAI). Ключ API — секрет: храните его в своём окружении (например, `OPENAI_API_KEY`); не кладите его в запрос, файл или сообщение агенту и не вставляйте в harnsy.
   
   **Вы увидите:** вы вошли на chatgpt.com.
3. Установите Codex
   Команда OpenAI (не harnsy; скрипт можно прочитать до запуска, открыв адрес в браузере):
   
   Shell
   
   ```bash
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   ```
   
   На странице OpenAI есть и вкладки для npm и Homebrew; читайте их там.
   
   **Вы увидите:** установщик заканчивает, и `codex` можно запустить в **новом** терминале.
4. Войдите
   В папке проекта выполните `codex`. При первом запуске выберите «Sign in with ChatGPT» и завершите вход в браузере. На машине без браузера OpenAI рекомендует `codex login --device-auth` (бета; код вводится на странице OpenAI). С ключом API: `printenv OPENAI_API_KEY | codex login --with-api-key`. Проверить: `codex login status`.
   
   **Вы увидите:** страницу входа в браузере, потом открывается Codex. Закройте его, когда вошли.
5. Установите harnsy
   *Способ «попросите свою AI-программу» написан для Claude Code; с Codex его не пробовали. Если вы его используете и Codex просит одобрить команду, сначала прочитайте команду.*
   
   **Способ B: наберите команду.** Скрипт можно прочитать до запуска: откройте https://harnsy.dev/install.sh в браузере. Пробный запуск ничего не меняет; он показывает, что сделает установщик:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run
   ```
   
   **Вы увидите:** каждый шаг, который сделал бы установщик. Ничего не записывается.
   
   Теперь установите. На компьютере, где harnsy ещё не было, добавьте `--first-run`:
   
   Shell
   
   ```bash
   curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run
   ```
   
   **Вы увидите:** с `--first-run` установщик ни о чём вас не спрашивает. Он заранее отвечает «да» на собственный набор harnsy: агенты могут открываться в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, и агенты могут обращаться к harnsy без запроса каждый раз. Это меняет файлы настроек Claude Code и Codex (хуки); каждое изменение показывается, и резервная копия сохраняется. Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить (`harnsy uninstall`). На компьютере, где harnsy уже был (в том числе удалён, но с сохранёнными данными), `--first-run` игнорируется, и установщик спрашивает как обычно.
   
   **Проверьте, что он работает.** Откройте `http://127.0.0.1:7788` в браузере.
   
   **Вы увидите:** дашборд harnsy. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.
   
   > Примечание
   > 
   > в собственных заметках harnsy сказано, что установка на macOS ещё не проверена на настоящем Mac. Установщик не меняет ваш PATH: если `~/.local/bin` в нём нет, установщик скажет об этом, и вы добавите его сами. Если при первом запуске агента macOS покажет окно установки инструментов разработчика, сначала выполните `xcode-select --install`.
   
   *Ваши агенты запускаются в tmux, если он установлен (3.1 или новее), а иначе — в собственном терминальном хосте harnsy; ставить ничего не нужно, а дашборд показывает каждого агента вживую. `--first-run` выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.*

## Codex на Windows

> **Перед началом (страницы OpenAI, прочитаны 8 ноября 2026):** на странице цен OpenAI сказано, что Codex входит в планы ChatGPT Free, Go, Plus, Pro, Business, Edu и Enterprise (возможности зависят от плана, действуют лимиты использования), а вместо этого можно платить за использование API по ключу API. Ссылки: [Codex CLI](https://learn.chatgpt.com/docs/codex/cli), [цены](https://learn.chatgpt.com/docs/pricing), [способы входа](https://learn.chatgpt.com/docs/auth). Цен в тексте нет. Нужно также жить в стране, где OpenAI предлагает ChatGPT и Codex (список — на страницах OpenAI).

> Вы входите на странице провайдера. Код идёт прямо в программу на этом компьютере, и она хранит вход там, где хранит всегда. harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у программы, вошли ли вы. Прежде чем изменить файл настроек программы, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»).

1. Откройте терминал
   Терминал — окно, куда вводят команды. Windows: откройте PowerShell (меню «Пуск», наберите «PowerShell») (не CMD: в строке приглашения стоит `PS C:\`). Установщики не просят прав администратора.
   
   **Вы увидите:** окно с мигающим курсором.
2. Заведите аккаунт ChatGPT на плане, в который входит Codex
   В браузере откройте [chatgpt.com](https://chatgpt.com), при необходимости создайте аккаунт и выберите план на странице цен OpenAI (Codex входит в Free, Go, Plus, Pro, Business, Edu и Enterprise; действуют лимиты использования). Или используйте ключ API и платите за использование API (страница цен OpenAI). Ключ API — секрет: храните его в своём окружении (например, `OPENAI_API_KEY`); не кладите его в запрос, файл или сообщение агенту и не вставляйте в harnsy.
   
   **Вы увидите:** вы вошли на chatgpt.com.
3. Установите Codex
   **Установите Codex на самой Windows** по вкладке Windows [страницы OpenAI о Codex CLI](https://learn.chatgpt.com/docs/codex/cli), чтобы `codex` работал в PowerShell. *Codex, установленный только внутри WSL, harnsy не найдёт*: это другой PATH и другой домашний каталог. (OpenAI описывает путь через WSL отдельно; для этого руководства он не подходит.)
4. Войдите
   В папке проекта выполните `codex`. При первом запуске выберите «Sign in with ChatGPT» и завершите вход в браузере. На машине без браузера OpenAI рекомендует `codex login --device-auth` (бета; код вводится на странице OpenAI). С ключом API: `printenv OPENAI_API_KEY | codex login --with-api-key`. Проверить: `codex login status`.
   
   **Вы увидите:** страницу входа в браузере, потом открывается Codex. Закройте его, когда вошли.
5. Установите harnsy
   *Способ «попросите свою AI-программу» написан для Claude Code; с Codex его не пробовали. Если вы его используете и Codex просит одобрить команду, сначала прочитайте команду.*
   
   **Способ B: наберите команду.** Скрипт можно прочитать до запуска: откройте https://harnsy.dev/install.ps1 в браузере. Пробный запуск ничего не меняет; он показывает, что сделает установщик:
   
   PowerShell
   
   ```powershell
   $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex
   ```
   
   **Вы увидите:** каждый шаг, который сделал бы установщик. Ничего не записывается.
   
   Теперь установите. На компьютере, где harnsy ещё не было, добавьте `--first-run`:
   
   PowerShell
   
   ```powershell
   $env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex
   ```
   
   **Вы увидите:** с `--first-run` установщик ни о чём вас не спрашивает. Он заранее отвечает «да» на собственный набор harnsy: агенты могут открываться в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, и агенты могут обращаться к harnsy без запроса каждый раз. Это меняет файлы настроек Claude Code и Codex (хуки); каждое изменение показывается, и резервная копия сохраняется. Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить (`harnsy uninstall`). На компьютере, где harnsy уже был (в том числе удалён, но с сохранёнными данными), `--first-run` игнорируется, и установщик спрашивает как обычно.
   
   **Проверьте, что он работает.** Откройте `http://127.0.0.1:7788` в браузере.
   
   **Вы увидите:** дашборд harnsy. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.
   
   > Примечание
   > 
   > установщик добавляет свою папку в PATH пользователя: набирайте `harnsy` в **новом** окне PowerShell. Windows Security иногда помечает `harnsy.exe`; мы считаем это ложным срабатыванием (см. «Устранение неполадок»).
   
   *Ваши агенты запускаются в собственном терминальном хосте harnsy (ConPTY); ставить ничего не нужно, а дашборд показывает каждого агента вживую. `--first-run` выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.*

Полный гид · 33 мин

## От установки до работающего сайта — за один показ.

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

Настоящий запуск, ускоренный. Озвучка: сгенерированный голос, на английском; субтитры включены сразу, выключить их можно в плеере. Заказчик и работа в видео — данные для примера.

## 2. Первая команда

1. Выберите язык
   **Вы увидите:** «Выберите язык». Под ним: English, Русский, Español и пометка «язык браузера» у того, который угадан. «На этом языке будет дашборд, и на нём с вами заговорит лид команды».
   
   **Выберите:** свой язык, потом **Продолжить**.
   
   **Дальше:** экран выбора программы.
2. Выберите программу для команды
   **Вы увидите:** «Выберите программу для команды», карточку Claude Code («от Anthropic») и карточку Codex («от OpenAI»). Пока harnsy смотрит, на каждой «Проверяем этот компьютер…»; потом «Установлена» или «Не найдена на этом компьютере», и «Вход выполнен» или «Нужно войти». Под заголовком: «Ваша команда — ИИ-помощники, которые работают вместе. Вы решаете, чем они занимаются».
   
   **Выберите:** программу, которую вы установили. Если её не нашли, нажмите подсказку «Установите Claude» (или «Установите Codex»): откроется инструкция самой программы. Если нужно войти, нажмите «Войдите в Claude» (или «Войдите в Codex») и перейдите к шагу 3. Потом «Проверить снова». Чтобы взять другую программу, «Взять Codex» / «Выбрать другую программу».
   
   **Дальше:** когда на карточке написано «Claude готова» (или «Codex готова»), продолжайте.
3. Войдите (только если нужно)
   **Claude:** «Войдите в Claude», два шага: «Откройте страницу входа Anthropic» («Войдите там со своим аккаунтом Claude»), потом «Вставьте код со страницы» («После входа страница покажет код — вставьте его сюда»). Если код не подошёл: «Код не подошёл. Скопируйте код со страницы целиком и вставьте ещё раз».
   
   **Codex:** harnsy сам запускает вход Codex по коду устройства: «Откройте страницу OpenAI» («Можно на любом устройстве»), «Введите там этот код» (код вроде `WQT2-BZDCE`), «Код действует до 15 минут». Если вход не завершился, нажмите «Войдите в Codex» ещё раз.
   
   **Где хранится ваш вход:** в собственном месте программы на этом компьютере. Для Claude Code: harnsy не читает вход, чтобы им пользоваться, и никуда его не отправляет; он лишь спрашивает у Claude Code, вошли ли вы. Прежде чем изменить файл настроек Claude Code, в котором тоже может лежать ваш вход, harnsy хранит его резервную копию на этом компьютере (см. «Ключи, входы и подключения»). Для Codex: harnsy смотрит в собственном файле входа Codex, есть ли сохранённый вход (читает только это, не копирует, не хранит и не отправляет), либо проверяет, задан ли `OPENAI_API_KEY`.
   
   **Дальше:** назад к шагу 2; «… готова».
4. Назовите компанию
   **Вы увидите:** «Теперь вы — CEO». «Как назовём вашу компанию?», уже вписано «Моя первая компания». «В вашей компании будут команды, лиды и ИИ-сотрудники. Вы задаёте направление — они делают работу».
   
   **Выберите:** оставьте название или впишите своё, потом **Дальше**.
   
   **Хорошо знать:** в первом запуске говорится «компания», дальше в дашборде — «Организация». Это одно и то же.
5. Первый проект и какой он
   **Вы увидите:** «Каждая компания начинается с проекта». «Название проекта», уже вписано «Мой первый проект». «Проекты упорядочивают работу. У каждого проекта своя команда, задачи и цели». Под «Какой проект» два варианта: **Новый проект** («Начать с нуля. Мы создадим для него пустую папку») и **Мой проект** («Работать в папке, которая у вас уже есть: сайт, приложение, ваши документы»).
   
   **Выберите:** **Новый проект** → шаг 6. **Мой проект** → шаг 5б.
6. Покажите папку
   **Вы увидите:** «Папка вашего проекта» (пример `~/code/my-project`). Пока вы печатаете, «Проверяем папку…», потом «Папка найдена: <папка>».
   
   **Выберите:** введите полный путь (с `/` или `~`), потом **Просмотреть мой проект**.
   
   **Если отказывает:** «На этом компьютере нет такой папки. Проверьте путь» · «Эта папка вне вашей домашней папки. harnsy работает только с папками внутри неё» · «Это вся ваша домашняя папка. Укажите путь к папке проекта внутри неё» · «Эту папку harnsy не возьмёт: она скрытая, временная или в ней данные harnsy. Выберите папку своего проекта».
   
   **Дальше:** «Смотрим ваш проект»: «Лид открывает его только для чтения. Ничего в вашей папке не меняется». Потом карточка **«План готов»**. Пока вы не приняли, «агенты на этом компьютере ничего не меняют». Нажмите **Принять план** (или **Остановить**). После этого лид начинает работу. Переходите к шагу 8.
7. Над чем будет работать команда?
   **Вы увидите:** «Над чем будет работать команда?» Четыре варианта: **Разработка программ** («Создание сайтов и компьютерных программ»), **Маркетинг и тексты** («Тексты и помощь в том, чтобы люди узнали о вашем деле»), **Работа бизнеса** («Организация повседневной работы, например отчётов и списков»), **Другое** («Выберите, если остальные варианты не подходят»). Ниже: «Чего вы хотите добиться?» с примером «сайт для моей пекарни с меню и часами работы». «Мы предложим подходящих ИИ-сотрудников для вашего проекта».
   
   **Выберите:** вид работы и напишите свою цель своими словами.
8. Знакомьтесь: ваша первая команда
   **Вы увидите:** «Знакомьтесь: ваша первая команда». «Предложенная команда для «<проект>» — из каталога harnsy. Любого можно убрать или нанять ещё». Лид подписан «с ним говорите вы». У каждого карточка с навыками.
   
   **Выберите:** **Убрать: <имя>** для тех, кого не хотите, **+ Нанять ещё специалистов**, чтобы открыть каталог, потом **Создать мою команду** (с числом: «Создать мою команду (2)»). Если каталог не ответил: «Каталог не ответил, поэтому показали встроенную команду». На первом запуске есть предел: «Больше на первом запуске нельзя: остальных наймёте потом в «Ролях»».
   
   **Хорошо знать:** «Каждое принятое изменение сохраняется в git — к нему можно вернуться. Выключается в настройках проекта».
9. Собираем вашу команду
   **Вы увидите:** «Собираем вашу команду». Три строки отмечаются по очереди: «Сохраняем компанию, проект и команду», «Открываем окно лида» («Claude в новом окне терминала»), «Лид читает свою роль» («Обычно 10–30 секунд»). «Лид запускается в своём окне. Как только он на месте, откроется чат с ним». Когда готово: «Компания, проект и команда сохранены», «Окно лида открыто», «Лид на месте».
   
   **Если не вышло:** «Лид не запустился. Компания, проект и команда сохранены. Не получилось только запустить лида». Нажмите **Открыть окно лида**; см. «Если что-то пошло не так».
   
   **Дальше:** откроется чат с вашим лидом.
10. Поговорите с лидом и дайте первую задачу
   **Что происходит:** лид здоровается на вашем языке, одной строкой говорит, что понял, предлагает первую цель одной фразой и начинает. Он выбирает первую задачу, достаточно маленькую, чтобы закончить за час, и видимую вам, и нанимает для неё самую маленькую команду из каталога (обычно одну-две роли; карточки найма лежат в чате, нанимаете вы нажатием, так что без вас никто не приходит). Потом говорит: кто занят, какая задача, куда смотреть («Задачи»), и как дальше идёт работа: напишите лиду в чат или прокомментируйте карточку; лид разложит это на задачи для команды; если что-то не так, скажите, и лид переделает.
   
   **Вы увидите:** панель-гид «Первый запуск · шаг n из 6»: Программа и вход · Компания и проект · Лид набирает команду · Разговор с лидом · Первая задача · Проверьте результат. Карточку цели для подтверждения; лид задаёт по одному вопросу с вариантами и только когда работе нужен ответ.
   
   **Выберите:** отвечайте на вопросы лида; подтвердите цель; нажимайте карточки найма.
   
   **Дальше:** доска «Задачи»: каждая карточка — кусок работы. Когда первая задача дойдёт до **Проверки**, откройте её и нажмите **Принять** (или **Вернуть…** и напишите, что поправить). Потом попросите у лида следующее. **Показать весь дашборд** заканчивает гид.

## Организация и проект

В первом запуске говорится «компания», в дашборде потом — «Организация». Это одно и то же.

- **Организация** — ваша компания: группа, в которой лежат ваши проекты.
- **Проект** — одна папка со своим лидом, командой, задачами и целями.

**Пример.** Вы ведёте небольшую студию «Acme Studio». Это одна организация. В ней два проекта: «Сайт» и «Мобильное приложение»: две папки, два лида, две команды. Вторую организацию заводят только для другого клиента или бизнеса, чьи люди, цели и роли не должны смешиваться.

**Как добавить.** На странице «Организации» нажмите «Новая организация» и «Добавить организацию» либо «Новый проект в <организации>».

**Ограничения.** В бесплатном harnsy одна организация и два проекта, число агентов не ограничено. Больше организаций и проектов задаёт harnsy Max. Если вы упёрлись в предел, сообщение скажет об этом, а ваша организация продолжит работать.

### Второй проект

Пошаговый первый запуск появляется, только пока на узле нет ни одной компании. Для нового проекта потом нажмите «Новый проект в <организации>» на странице «Организации». У его лида своя первая встреча с вами; тура нет.

## Чем пути Claude Code и Codex различаются

- **Сообщения:** harnsy доставляет Codex через свою очередь; работающий Codex принимает сообщение в конце своего хода. Ответ человека на вопрос агента тоже уходит одним сообщением в очереди.
- **Вопросы и разрешения:** собственные вопросы Codex могут показываться на дашборде (один выбор на вопрос, можно ввести свой ответ). Запросы разрешений Codex на дашборд **не** попадают: они остаются в его окне терминала. У Claude Code доходит и то и другое.
- **Хуки:** установщик добавляет свой хук-справку в `~/.codex/hooks.json` только если `~/.codex` существует; при следующем запуске Codex может попросить вас доверять новому хуку. harnsy открывает свой Codex с доверием к папке, переданным флагами командной строки, и с выключенной проверкой обновлений.
- **Телефон:** доступ с телефона в harnsy — это собственный доступ к дашборду.
- **Лид:** лид может работать на Claude Code или Codex; вы выбираете на первом экране.

## Если что-то пошло не так

- **«Лид не открылся: Claude не найден».** harnsy не находит Claude Code. Установите его и войдите. Если он установлен, выполните `harnsy install` в терминале, где работает `claude` (команда запомнит этот PATH), перезапустите harnsy и нажмите «Попробовать снова».
- **«Лид не открылся: нет терминала».** Терминал не выбран. Нажмите «Выбрать терминал» или задайте `terminal.driver: tmux` в `~/.harnsy/config.yaml`, перезапустите и нажмите «Попробовать снова».
- **Claude вас разлогинил.** Страница лида просит войти снова (ссылка и код). После этого harnsy сам отправляет лиду первое сообщение.
- **«Мой проект» отказывает папке.** Введите полный путь, начиная с `/` или `~`. Папка должна существовать и лежать в вашей домашней папке; скрытые, временные и собственные папки harnsy, а также сама домашняя папка отклоняются.
- **Два Claude Code, старый первым.** Выполните `claude --version` (в Windows `where.exe claude`) и оставьте один.
- **За корпоративным прокси ничего не соединяется.** Настройки › Связь снаружи › Прокси и «Проверить».
- Ещё: [Устранение неполадок](https://harnsy.dev/ru/docs/troubleshooting).

[Устранение неполадок](https://harnsy.dev/ru/docs/troubleshooting)

## Обновление

### Обновление

harnsy сам обновления не проверяет. Проверьте и обновите:

Shell

```bash
harnsy update --check
harnsy update
```

В дашборде то же делают кнопки «Проверить обновления» и «Обновить». Подойдёт и повторная команда установки. Ваши данные в `~/.harnsy` остаются. Узел перезапускается на несколько секунд, сессии агентов продолжают работать.

> Примечание
> 
> Сообщение, отправленное в эти секунды, не дойдёт: отправьте его ещё раз. В Windows установщик спрашивает перед перезапуском узла.

### Вернуться назад

После обновления:

Shell

```bash
harnsy update --rollback --yes
```

Или поставьте старый выпуск поверх нового (переменная идёт в `sh`, а не в `curl`):

Shell

```bash
curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<тег> sh -s -- --allow-older
```

## Удаление

Shell

```bash
harnsy uninstall --dry-run
harnsy uninstall
```

Команда убирает службу, значок в трее, программу и только те записи в настройках, которые добавила сама установка (хуки, записи авторежима, строку состояния; ваша строка возвращается, если установка её обернула), показав diff и спросив.

> Примечание
> 
> Прежние резервные копии не восстанавливаются. Остаются ваши данные в `~/.harnsy`, резервные копии и выбор терминала, который вы сделали сами. Команда не отменяет разрешения и доверие к папкам, которые вы дали Claude Code. Без терминала она ничего не спрашивает и записи в настройках оставляет.

## Подробнее об установщике

Согласие заранее С версии 0.8.0Дайте ответы в самой команде — и установщик не будет спрашивать.

Дайте ответы в самой команде — и установщик не будет спрашивать. Так работает и без терминала. Каждая правка по-прежнему показывается как diff, а существующий файл сначала копируется в резерв.

Linux и macOS: часть пунктов

`curl -fsSL https://harnsy.dev/install.sh | sh -s -- --accept=hooks,statusline`

Linux и macOS: все пункты

`curl -fsSL https://harnsy.dev/install.sh | sh -s -- --yes`

Windows: часть пунктов

`$env:HARNSY_INSTALL_ARGS = "--accept=hooks,statusline"; irm https://harnsy.dev/install.ps1 | iex`

Windows: все пункты

`$env:HARNSY_INSTALL_ARGS = "--yes"; irm https://harnsy.dev/install.ps1 | iex`

`--accept=` принимает один или несколько пунктов через запятую:

`terminal`

терминал, в котором работают ваши агенты (tmux, если он установлен, иначе собственный терминальный хост harnsy; на Windows — собственный терминальный хост)

`tray`

значок в трее, вместе с запуском при входе

`hooks`

хук запуска для новых сессий

`statusline`

строка статуса harnsy там, где у вас её нет

`statusline_wrap`

обёртка harnsy перед вашей собственной строкой статуса; `statusline` её не покрывает

`answer_hook`

хук ответов

`service`

заменить другой файл службы или задачу, перейти с `ccbus.service`, остановить и заново запустить работающий узел; на Windows тоже

`--yes` отвечает «да» на все.

Это ваше согласие. Дайте его сами или скажите агенту своими словами, какие пункты принять: сам агент их за вас не выбирает.

На заметку.Ваши ответы запоминаются.

Ответ «да» или «нет», введённый в терминале или заданный через `--accept`, записывается в `~/.harnsy/config.yaml` как `install.<пункт>`, и следующая установка или обновление берёт его без вопроса. Один Enter не запоминается. `--accept` перекрывает запомненное «нет»; удалите строку, чтобы вас спросили снова. Ответ `service` не запоминается никогда.

### Что делает установщик

Всё, что он записывает, о чём спрашивает и чего не трогает. `harnsy install --dry-run` печатает каждый шаг, diff каждого файла, который изменил бы, и путь каждого файла, который создал бы, — и ничего не меняет.

#### Он остаётся в вашей учётной записи.

Всё попадает в ваши собственные пользовательские каталоги. Без sudo и прав администратора. На Linux и macOS он не меняет PATH и профиль вашей оболочки; если `~/.local/bin` в PATH нет, он скажет об этом, и вы добавите его сами или будете вызывать harnsy по полному пути. На Windows он добавляет `%LOCALAPPDATA%\harnsy\bin` в PATH пользователя (один раз, без прав администратора); окна, открытые раньше, хранят старый PATH, поэтому набирайте `harnsy` в новом. Если он не может прочитать или изменить PATH пользователя, он скажет об этом и попросит добавить папку вручную (Параметры → Переменные среды). `harnsy uninstall` эту запись убирает.

#### Он проверяет загрузку.

Установщик одной командой скачивает релиз под вашу ОС и процессор с GitHub по HTTPS и останавливается, если файла нет в `SHA256SUMS` релиза или он не совпадает. На Linux и macOS распаковывает во временную папку, запускает оттуда `harnsy install` и удаляет папку, когда закончит. Проверка ловит битую или недокачанную загрузку; суммы берутся из того же релиза.

#### Три вещи он ставит без вопросов.

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

|  | Linux | macOS | Windows |
| --- | --- | --- | --- |
| Программа (копия) | `~/.local/bin/harnsy` и ссылка `~/.local/bin/ccbus` | как в Linux | `%LOCALAPPDATA%\harnsy\bin\harnsy.exe` |
| Запись об установке | `~/.local/share/harnsy/install.json` и `hooks/harnsy-introduce.py` | как в Linux | `%LOCALAPPDATA%\harnsy\install.json` |
| Служба: запускается сразу и при входе, перезапускается после сбоя | пользовательский юнит systemd `~/.config/systemd/user/harnsy.service` | LaunchAgent `~/Library/LaunchAgents/com.github.butschster.harnsy.plist`, журнал в `~/Library/Logs/harnsy/` | задача `harnsy` в Планировщике заданий, с минимальными правами; если Windows её не принимает — значение `harnsy` в `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` (без перезапуска после сбоя) |

Если на месте уже другой файл службы или задача, он покажет их и заменит только после вашего «да». Существующий файл `~/.local/bin/ccbus` переименовывается в `ccbus.pre-harnsy`.

#### Когда вы запускаете его сами, обо всём остальном он спрашивает.

Каждый пункт — вопрос `[y/N]`. Считается только `y` или `yes`; нет ответа, нет терминала или `--dry-run` — значит «нет». Начиная с 0.8.0, «нет терминала» значит «нет», только если вы не сказали «да» заранее (см. «Согласие заранее»); `--dry-run` — всегда «нет».

- Запускать ли ваших агентов в терминале, пока ничего не выбрано (tmux, если он установлен, иначе собственный терминальный хост harnsy; на Windows — собственный терминальный хост); ответ сохраняется как `terminal.driver` в `config.yaml` harnsy.
- Значок в трее (Linux и Windows): в Linux — `~/.local/bin/harnsy-tray`. Запуск при входе — отдельный вопрос.
- Хук запуска для новых сессий в `~/.claude/settings.json` и `~/.codex/hooks.json` — только если есть `~/.claude` или `~/.codex` (не на Windows).
- Строка статуса в `~/.claude/settings.json` — только если у вас её нет.

Для каждого файла настроек он сначала показывает точную правку. Существующий файл сперва копируется в `~/.local/share/harnsy/backups/` (Windows: `%LOCALAPPDATA%\harnsy\backups\`). `--accept` и `--yes` отвечают «да» за вас, только когда вы их задали (с 0.8.0). `--no-tray`, `--no-hooks` и `--no-statusline` пропускают шаг.

#### Он остаётся на вашей машине.

Дашборд на `127.0.0.1:7788` и порт агентов на `127.0.0.1:7790` слушают только этот компьютер. Службе также выдан `127.0.0.1:7789` для других узлов; этот порт открывается только после того, как вы выпустите токен узла, и никогда — без ключа harnsy Max. В harnsy нет телеметрии, и она никогда не проверяет обновления. По умолчанию она говорит только с вашими харнессами на этой машине и с узлами, которые вы подключили; службы, до которых она может дотянуться, когда вы добавили ключ или включили возможность, перечислены в FAQ «Куда уходят мои данные?». Пока ключ установлен, harnsy примерно раз в день проверяет его в сервисе лицензий (`lic.harnsy.dev`) и отправляет полный ключ, хеш идентификатора машины (сам идентификатор машину не покидает), случайное одноразовое значение, имя машины на странице лицензии, ОС и архитектуру, версию harnsy и дату её сборки.

#### Чего он не трогает:

- MCP-серверы: он печатает необязательную строку `claude mcp add`, которую вы запустите сами
- `~/.claude.json`
- `~/.codex/config.toml` у Codex
- настройки OpenCode

Потом, во время работы: только при `claude.auto_trust: true` в `config.yaml` (по умолчанию выключено) harnsy отмечает папку проекта доверенной в `~/.claude.json`, прежде чем открыть там Claude Code, — и перед этим копирует файл в `claude.json.bak` в `~/.harnsy`. Codex, открытому через harnsy, доверие к папке передаётся флагами командной строки; файлы не пишутся.

Конкретный релиз или откат на старый

Конкретный релиз или откат на старый: `curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh` (переменная — после вертикальной черты). База только получает новые таблицы и столбцы, поэтому старая сборка её откроет.

`harnsy version` показывает установленную сборку.

За корпоративным прокси

За корпоративным прокси (с версии 0.9.1): задайте `HTTPS_PROXY` (и `HTTP_PROXY`) — адрес прокси, а в `NO_PROXY` — хосты, которые идут напрямую, и оставьте в нём `localhost,127.0.0.1,::1`. harnsy читает их один раз, при запуске: в Windows задайте их как пользовательские переменные и выйдите из системы и войдите снова; в Linux и macOS добавьте их в службу harnsy (unit systemd или plist launchd) и перезапустите её. `harnsy net check` по каждому хосту скажет, доступен ли он или почему нет (вход на прокси, подмена TLS, нет маршрута).

Открывать агентов из harnsy

~/.harnsy/config.yaml

`terminal:
  driver: tmux   # or: conpty`

Задаётся вручную в `~/.harnsy/config.yaml`; установщик или `--first-run` делает это за вас.

## Вопросы об установке

### Прежде чем начать

**Что нужно в первую очередь?** Компьютер с Linux, macOS 13 и новее или Windows 10 (1809) и новее; и Claude Code или Codex, установленный и с выполненным входом, на плане или с ключом API от Anthropic или OpenAI, которые с ним работают. Шаги выше проведут вас через аккаунт, установку и вход. harnsy не ставит Claude Code и Codex за вас.

**Какой план нужен?** Какие планы включают Claude Code или Codex — правило провайдера, и оно меняется. Читайте страницы цен Anthropic и OpenAI, ссылки в шаге 1. harnsy спрашивает у программы только, вошли ли вы.

**Нужен ли особый терминал?** Нет. harnsy запускает ваших агентов в терминале, которым управляет сам, и выбирает его для вашей системы: на Linux и macOS tmux, если он установлен (3.1 или новее), иначе собственный терминальный хост harnsy; на Windows всегда собственный терминальный хост harnsy. Ставить для этого ничего не нужно, а дашборд показывает каждого агента вживую. Без него сообщения, команды и дашборд работают; harnsy просто не может открывать и заново открывать агентов.

**Нужно ли уметь программировать?** Нет: вы описываете цели простыми словами, команда планирует и делает работу. Чтобы начать, вы ставите AI-программу и harnsy (одна-две команды в терминале) и входите; шаги выше показывают как. Оценивать технический результат, например код, проще, когда рядом есть технический человек.

### Установка

**Что нужно знать, прежде чем запускать команду, которая скачивает скрипт?** Скрипт можно прочитать до запуска: откройте адрес в браузере. `--dry-run` печатает каждый шаг и каждое изменение и ничего не записывает. Установщик работает в вашей учётной записи и не просит прав администратора, а загрузку сверяет с `SHA256SUMS` выпуска (это показывает, что файл дошёл целым, а не кто его сделал). Каждое изменение ваших файлов настроек сначала показывается как diff, и резервная копия сохраняется.

**Что установщик меняет на моём компьютере?** Кладёт программу в вашу пользовательскую папку и запускает её фоновой службой для вашей учётной записи. С `--first-run` он ещё заранее отвечает «да» на собственный набор harnsy (агенты открываются в своих окнах, каждый новый агент получает короткую справку о harnsy, вы можете отвечать на вопросы агентов из браузера, агенты обращаются к harnsy без запроса каждый раз); это меняет файлы настроек Claude Code и Codex (хуки). Значок в трее и строку состояния он не ставит. В конце печатает «Что изменилось на этом компьютере» и как это отменить. Полный список — «Что делает установщик» ниже. Чтобы отменить установку, выполните `harnsy uninstall`: команда убирает программу, службу и значок в трее, которые поставил harnsy, и, после показа каждого изменения и вопроса, записи, которые harnsy добавил в настройки Claude Code (его хуки, записи разрешений для авторежима и строку состояния, если он её ставил); сначала делается резервная копия, а резервные копии, ваши данные в `~/.harnsy` и всё, что вы позже добавили в эти настройки, остаются. Без терминала она ничего не спрашивает и записи в настройках оставляет.

**Windows пишет, что harnsy.exe — угроза. Что делать?** Windows Security иногда помечает `harnsy.exe`; мы считаем это ложным срабатыванием. Сначала проверьте загрузку, потом исключите только папку harnsy: шаги — в «Устранении неполадок».

**«harnsy: command not found» после установки.** На Linux и macOS установщик не меняет PATH и профиль вашей оболочки; если `~/.local/bin` в PATH нет, он скажет об этом, и вы добавите его сами. На Windows он добавляет `%LOCALAPPDATA%\harnsy\bin` в PATH пользователя (без прав администратора, один раз); окна, открытые раньше, хранят старый PATH, поэтому набирайте `harnsy` в **новом**. Если он не может прочитать или изменить PATH пользователя, он скажет об этом и попросит добавить папку вручную (Параметры → Переменные среды). `harnsy uninstall` эту запись убирает.

**Можно ли ставить без терминала?** harnsy ставится командой, поэтому для этого одного шага терминал нужен. Можно попросить свою AI-программу сделать это за вас (фраза вверху страницы); она скажет, что меняет установка, и дождётся вашего «да». Если AI-программа не может запустить установщик, она попросит вас выполнить команду самому.

### Первая команда

**Почему в первом запуске «компания», а в дашборде «Организация»?** Это одно и то же: ваша компания — группа, в которой лежат ваши проекты. Первый запуск говорит более простым словом.

**Всегда ли лид сначала изучает мой проект?** Только когда вы начинаете с уже существующей папки («Мой проект»): он читает папку, ничего не меняя, показывает план и ждёт, пока вы его примете. Для нового проекта он задаёт несколько вопросов, предлагает первую цель и берётся за работу.

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

**Видит ли harnsy мой вход в Claude?** harnsy не читает его, чтобы им пользоваться, и никуда не отправляет; он спрашивает у Claude Code, вошли ли вы. Резервная копия файла настроек Claude Code, в котором может лежать вход, остаётся на этом компьютере: см. «Ключи, входы и подключения». Для Codex он смотрит только, есть ли сохранённый вход; не копирует, не хранит и не отправляет его.

**Почему не могу добавить третий проект?** В бесплатном harnsy одна организация и два проекта, число агентов не ограничено; больше задаёт harnsy Max. Если вы упёрлись в предел, сообщение скажет об этом, а ваша организация продолжит работать. (С 0.11.0.)

**Куда задать вопрос, которого здесь нет?** Задать вопрос.

---

## Corrections to the site FAQ (landing /faq) that follow from this

- "What do I need first?" and "Do I need a special terminal?" and "Which systems?": replace “tmux on Linux and macOS” by “tmux if you have it, otherwise harnsy’s own window; Windows: its own window”.
- "What do I need to start?": “harnsy does not store your login” → the lawyer’s wording above.
- "Windows says harnsy.exe is a threat": use the Troubleshooting wording (“we believe this is a false positive”).
- The “Say yes up front” kind line `terminal`: “a terminal opens your agents (tmux on Linux and macOS; on Windows the conpty host)” → “a terminal runs your agents (tmux if it is installed, otherwise harnsy’s own terminal host; on Windows its own terminal host)”.
- **Found with doki-2 (8 Nov): today’s /install “What the installer does” says the installer “doesn’t change PATH” also on Windows. That is wrong for Windows (it adds `%LOCALAPPDATA%\harnsy\bin` to the user PATH). The block that stays on the page, and its ru/es/ja/ko, must be corrected with the sentences in the answer “command not found” above.**