harnsy
Начать бесплатно
RU

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

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

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

Или попросите об этом свою 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, цены, руководство по терминалу. Цен в тексте нет.

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

  1. Откройте терминал

    Терминал — окно, куда вводят команды. Linux: откройте приложение терминала. Установщики не просят прав администратора.

    Вы увидите: окно с мигающим курсором.

  2. Заведите аккаунт Claude и выберите план

    В браузере откройте claude.ai, создайте аккаунт и на странице цен Anthropic выберите план, в который входит Claude Code; оплатите его там.

    Вы увидите: вы вошли на claude.ai.

  3. Установите Claude Code

    Команда Anthropic (не harnsy; скрипт можно прочитать до запуска, открыв адрес в браузере):

    Shell
    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) и скажите ему:

    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
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

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

    Теперь установите. На компьютере, где harnsy ещё не было, добавьте --first-run:

    Shell
    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, цены, руководство по терминалу. Цен в тексте нет.

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

  1. Откройте терминал

    Терминал — окно, куда вводят команды. macOS: откройте Терминал (Программы › Утилиты › Терминал). Установщики не просят прав администратора.

    Вы увидите: окно с мигающим курсором.

  2. Заведите аккаунт Claude и выберите план

    В браузере откройте claude.ai, создайте аккаунт и на странице цен Anthropic выберите план, в который входит Claude Code; оплатите его там.

    Вы увидите: вы вошли на claude.ai.

  3. Установите Claude Code

    Команда Anthropic (не harnsy; скрипт можно прочитать до запуска, открыв адрес в браузере):

    Shell
    curl -fsSL https://claude.ai/install.sh | bash

    Если вы уже пользуетесь Homebrew, можно выполнить вместо этого (нужна macOS 13 или новее; тоже команда Anthropic; установка через Homebrew сама не обновляется: как обновить, написано на странице Anthropic):

    Shell
    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) и скажите ему:

    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
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

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

    Теперь установите. На компьютере, где harnsy ещё не было, добавьте --first-run:

    Shell
    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 на Windows

Перед началом (страницы Anthropic, прочитаны 8 ноября 2026): Claude Code нужен аккаунт Pro, Max, Ultra, Team, Enterprise или Console; бесплатный план claude.ai его не включает; нужно жить в стране, где Anthropic предлагает Claude Code; Windows 10 1809+, 4 ГБ памяти, интернет. Ссылки: инструкция Anthropic, цены, руководство по терминалу. Цен в тексте нет.

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

  1. Откройте терминал

    Терминал — окно, куда вводят команды. Windows: откройте PowerShell (меню «Пуск», наберите «PowerShell») (не CMD: в строке приглашения стоит PS C:\). Установщики не просят прав администратора.

    Вы увидите: окно с мигающим курсором.

  2. Заведите аккаунт Claude и выберите план

    В браузере откройте claude.ai, создайте аккаунт и на странице цен Anthropic выберите план, в который входит Claude Code; оплатите его там.

    Вы увидите: вы вошли на claude.ai.

  3. Установите Claude Code

    Команда Anthropic; нужна Windows 10 1809 или новее и не нужны права администратора; Git for Windows необязателен и лишь добавляет Claude Code инструмент Bash.

    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) и скажите ему:

    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
    $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

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

    Теперь установите. На компьютере, где harnsy ещё не было, добавьте --first-run:

    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. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.

    Ваши агенты запускаются в собственном терминальном хосте harnsy (ConPTY); ставить ничего не нужно, а дашборд показывает каждого агента вживую. --first-run выбирает это за вас без вопроса; обычная установка спрашивает один раз и запоминает ответ.

Codex на Linux

Перед началом (страницы OpenAI, прочитаны 8 ноября 2026): на странице цен OpenAI сказано, что Codex входит в планы ChatGPT Free, Go, Plus, Pro, Business, Edu и Enterprise (возможности зависят от плана, действуют лимиты использования), а вместо этого можно платить за использование API по ключу API. Ссылки: Codex CLI, цены, способы входа. Цен в тексте нет. Нужно также жить в стране, где OpenAI предлагает ChatGPT и Codex (список — на страницах OpenAI).

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

  1. Откройте терминал

    Терминал — окно, куда вводят команды. Linux: откройте приложение терминала. Установщики не просят прав администратора.

    Вы увидите: окно с мигающим курсором.

  2. Заведите аккаунт ChatGPT на плане, в который входит Codex

    В браузере откройте 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
    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
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

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

    Теперь установите. На компьютере, где harnsy ещё не было, добавьте --first-run:

    Shell
    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, цены, способы входа. Цен в тексте нет. Нужно также жить в стране, где OpenAI предлагает ChatGPT и Codex (список — на страницах OpenAI).

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

  1. Откройте терминал

    Терминал — окно, куда вводят команды. macOS: откройте Терминал (Программы › Утилиты › Терминал). Установщики не просят прав администратора.

    Вы увидите: окно с мигающим курсором.

  2. Заведите аккаунт ChatGPT на плане, в который входит Codex

    В браузере откройте 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
    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
    curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run

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

    Теперь установите. На компьютере, где harnsy ещё не было, добавьте --first-run:

    Shell
    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 на Windows

Перед началом (страницы OpenAI, прочитаны 8 ноября 2026): на странице цен OpenAI сказано, что Codex входит в планы ChatGPT Free, Go, Plus, Pro, Business, Edu и Enterprise (возможности зависят от плана, действуют лимиты использования), а вместо этого можно платить за использование API по ключу API. Ссылки: Codex CLI, цены, способы входа. Цен в тексте нет. Нужно также жить в стране, где OpenAI предлагает ChatGPT и Codex (список — на страницах OpenAI).

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

  1. Откройте терминал

    Терминал — окно, куда вводят команды. Windows: откройте PowerShell (меню «Пуск», наберите «PowerShell») (не CMD: в строке приглашения стоит PS C:\). Установщики не просят прав администратора.

    Вы увидите: окно с мигающим курсором.

  2. Заведите аккаунт ChatGPT на плане, в который входит Codex

    В браузере откройте 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, чтобы 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
    $env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex

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

    Теперь установите. На компьютере, где harnsy ещё не было, добавьте --first-run:

    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. На компьютере, где ещё нет ни одной компании, он начинается с «Выберите язык»: это первый запуск, дальше.

    Ваши агенты запускаются в собственном терминальном хосте 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) и оставьте один.
  • За корпоративным прокси ничего не соединяется. Настройки › Связь снаружи › Прокси и «Проверить».
  • Ещё: Устранение неполадок.

Устранение неполадок

Обновление

Обновление

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

Shell
harnsy update --check
harnsy update

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

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

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

Shell
harnsy update --rollback --yes

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

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

Удаление

Shell
harnsy uninstall --dry-run
harnsy uninstall

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

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

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

Всё, что он записывает, о чём спрашивает и чего не трогает. 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 и удаляет папку, когда закончит. Проверка ловит битую или недокачанную загрузку; суммы берутся из того же релиза.

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

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

Что записывается без вопросов при первой установке
LinuxmacOSWindows
Программа (копия)~/.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.serviceLaunchAgent ~/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.