はじめに
harnsy をインストールして、最初のチームに会いましょう。AIプログラムとコンピューターを選ぶと、ステップが1つずつ開きます。
見て進めたい方へ：インストールから完成までの 33 分の動画 ↓
または、AIプログラムに頼む
これを AIプログラムに貼り付けてください。エージェント向けに書かれた短いガイドを読み、インストールで何が変わるかを伝えて、あなたの「はい」を待ちます。
https://harnsy.dev/llms.txt の手順に従って harnsy をインストールして1. インストール
Linux で Claude Code
始める前に（Anthropic のページ、2026年11月8日に閲覧）： Claude Code には Pro、Max、Ultra、Team、Enterprise、Console のいずれかのアカウントが必要です。claude.ai の無料プランには含まれません。Anthropic が Claude Code を提供している国にお住まいである必要があります。Ubuntu 20.04+/Debian 10+（Alpine 3.19+）、メモリ 4 GB、インターネット接続。リンク：Anthropic のセットアップ手順、料金、ターミナルガイド。価格は載せていません。
サインインは、提供元のページで行います。コードはこのコンピューター上のプログラムに直接届き、プログラムはいつもの場所にログインを保管します。harnsy はログインを使うために読むことはなく、どこにも送りません。プログラムに、サインインしているかどうかを尋ねるだけです。ログインが入っていることもあるプログラムの設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。
ターミナルを開く
ターミナルは、コマンドを入力するウィンドウです。 Linux: ターミナルアプリを開きます。 インストーラーは管理者権限を求めません。
表示される内容： カーソルが点滅しているウィンドウ。
Claude のアカウントを作り、プランを選ぶ
ブラウザーで claude.ai を開いてアカウントを作り、Anthropic の料金ページで Claude Code を含むプランを選んで、そこで支払います。
表示される内容： claude.ai にサインインした状態になります。
Claude Code をインストールする
Anthropic のコマンドです（harnsy のものではありません。アドレスをブラウザーで開けば、実行前にスクリプトを読めます）：
curl -fsSL https://claude.ai/install.sh | bash表示される内容： ダウンロード中は何も動きません。Alpine の場合や
curl/bashがない場合は、Anthropic のページに必要なパッケージが載っています。確かめる
新しいターミナルを開いて
claude --versionを実行します。表示される内容： バージョン番号。
claudeが見つからない場合は、インストール先のフォルダーがまだ PATH に入っていません。直し方は Anthropic のセットアップページにあります。サインインする
任意のフォルダーで
claudeを実行し、ブラウザーの案内に従って Claude のアカウントでサインインします。終わったら閉じます（Ctrl+C を2回）。表示される内容： Claude Code がログインを求め、そのあと開きます。
harnsy をインストールする
方法は2つあります。どちらも同じインストーラーにたどり着きます。
方法 A：AIプログラムに頼む。 AIプログラムを開き（
claudeまたはcodexと入力）、こう伝えます。Read https://harnsy.dev/llms.txt and help me install and set up harnsy.AIプログラムは、エージェント向けに書かれた短いガイドを読みます。インストールの前に、何が変わるかを伝えます（Claude Code と Codex の設定ファイル：フックと「harnsy を許可」の項目です。これにより、このコンピューター上のすべての Claude Code セッションで、エージェントが毎回確認せずに harnsy を呼び出せるようになります。バックアップは残ります）。そして、あなたの「はい」を待ちます。それから harnsy をインストールします。ダウンロードしたインストーラーを AIプログラムが実行できない場合は、あなた自身のターミナルでコマンドを実行するよう頼まれます。方法 B と同じコマンドで、何も質問しません。ほかの抜け道を探さないでください。これは AIプログラム自身の安全策です。続いて、harnsy が動くことを確かめ、ボタン付きで1つだけ質問します：どのフォルダーから始めるか。会社と最初のプロジェクトを作り、リードを開き、リードとのチャットをブラウザーで開きます。
方法 B：コマンドを入力する。 スクリプトは実行前に読めます。ブラウザーで https://harnsy.dev/install.sh を開いてください。次のドライラン（試し実行）は何も変えず、インストーラーが何をするかを表示します。
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run表示される内容： インストーラーが行う予定の手順がすべて。何も書き込まれません。
では、インストールします。harnsy を一度も入れたことのないコンピューターでは、
--first-runを付けます。curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run表示される内容：
--first-runを付けると、インストーラーは何も質問しません。harnsy 自身のひとそろいの項目に、前もって「はい」と答えます：エージェントがそれぞれのウィンドウで開けること、新しいエージェントごとに harnsy についての短いメモが渡ること、エージェントの質問にブラウザーから答えられること、エージェントが毎回確認せずに harnsy とやり取りできること。これにより Claude Code と Codex の設定ファイル（フック）が変わります。変更はひとつずつ表示され、バックアップが残ります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法（harnsy uninstall）を表示します。以前 harnsy があったコンピューター（アンインストール済みでデータが残っているものも含む）では--first-runは無視され、インストーラーはいつもどおり質問します。動いているか確かめる。 ブラウザーで
http://127.0.0.1:7788を開きます。表示される内容： harnsy のダッシュボード。まだ会社がないコンピューターでは「Choose your language」（言語を選択）から始まります。これが初回起動です。次へ進みます。
エージェントは、tmux がインストールされていれば（3.1 以降）tmux で、なければ harnsy 独自のターミナルホストで動きます。何もインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。
--first-runなら質問なしで選び、通常のインストールでは一度だけ尋ねて、その答えを保存します。
macOS で Claude Code
始める前に（Anthropic のページ、2026年11月8日に閲覧）： Claude Code には Pro、Max、Ultra、Team、Enterprise、Console のいずれかのアカウントが必要です。claude.ai の無料プランには含まれません。Anthropic が Claude Code を提供している国にお住まいである必要があります。macOS 13+、メモリ 4 GB、インターネット接続。リンク：Anthropic のセットアップ手順、料金、ターミナルガイド。価格は載せていません。
サインインは、提供元のページで行います。コードはこのコンピューター上のプログラムに直接届き、プログラムはいつもの場所にログインを保管します。harnsy はログインを使うために読むことはなく、どこにも送りません。プログラムに、サインインしているかどうかを尋ねるだけです。ログインが入っていることもあるプログラムの設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。
ターミナルを開く
ターミナルは、コマンドを入力するウィンドウです。 macOS: ターミナルを開きます（アプリケーション › ユーティリティ › ターミナル）。 インストーラーは管理者権限を求めません。
表示される内容： カーソルが点滅しているウィンドウ。
Claude のアカウントを作り、プランを選ぶ
ブラウザーで claude.ai を開いてアカウントを作り、Anthropic の料金ページで Claude Code を含むプランを選んで、そこで支払います。
表示される内容： claude.ai にサインインした状態になります。
Claude Code をインストールする
Anthropic のコマンドです（harnsy のものではありません。アドレスをブラウザーで開けば、実行前にスクリプトを読めます）：
curl -fsSL https://claude.ai/install.sh | bashHomebrew をすでにお使いなら、代わりにこちらを実行できます（macOS 13 以降が必要です。これも Anthropic のコマンドです。Homebrew でのインストールは自動では更新されません。更新方法は Anthropic のページにあります）：
brew install --cask claude-code表示される内容： ダウンロード中は何も動きません。Alpine の場合や
curl/bashがない場合は、Anthropic のページに必要なパッケージが載っています。確かめる
新しいターミナルを開いて
claude --versionを実行します。表示される内容： バージョン番号。
claudeが見つからない場合は、インストール先のフォルダーがまだ PATH に入っていません。直し方は Anthropic のセットアップページにあります。サインインする
任意のフォルダーで
claudeを実行し、ブラウザーの案内に従って Claude のアカウントでサインインします。終わったら閉じます（Ctrl+C を2回）。表示される内容： Claude Code がログインを求め、そのあと開きます。
harnsy をインストールする
方法は2つあります。どちらも同じインストーラーにたどり着きます。
方法 A：AIプログラムに頼む。 AIプログラムを開き（
claudeまたはcodexと入力）、こう伝えます。Read https://harnsy.dev/llms.txt and help me install and set up harnsy.AIプログラムは、エージェント向けに書かれた短いガイドを読みます。インストールの前に、何が変わるかを伝えます（Claude Code と Codex の設定ファイル：フックと「harnsy を許可」の項目です。これにより、このコンピューター上のすべての Claude Code セッションで、エージェントが毎回確認せずに harnsy を呼び出せるようになります。バックアップは残ります）。そして、あなたの「はい」を待ちます。それから harnsy をインストールします。ダウンロードしたインストーラーを AIプログラムが実行できない場合は、あなた自身のターミナルでコマンドを実行するよう頼まれます。方法 B と同じコマンドで、何も質問しません。ほかの抜け道を探さないでください。これは AIプログラム自身の安全策です。続いて、harnsy が動くことを確かめ、ボタン付きで1つだけ質問します：どのフォルダーから始めるか。会社と最初のプロジェクトを作り、リードを開き、リードとのチャットをブラウザーで開きます。
方法 B：コマンドを入力する。 スクリプトは実行前に読めます。ブラウザーで https://harnsy.dev/install.sh を開いてください。次のドライラン（試し実行）は何も変えず、インストーラーが何をするかを表示します。
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run表示される内容： インストーラーが行う予定の手順がすべて。何も書き込まれません。
では、インストールします。harnsy を一度も入れたことのないコンピューターでは、
--first-runを付けます。curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run表示される内容：
--first-runを付けると、インストーラーは何も質問しません。harnsy 自身のひとそろいの項目に、前もって「はい」と答えます：エージェントがそれぞれのウィンドウで開けること、新しいエージェントごとに harnsy についての短いメモが渡ること、エージェントの質問にブラウザーから答えられること、エージェントが毎回確認せずに harnsy とやり取りできること。これにより Claude Code と Codex の設定ファイル（フック）が変わります。変更はひとつずつ表示され、バックアップが残ります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法（harnsy uninstall）を表示します。以前 harnsy があったコンピューター（アンインストール済みでデータが残っているものも含む）では--first-runは無視され、インストーラーはいつもどおり質問します。動いているか確かめる。 ブラウザーで
http://127.0.0.1:7788を開きます。表示される内容： harnsy のダッシュボード。まだ会社がないコンピューターでは「Choose your language」（言語を選択）から始まります。これが初回起動です。次へ進みます。
注記: harnsy 自身のメモによると、macOS でのインストールは、まだ実機の Mac で確認されていません。インストーラーは PATH を変更しません。
~/.local/binが PATH にない場合はそう表示するので、ご自身で追加してください。エージェントを初めて起動したときに macOS が開発者ツールのインストール画面を出した場合は、先にxcode-select --installを実行してください。エージェントは、tmux がインストールされていれば（3.1 以降）tmux で、なければ harnsy 独自のターミナルホストで動きます。何もインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。
--first-runなら質問なしで選び、通常のインストールでは一度だけ尋ねて、その答えを保存します。
Windows で Claude Code
始める前に（Anthropic のページ、2026年11月8日に閲覧）： Claude Code には Pro、Max、Ultra、Team、Enterprise、Console のいずれかのアカウントが必要です。claude.ai の無料プランには含まれません。Anthropic が Claude Code を提供している国にお住まいである必要があります。Windows 10 1809+、メモリ 4 GB、インターネット接続。リンク：Anthropic のセットアップ手順、料金、ターミナルガイド。価格は載せていません。
サインインは、提供元のページで行います。コードはこのコンピューター上のプログラムに直接届き、プログラムはいつもの場所にログインを保管します。harnsy はログインを使うために読むことはなく、どこにも送りません。プログラムに、サインインしているかどうかを尋ねるだけです。ログインが入っていることもあるプログラムの設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。
ターミナルを開く
ターミナルは、コマンドを入力するウィンドウです。 Windows: PowerShell を開きます（スタートメニューで「PowerShell」と入力） （CMD ではありません。プロンプトに
PS C:\と表示されます）。 インストーラーは管理者権限を求めません。表示される内容： カーソルが点滅しているウィンドウ。
Claude のアカウントを作り、プランを選ぶ
ブラウザーで claude.ai を開いてアカウントを作り、Anthropic の料金ページで Claude Code を含むプランを選んで、そこで支払います。
表示される内容： claude.ai にサインインした状態になります。
Claude Code をインストールする
Anthropic のコマンドです（harnsy のものではありません。アドレスをブラウザーで開けば、実行前にスクリプトを読めます）：
curl -fsSL https://claude.ai/install.sh | bash表示される内容： ダウンロード中は何も動きません。Alpine の場合や
curl/bashがない場合は、Anthropic のページに必要なパッケージが載っています。確かめる
新しい PowerShell ウィンドウを開き、
claude --versionを実行します。.表示される内容： バージョン番号。
claudeが見つからない場合は、インストール先のフォルダーがまだ PATH に入っていません。直し方は Anthropic のセットアップページにあります。サインインする
任意のフォルダーで
claudeを実行し、ブラウザーの案内に従って Claude のアカウントでサインインします。終わったら閉じます（Ctrl+C を2回）。表示される内容： Claude Code がログインを求め、そのあと開きます。
harnsy をインストールする
方法は2つあります。どちらも同じインストーラーにたどり着きます。
方法 A：AIプログラムに頼む。 AIプログラムを開き（
claudeまたはcodexと入力）、こう伝えます。Read https://harnsy.dev/llms.txt and help me install and set up harnsy.AIプログラムは、エージェント向けに書かれた短いガイドを読みます。インストールの前に、何が変わるかを伝えます（Claude Code と Codex の設定ファイル：フックと「harnsy を許可」の項目です。これにより、このコンピューター上のすべての Claude Code セッションで、エージェントが毎回確認せずに harnsy を呼び出せるようになります。バックアップは残ります）。そして、あなたの「はい」を待ちます。それから harnsy をインストールします。ダウンロードしたインストーラーを AIプログラムが実行できない場合は、あなた自身のターミナルでコマンドを実行するよう頼まれます。方法 B と同じコマンドで、何も質問しません。ほかの抜け道を探さないでください。これは AIプログラム自身の安全策です。続いて、harnsy が動くことを確かめ、ボタン付きで1つだけ質問します：どのフォルダーから始めるか。会社と最初のプロジェクトを作り、リードを開き、リードとのチャットをブラウザーで開きます。
方法 B：コマンドを入力する。 スクリプトは実行前に読めます。ブラウザーで https://harnsy.dev/install.ps1 を開いてください。次のドライラン（試し実行）は何も変えず、インストーラーが何をするかを表示します。
$env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex表示される内容： インストーラーが行う予定の手順がすべて。何も書き込まれません。
では、インストールします。harnsy を一度も入れたことのないコンピューターでは、
--first-runを付けます。$env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex表示される内容：
--first-runを付けると、インストーラーは何も質問しません。harnsy 自身のひとそろいの項目に、前もって「はい」と答えます：エージェントがそれぞれのウィンドウで開けること、新しいエージェントごとに harnsy についての短いメモが渡ること、エージェントの質問にブラウザーから答えられること、エージェントが毎回確認せずに harnsy とやり取りできること。これにより Claude Code と Codex の設定ファイル（フック）が変わります。変更はひとつずつ表示され、バックアップが残ります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法（harnsy uninstall）を表示します。以前 harnsy があったコンピューター（アンインストール済みでデータが残っているものも含む）では--first-runは無視され、インストーラーはいつもどおり質問します。動いているか確かめる。 ブラウザーで
http://127.0.0.1:7788を開きます。表示される内容： harnsy のダッシュボード。まだ会社がないコンピューターでは「Choose your language」（言語を選択）から始まります。これが初回起動です。次へ進みます。
注記: インストーラーは自分のフォルダーをユーザーの PATH に追加します。
harnsyは新しい PowerShell ウィンドウで入力してください。Windows Security がharnsy.exeを検出することがあります。私たちは誤検出だと考えています（「トラブルシューティング」を参照）。エージェントは harnsy 独自のターミナルホスト（ConPTY）で動きます。何もインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。
--first-runなら質問なしで選び、通常のインストールでは一度だけ尋ねて、その答えを保存します。
Linux で Codex
始める前に（OpenAI のページ、2026年11月8日に閲覧）： OpenAI の料金ページによると、Codex は ChatGPT の Free、Go、Plus、Pro、Business、Edu、Enterprise の各プランに含まれ（使える機能はプランによって異なり、利用上限があります）、代わりに API キーを使って API の利用量に応じて支払うこともできます。リンク：Codex CLI、料金、サインインの方法。価格は載せていません。また、OpenAI が ChatGPT と Codex を提供している国にお住まいである必要があります（国の一覧は OpenAI のページを参照）。
サインインは、提供元のページで行います。コードはこのコンピューター上のプログラムに直接届き、プログラムはいつもの場所にログインを保管します。harnsy はログインを使うために読むことはなく、どこにも送りません。プログラムに、サインインしているかどうかを尋ねるだけです。ログインが入っていることもあるプログラムの設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。
ターミナルを開く
ターミナルは、コマンドを入力するウィンドウです。 Linux: ターミナルアプリを開きます。 インストーラーは管理者権限を求めません。
表示される内容： カーソルが点滅しているウィンドウ。
Codex を含むプランで ChatGPT のアカウントを用意する
ブラウザーで chatgpt.com を開き、アカウントがなければ作って、OpenAI の料金ページでプランを選びます（Codex は Free、Go、Plus、Pro、Business、Edu、Enterprise に含まれます。利用上限があります）。または API キーを使い、API の利用量に応じて支払います（OpenAI の料金ページ）。API キーは秘密の情報です。ご自身の環境に置いてください（たとえば
OPENAI_API_KEY）。プロンプト、ファイル、エージェントへのメッセージには入れず、harnsy にも貼り付けないでください。表示される内容： chatgpt.com にサインインした状態になります。
Codex をインストールする
OpenAI のコマンドです（harnsy のものではありません。アドレスをブラウザーで開けば、実行前にスクリプトを読めます）：
curl -fsSL https://chatgpt.com/codex/install.sh | shOpenAI のページには npm と Homebrew のタブもあります。そちらでご確認ください。
表示される内容： インストーラーが終わり、新しいターミナルで
codexを起動できるようになります。サインインする
プロジェクトのフォルダーで
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 が開きます。サインインできたら閉じます。
harnsy をインストールする
「AIプログラムに頼む」方法は Claude Code 向けに書かれたもので、Codex では試していません。この方法を使い、Codex がコマンドの承認を求めてきたら、先にそのコマンドを読んでください。
方法 B：コマンドを入力する。 スクリプトは実行前に読めます。ブラウザーで https://harnsy.dev/install.sh を開いてください。次のドライラン（試し実行）は何も変えず、インストーラーが何をするかを表示します。
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run表示される内容： インストーラーが行う予定の手順がすべて。何も書き込まれません。
では、インストールします。harnsy を一度も入れたことのないコンピューターでは、
--first-runを付けます。curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run表示される内容：
--first-runを付けると、インストーラーは何も質問しません。harnsy 自身のひとそろいの項目に、前もって「はい」と答えます：エージェントがそれぞれのウィンドウで開けること、新しいエージェントごとに harnsy についての短いメモが渡ること、エージェントの質問にブラウザーから答えられること、エージェントが毎回確認せずに harnsy とやり取りできること。これにより Claude Code と Codex の設定ファイル（フック）が変わります。変更はひとつずつ表示され、バックアップが残ります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法（harnsy uninstall）を表示します。以前 harnsy があったコンピューター（アンインストール済みでデータが残っているものも含む）では--first-runは無視され、インストーラーはいつもどおり質問します。動いているか確かめる。 ブラウザーで
http://127.0.0.1:7788を開きます。表示される内容： harnsy のダッシュボード。まだ会社がないコンピューターでは「Choose your language」（言語を選択）から始まります。これが初回起動です。次へ進みます。
エージェントは、tmux がインストールされていれば（3.1 以降）tmux で、なければ harnsy 独自のターミナルホストで動きます。何もインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。
--first-runなら質問なしで選び、通常のインストールでは一度だけ尋ねて、その答えを保存します。
macOS で Codex
始める前に（OpenAI のページ、2026年11月8日に閲覧）： OpenAI の料金ページによると、Codex は ChatGPT の Free、Go、Plus、Pro、Business、Edu、Enterprise の各プランに含まれ（使える機能はプランによって異なり、利用上限があります）、代わりに API キーを使って API の利用量に応じて支払うこともできます。リンク：Codex CLI、料金、サインインの方法。価格は載せていません。また、OpenAI が ChatGPT と Codex を提供している国にお住まいである必要があります（国の一覧は OpenAI のページを参照）。
サインインは、提供元のページで行います。コードはこのコンピューター上のプログラムに直接届き、プログラムはいつもの場所にログインを保管します。harnsy はログインを使うために読むことはなく、どこにも送りません。プログラムに、サインインしているかどうかを尋ねるだけです。ログインが入っていることもあるプログラムの設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。
ターミナルを開く
ターミナルは、コマンドを入力するウィンドウです。 macOS: ターミナルを開きます（アプリケーション › ユーティリティ › ターミナル）。 インストーラーは管理者権限を求めません。
表示される内容： カーソルが点滅しているウィンドウ。
Codex を含むプランで ChatGPT のアカウントを用意する
ブラウザーで chatgpt.com を開き、アカウントがなければ作って、OpenAI の料金ページでプランを選びます（Codex は Free、Go、Plus、Pro、Business、Edu、Enterprise に含まれます。利用上限があります）。または API キーを使い、API の利用量に応じて支払います（OpenAI の料金ページ）。API キーは秘密の情報です。ご自身の環境に置いてください（たとえば
OPENAI_API_KEY）。プロンプト、ファイル、エージェントへのメッセージには入れず、harnsy にも貼り付けないでください。表示される内容： chatgpt.com にサインインした状態になります。
Codex をインストールする
OpenAI のコマンドです（harnsy のものではありません。アドレスをブラウザーで開けば、実行前にスクリプトを読めます）：
curl -fsSL https://chatgpt.com/codex/install.sh | shOpenAI のページには npm と Homebrew のタブもあります。そちらでご確認ください。
表示される内容： インストーラーが終わり、新しいターミナルで
codexを起動できるようになります。サインインする
プロジェクトのフォルダーで
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 が開きます。サインインできたら閉じます。
harnsy をインストールする
「AIプログラムに頼む」方法は Claude Code 向けに書かれたもので、Codex では試していません。この方法を使い、Codex がコマンドの承認を求めてきたら、先にそのコマンドを読んでください。
方法 B：コマンドを入力する。 スクリプトは実行前に読めます。ブラウザーで https://harnsy.dev/install.sh を開いてください。次のドライラン（試し実行）は何も変えず、インストーラーが何をするかを表示します。
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run表示される内容： インストーラーが行う予定の手順がすべて。何も書き込まれません。
では、インストールします。harnsy を一度も入れたことのないコンピューターでは、
--first-runを付けます。curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run表示される内容：
--first-runを付けると、インストーラーは何も質問しません。harnsy 自身のひとそろいの項目に、前もって「はい」と答えます：エージェントがそれぞれのウィンドウで開けること、新しいエージェントごとに harnsy についての短いメモが渡ること、エージェントの質問にブラウザーから答えられること、エージェントが毎回確認せずに harnsy とやり取りできること。これにより Claude Code と Codex の設定ファイル（フック）が変わります。変更はひとつずつ表示され、バックアップが残ります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法（harnsy uninstall）を表示します。以前 harnsy があったコンピューター（アンインストール済みでデータが残っているものも含む）では--first-runは無視され、インストーラーはいつもどおり質問します。動いているか確かめる。 ブラウザーで
http://127.0.0.1:7788を開きます。表示される内容： harnsy のダッシュボード。まだ会社がないコンピューターでは「Choose your language」（言語を選択）から始まります。これが初回起動です。次へ進みます。
注記: harnsy 自身のメモによると、macOS でのインストールは、まだ実機の Mac で確認されていません。インストーラーは PATH を変更しません。
~/.local/binが PATH にない場合はそう表示するので、ご自身で追加してください。エージェントを初めて起動したときに macOS が開発者ツールのインストール画面を出した場合は、先にxcode-select --installを実行してください。エージェントは、tmux がインストールされていれば（3.1 以降）tmux で、なければ harnsy 独自のターミナルホストで動きます。何もインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。
--first-runなら質問なしで選び、通常のインストールでは一度だけ尋ねて、その答えを保存します。
Windows で Codex
始める前に（OpenAI のページ、2026年11月8日に閲覧）： OpenAI の料金ページによると、Codex は ChatGPT の Free、Go、Plus、Pro、Business、Edu、Enterprise の各プランに含まれ（使える機能はプランによって異なり、利用上限があります）、代わりに API キーを使って API の利用量に応じて支払うこともできます。リンク：Codex CLI、料金、サインインの方法。価格は載せていません。また、OpenAI が ChatGPT と Codex を提供している国にお住まいである必要があります（国の一覧は OpenAI のページを参照）。
サインインは、提供元のページで行います。コードはこのコンピューター上のプログラムに直接届き、プログラムはいつもの場所にログインを保管します。harnsy はログインを使うために読むことはなく、どこにも送りません。プログラムに、サインインしているかどうかを尋ねるだけです。ログインが入っていることもあるプログラムの設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。
ターミナルを開く
ターミナルは、コマンドを入力するウィンドウです。 Windows: PowerShell を開きます（スタートメニューで「PowerShell」と入力） （CMD ではありません。プロンプトに
PS C:\と表示されます）。 インストーラーは管理者権限を求めません。表示される内容： カーソルが点滅しているウィンドウ。
Codex を含むプランで ChatGPT のアカウントを用意する
ブラウザーで chatgpt.com を開き、アカウントがなければ作って、OpenAI の料金ページでプランを選びます（Codex は Free、Go、Plus、Pro、Business、Edu、Enterprise に含まれます。利用上限があります）。または API キーを使い、API の利用量に応じて支払います（OpenAI の料金ページ）。API キーは秘密の情報です。ご自身の環境に置いてください（たとえば
OPENAI_API_KEY）。プロンプト、ファイル、エージェントへのメッセージには入れず、harnsy にも貼り付けないでください。表示される内容： chatgpt.com にサインインした状態になります。
Codex をインストールする
OpenAI の Codex CLI ページの Windows タブに従って、Windows 本体に Codex をインストールし、PowerShell で
codexが動くようにします。WSL の中だけにインストールした Codex は、harnsy から見つかりません：PATH もホームも別だからです。（OpenAI は WSL での方法を別に説明しています。それは WSL の中で作業するためのもので、このガイド向けではありません。）サインインする
プロジェクトのフォルダーで
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 が開きます。サインインできたら閉じます。
harnsy をインストールする
「AIプログラムに頼む」方法は Claude Code 向けに書かれたもので、Codex では試していません。この方法を使い、Codex がコマンドの承認を求めてきたら、先にそのコマンドを読んでください。
方法 B：コマンドを入力する。 スクリプトは実行前に読めます。ブラウザーで https://harnsy.dev/install.ps1 を開いてください。次のドライラン（試し実行）は何も変えず、インストーラーが何をするかを表示します。
$env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex表示される内容： インストーラーが行う予定の手順がすべて。何も書き込まれません。
では、インストールします。harnsy を一度も入れたことのないコンピューターでは、
--first-runを付けます。$env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex表示される内容：
--first-runを付けると、インストーラーは何も質問しません。harnsy 自身のひとそろいの項目に、前もって「はい」と答えます：エージェントがそれぞれのウィンドウで開けること、新しいエージェントごとに harnsy についての短いメモが渡ること、エージェントの質問にブラウザーから答えられること、エージェントが毎回確認せずに harnsy とやり取りできること。これにより Claude Code と Codex の設定ファイル（フック）が変わります。変更はひとつずつ表示され、バックアップが残ります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法（harnsy uninstall）を表示します。以前 harnsy があったコンピューター（アンインストール済みでデータが残っているものも含む）では--first-runは無視され、インストーラーはいつもどおり質問します。動いているか確かめる。 ブラウザーで
http://127.0.0.1:7788を開きます。表示される内容： harnsy のダッシュボード。まだ会社がないコンピューターでは「Choose your language」（言語を選択）から始まります。これが初回起動です。次へ進みます。
注記: インストーラーは自分のフォルダーをユーザーの PATH に追加します。
harnsyは新しい PowerShell ウィンドウで入力してください。Windows Security がharnsy.exeを検出することがあります。私たちは誤検出だと考えています（「トラブルシューティング」を参照）。エージェントは harnsy 独自のターミナルホスト（ConPTY）で動きます。何もインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。
--first-runなら質問なしで選び、通常のインストールでは一度だけ尋ねて、その答えを保存します。
- 「The lead did not open: Claude not found.」（リードが開きませんでした：Claude が見つかりません）。 harnsy が Claude Code を見つけられません。インストールしてサインインしてください。インストール済みなら、
claudeが動くターミナルでharnsy installを実行し（その PATH を保存します）、harnsy を再起動して「Try again」（もう一度）を押します。 - 「The lead did not open: no terminal.」（リードが開きませんでした：ターミナルがありません）。 ターミナルが選ばれていません。「Choose a terminal」（ターミナルを選ぶ）を押すか、
~/.harnsy/config.yamlでterminal.driver: tmuxを設定し、再起動して「Try again」を押します。 - Claude からサインアウトされた。 リードのページで、もう一度サインインするよう求められます（リンクとコード）。そのあと、harnsy が自分でリードに最初のメッセージを送ります。
- 「My project」がフォルダーを受け付けない。
/または~から始まるフルパスを入力してください。フォルダーは実在し、ホームフォルダーの中にある必要があります。隠しフォルダー、一時フォルダー、harnsy 自身のフォルダー、ホームフォルダーそのものは受け付けません。 - Claude Code が2つあり、古いほうが先に見つかる。
claude --version（Windows ではwhere.exe claude）を実行し、1つだけ残してください。 - 社内プロキシの内側で何もつながらない。 「Settings › Reach from outside › Proxy」を開き、「Check」を押します。
- ほかにも：トラブルシューティング（英語）。
完全ガイド · 33 分
インストールから動くウェブサイトまで、ひと続きで。
テスト用マシンでの実際の実行です。harnsy のインストール、最初のプロジェクト、リードへのタスク、デザイナーの採用、小さなお店のサイト完成まで。チャプターで見たい場面に移れます。
2. 最初のチーム
言語を選ぶ
表示される内容： 「Choose your language.」（言語を選択）。その下に English、Russian、Spanish が並び、推測した言語に「your browser's language」（ブラウザーの言語）の印が付きます。「The dashboard will be in this language, and your team's lead will talk to you in it.」（ダッシュボードはこの言語になり、チームのリードもこの言語で話します。）
選ぶもの： 自分の言語を選び、Continue（続ける）を押します。
次へ： プログラムの画面。
チームのプログラムを選ぶ
表示される内容： 「Choose a program for your team」（チームのプログラムを選択）と、Claude Code のカード（「from Anthropic」）と Codex のカード（「from OpenAI」）。harnsy が調べているあいだは、どちらにも「Checking this computer…」（このコンピューターを確認中）と出ます。そのあと「Installed」（インストール済み）または「Not found on this computer」（このコンピューターに見つかりません）と、「Signed in」（サインイン済み）または「Sign-in needed」（サインインが必要）が表示されます。見出しの下：「Your team is a group of AI helpers that work together. You decide what they work on.」（チームは、一緒に働く AI の助手たちです。何に取り組むかはあなたが決めます。）
選ぶもの： インストールしたプログラム。見つからない場合は Install Claude（または Install Codex）を押すと、そのプログラム自身の手順が開きます。サインインが必要な場合は Sign in to Claude（または Sign in to Codex）を押し、ステップ 3 に従います。そのあと Check again（もう一度確認）を押します。もう一方のプログラムを使うには、Use Codex instead（代わりに Codex を使う）/ Choose another program（別のプログラムを選ぶ）を押します。
次へ： カードに「Claude is ready」（または「Codex is ready」）と出たら、先に進みます。
サインインする
Claude： 「Sign in to Claude」は2段階です。「Open Anthropic’s sign-in page」（Anthropic のサインインページを開く。「Sign in there with your Claude account.」：そこで Claude のアカウントでサインインします）、そのあと「Paste the code from that page」（そのページのコードを貼り付ける。「After you sign in, the page shows a code — paste it here.」：サインインすると、ページにコードが表示されます。それをここに貼り付けます）。コードが合わない場合：「This code did not fit. Copy the whole code from the page and paste it again.」（このコードは合いませんでした。ページのコードを全部コピーして、もう一度貼り付けてください。）
Codex： harnsy が Codex 自身のデバイスコードによるサインインを代わりに始めます。「Open OpenAI’s page」（OpenAI のページを開く。「Any device will do.」：どの端末でも構いません）、「Type this code there」（そこにこのコードを入力。
WQT2-BZDCEのようなコード）、「The code is valid for up to 15 minutes.」（コードの有効期限は最長 15 分です）。終わらなかった場合：「Sign-in to Codex did not finish. Press “Sign in to Codex” again.」（Codex へのサインインが完了しませんでした。「Sign in to Codex」をもう一度押してください。）ログインの保管場所： このコンピューター上の、そのプログラム自身の保管場所です。Claude Code の場合：harnsy はログインを使うために読むことはなく、どこにも送りません。Claude Code に、サインインしているかどうかを尋ねるだけです。ログインが入っていることもある Claude Code の設定ファイルを変更する前に、harnsy はそのバックアップをこのコンピューターに保存します（「キー、ログイン、接続」を参照）。Codex の場合：harnsy は Codex 自身のログインファイルを見て、保存されたログインがあるかどうかだけを読みます（コピーも保存も送信もしません）。または
OPENAI_API_KEYが設定されているかを確かめます。次へ： ステップ 2 に戻ります。「… is ready」と出ます。
会社に名前を付ける
表示される内容： 「You’re the CEO now.」（あなたが CEO です）。「What should we call your company?」（会社の名前は？）に「My First Company」が入っています。「Your company will have teams, leads and AI employees. You set the direction. They handle the work.」（会社には、チーム、リード、AI の社員がいます。方向を決めるのはあなた。仕事は彼らがこなします。）
選ぶもの： 名前をそのまま使うか自分で入力し、Continue（続ける）を押します。
知っておくと便利： 初回起動では「company」（会社）と言い、そのあとのダッシュボードでは「Organization」（組織）と言います。同じものです。
最初のプロジェクトと、その種類
表示される内容： 「Every company starts with a project.」（どの会社もプロジェクトから始まります）。「Project name」（プロジェクト名）に「My First Project」が入っています。「Projects organize work. Each project has its own team, tasks and goals.」（プロジェクトは仕事を整理します。各プロジェクトに、それぞれのチーム、タスク、目標があります。）「What kind of project」（プロジェクトの種類）の下に選択肢が2つ：New project（「Start from scratch. We create an empty folder for it.」：ゼロから始めます。空のフォルダーを作ります）と My project（「Work in a folder you already have — a website, an app, your documents.」：すでにあるフォルダーで作業します。Web サイト、アプリ、文書など）。
選ぶもの： New project → ステップ 6 へ。My project → ステップ 5b へ。
フォルダーを示す
表示される内容： 「Your project’s folder」（プロジェクトのフォルダー。例
~/code/my-project）。入力すると「Checking the folder…」（フォルダーを確認中）、そのあと「Folder found: <folder>」（フォルダーが見つかりました）。選ぶもの： フルパス（
/または~から始まる）を入力し、Look through my project（プロジェクトを調べる）を押します。受け付けられないとき： 「There is no such folder on this computer. Check the path.」（このコンピューターにそのフォルダーはありません。パスを確認してください。）· 「This folder is outside your home folder. harnsy works only with folders inside it.」（このフォルダーはホームフォルダーの外にあります。harnsy はホームフォルダーの中のフォルダーだけを扱います。）· 「This is your whole home folder. Type the path to your project’s folder inside it.」（これはホームフォルダー全体です。その中にあるプロジェクトのフォルダーのパスを入力してください。）· 「harnsy cannot use this folder: it is hidden, temporary, or holds harnsy's own data. Choose a project folder of your own.」（このフォルダーは使えません。隠しフォルダー、一時フォルダー、または harnsy 自身のデータが入っています。ご自身のプロジェクトのフォルダーを選んでください。）
次へ： 「Looking through your project」（プロジェクトを調べています）：「Your lead opens it to read only. Nothing in your folder is changed.」（リードは読み取り専用で開きます。フォルダーの中身は何も変わりません。）（リードは読み取り専用で動きます。）そのあと 「Plan ready」（計画ができました）のカード。あなたが承認するまで、「Agents on this computer change nothing.」（このコンピューターのエージェントは何も変更しません）。Accept the plan（計画を承認）（または Stop）を押します。そのあと、リードが作業を始めます。ステップ 8 へ進みます。
チームは何に取り組みますか？
表示される内容： 「What will your team work on?」（チームは何に取り組みますか？）。選択肢は4つ：Software development（「Making websites and computer programs.」：Web サイトやコンピューターのプログラムを作る）、Marketing & content（「Writing texts and helping people learn about your work.」：文章を書き、あなたの仕事を人に知ってもらう）、Business operations（「Organizing everyday work, such as reports and lists.」：報告書やリストなど、日々の仕事を整理する）、Something else（「Choose this if none of the other choices fits.」：ほかのどれにも当てはまらないとき）。その下に「What do you want to accomplish?」（何を達成したいですか？）と、例「a website for my bakery with the menu and opening hours」（メニューと営業時間を載せた、私のパン屋の Web サイト）。「We'll suggest the right AI employees for your project.」（プロジェクトに合う AI の社員を提案します。）
選ぶもの： 仕事の種類を選び、目標を自分の言葉で書きます。
最初のチームに会う
表示される内容： 「Meet your first team.」（最初のチームに会いましょう）。「Proposed team for “<project>”, from the harnsy catalog. Remove anyone or hire more.」（harnsy のカタログから提案された「<project>」のチーム。誰でも外せますし、追加で採用もできます。）リードには「you talk to this one」（あなたが話す相手）の印が付きます。一人ひとりに、スキルを書いたカードがあります。
選ぶもの： 要らない人には Remove <name>（外す）、カタログを開くには + Hire more specialists（専門家をさらに採用）、そのあと Create my team（チームを作る。人数付きで「Create my team (2)」）を押します。カタログが応答しない場合は「The catalog did not answer, so this is the built-in team.」（カタログが応答しなかったため、組み込みのチームです）と出ます。初回起動には上限があります：「That is the most for the first run: hire the rest later in Roles.」（初回起動ではここまでです。残りはあとで「Roles」で採用してください。）
知っておくと便利： 「Every change you accept is saved to git, so you can go back. You can turn it off in the project’s settings.」（承認した変更はすべて git に保存されるので、元に戻せます。プロジェクトの設定でオフにできます。）
チームを準備する
表示される内容： 「Putting your team together.」（チームを準備しています）。3行に順にチェックが付きます：「Saving your company, project and team」（会社、プロジェクト、チームを保存中）、「Opening your lead’s window」（リードのウィンドウを開いています。「Claude in a new terminal window」：新しいターミナルウィンドウで Claude）、「Your lead is reading its role」（リードが自分のロールを読んでいます。「Usually 10–30 seconds」：たいてい 10〜30 秒）。「Your lead is starting in its own window. The chat opens as soon as it is in.」（リードは自分のウィンドウで起動中です。準備ができしだい、チャットが開きます。）終わると：「Company, project and team saved」（会社、プロジェクト、チームを保存しました）、「Lead’s window opened」（リードのウィンドウが開きました）、「Your lead is in」（リードの準備ができました）。
うまくいかないとき： 「Your lead did not start. Your company, project and team are saved. Only starting the lead failed.」（リードが起動しませんでした。会社、プロジェクト、チームは保存されています。失敗したのはリードの起動だけです。）Open the lead’s window（リードのウィンドウを開く）または Try again（もう一度）を押してください。「うまくいかないときは」も参照してください。
次へ： リードとのチャットが開きます。
リードと話し、最初のタスクを渡す
何が起きるか： リードがあなたの言語であいさつし、理解したことを1行で伝え、最初の目標を一文で提案して、作業を始めます。1時間以内に終わり、あなたにも見える小さな最初のタスクを選び、そのためにカタログから最小限のチームを採用します（たいていロール1〜2個。採用カードはチャットにあり、押して採用するのはあなたなので、あなた抜きで誰かが加わることはありません）。そのあと、誰が担当するか、どのタスクか、どこを見ればよいか（「Tasks」）、そしてこれからの仕事の進め方を伝えます：チャットでリードに書くか、カードにコメントします。リードがそれをチームのタスクに分けます。何かが違っていたらそう伝えれば、リードがやり直します。
表示される内容： ガイドバー「First run · step n of 6」（初回起動 · ステップ n / 6）：Program and sign-in · Company and project · The lead hires the team · Talk with the lead · First task · Check the result（プログラムとサインイン · 会社とプロジェクト · リードがチームを採用 · リードと話す · 最初のタスク · 結果を確認）。あなたが確認する目標のカード。リードは、作業に答えが必要なときだけ、選択肢付きで1つずつ質問します。
選ぶもの： リードの質問に答え、目標を確認し、採用カードを押します。
次へ： タスクボード「Tasks」：カード1枚が1つの仕事です。最初のタスクが Review（レビュー）に来たら、開いて Accept（承認）を押します（または Return…（差し戻し）を押して、直してほしい点を書きます）。それから、次にやることをリードに頼みます。Show the whole dashboard（ダッシュボード全体を表示）でガイドは終わります。
組織とプロジェクト
初回起動では「company」（会社）と言い、そのあとのダッシュボードでは「Organization」（組織）と言います。同じものです。
- 組織は、あなたの会社です。プロジェクトをまとめるグループです。
- プロジェクトは、1つのフォルダーと、そのリード、チーム、タスク、目標です。
例。 小さなスタジオ「Acme Studio」を運営しているとします。これが1つの組織です。その中に「Website」と「Mobile app」の2つのプロジェクトがあります：フォルダーが2つ、リードが2人、チームが2つ。2つ目の組織を作るのは、人、目標、ロールを混ぜたくない別の顧客や別の事業のときだけです。
追加するには。 「Organizations」ページで「New organization」と「Add organization」、または「New project in <organization>」を押します。
上限。 無料の harnsy では、組織は1つ、プロジェクトは2つまでで、エージェントの数に上限はありません。それより多い組織とプロジェクトは harnsy Max で使えます。上限に達するとメッセージでお知らせし、組織はそのまま動き続けます。
2つ目のプロジェクト
ガイド付きの初回起動が出るのは、ノードにまだ会社がないあいだだけです。あとから新しいプロジェクトを作るときは、「Organizations」ページで「New project in <organization>」を押します。そのプロジェクトのリードも、あなたと最初の打ち合わせをします。ツアーはありません。
Claude Code と Codex のパスの違い
- メッセージ： harnsy は Codex へ、自分のキューを通して届けます。動作中の Codex は、自分のターンの終わりにメッセージを受け取ります。エージェントの質問への人の回答も、キューに入った1通のメッセージとして届きます。
- 質問と権限： Codex 自身の質問はダッシュボードに表示できます（質問ごとに選択肢を1つ選べ、自分で入力した回答も使えます）。Codex の承認の確認はダッシュボードには届きません。Codex のターミナルウィンドウに残ります。Claude Code では、どちらも届きます。
- フック： インストーラーは、
~/.codexがあるときだけ、~/.codex/hooks.jsonにブリーフィング用のフックを追加します。次に Codex を起動したとき、新しいフックを信頼するか尋ねられることがあります。harnsy は自分が開く Codex を、フォルダーの信頼をコマンドラインのフラグで渡し、更新の確認をオフにして起動します。 - スマートフォン： harnsy のスマートフォンからのアクセスは、harnsy 自身のダッシュボードへのアクセスです。
- リード： リードは Claude Code でも Codex でも動きます。最初の画面で選びます。
うまくいかないときは
- 「The lead did not open: Claude not found.」（リードが開きませんでした：Claude が見つかりません）。 harnsy が Claude Code を見つけられません。インストールしてサインインしてください。インストール済みなら、
claudeが動くターミナルでharnsy installを実行し（その PATH を保存します）、harnsy を再起動して「Try again」（もう一度）を押します。 - 「The lead did not open: no terminal.」（リードが開きませんでした：ターミナルがありません）。 ターミナルが選ばれていません。「Choose a terminal」（ターミナルを選ぶ）を押すか、
~/.harnsy/config.yamlでterminal.driver: tmuxを設定し、再起動して「Try again」を押します。 - Claude からサインアウトされた。 リードのページで、もう一度サインインするよう求められます（リンクとコード）。そのあと、harnsy が自分でリードに最初のメッセージを送ります。
- 「My project」がフォルダーを受け付けない。
/または~から始まるフルパスを入力してください。フォルダーは実在し、ホームフォルダーの中にある必要があります。隠しフォルダー、一時フォルダー、harnsy 自身のフォルダー、ホームフォルダーそのものは受け付けません。 - Claude Code が2つあり、古いほうが先に見つかる。
claude --version（Windows ではwhere.exe claude）を実行し、1つだけ残してください。 - 社内プロキシの内側で何もつながらない。 「Settings › Reach from outside › Proxy」を開き、「Check」を押します。
- ほかにも：トラブルシューティング（英語）。
アップデート
アップデート
harnsy が自分から更新を確認することはありません。確認してから、アップデートします。
harnsy update --check
harnsy updateダッシュボードの「Check for updates」（更新を確認）と「Update」（アップデート）ボタンでも同じことができます。インストールコマンドをもう一度実行しても構いません。~/.harnsy のデータは残ります。ノードは数秒間再起動しますが、エージェントのセッションは動き続けます。
注記： その数秒のあいだに送ったメッセージは届きません。もう一度送ってください。Windows では、インストーラーがノードを再起動する前に確認します。
元に戻す
アップデートのあとで：
harnsy update --rollback --yesまたは、古いリリースを新しいリリースの上にインストールします（変数は curl ではなく sh に渡します）。
curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh -s -- --allow-older削除
harnsy uninstall --dry-run
harnsy uninstall差分（diff）を表示して確認したうえで、サービス、トレイ、プログラム、そしてインストール自身が追加した設定の項目だけを削除します（ブリーフィング用と回答用のフック、自動モードの項目、ステータスライン。インストールがあなたのステータスラインをラップしていた場合は、元のものに戻します）。
注記： それより前のバックアップは戻しません。
~/.harnsyのデータ、バックアップ、あなた自身が選んだターミナルの設定は残ります。あなたが Claude Code に与えた権限ルールやフォルダーの信頼は元に戻しません。ターミナルがない場合は何も質問せず、設定の項目はそのまま残します。
インストーラーについて詳しく
インストーラーがすること
書き込むもの、確認すること、触れないものをすべて。harnsy install --dry-run はすべての手順、変更するファイルごとの diff、作成するファイルごとのパスを表示し、何も変更しません。
あなたのユーザーアカウントの中だけ。
すべて、自分のユーザーのディレクトリに入ります。sudo も管理者権限も不要です。Linux と macOS では PATH もシェルのプロファイルも変更しません。~/.local/bin が PATH にない場合はそう表示するので、自分で追加するか、フルパスで harnsy を呼び出してください。Windows では %LOCALAPPDATA%\harnsy\bin をユーザーの PATH に追加します（一度だけ、管理者権限は不要）。すでに開いているウィンドウは古い PATH のままなので、新しいウィンドウで harnsy と入力してください。ユーザーの PATH を読めない、または変更できない場合は、その旨を表示し、手動でフォルダを追加するよう案内します（設定 → 環境変数）。harnsy uninstall でこの項目は削除されます。
ダウンロードを検証します。
ワンライナーのインストーラーは、OS と CPU に合ったリリースを GitHub から HTTPS でダウンロードし、ファイルがリリースの SHA256SUMS にない、または一致しない場合は停止します。Linux と macOS では、一時フォルダーに展開し、そこから harnsy install を実行し、終わるとそのフォルダーを削除します。この検証で分かるのは壊れたダウンロードや途中で切れたダウンロードです。チェックサムは同じリリースから取得しています。
確認なしで入れるのは3つだけ。
プログラム、インストール記録、そしてあなたのユーザー専用のバックグラウンドサービスです。サービスはすぐに起動し、ログインのたびに起動します。
| 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 が拒否した場合は HKCU\Software\Microsoft\Windows\CurrentVersion\Run の値 harnsy（クラッシュ後の再起動なし） |
別のサービスファイルやタスクがすでにある場合は、それを表示し、あなたが「はい」と答えたときだけ置き換えます。既存の ~/.local/bin/ccbus ファイルは ccbus.pre-harnsy に移されます。
自分で実行する場合は、そのほかのことも先に確認します。
どれも [y/N] の質問です。有効なのは y または yes だけで、無回答、ターミナルなし、--dry-run はすべて「いいえ」になります。0.8.0 からは、先に「はい」と答えていない場合に限り、ターミナルなしは「いいえ」になります（「先に「はい」と答える」を参照）。--dry-run は常に「いいえ」です。
- まだ何も選ばれていない間、ターミナルでエージェントを動かすかどうか（tmux がインストールされていれば tmux、なければ harnsy 独自のターミナルホスト。Windows では独自のホスト）。答えは harnsy の
config.yamlにterminal.driverとして保存されます。 - トレイアイコン（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 はおよそ1日1回、ライセンスサービス（lic.harnsy.dev）でそのキーを確認し、完全なキー、マシンIDのハッシュ（ID そのものはマシンの外に出ません）、一度限りのランダムな値、ライセンスパネルでのマシン名、OS とアーキテクチャ、harnsy のバージョンとそのビルド日を送ります。
触れないもの：
- MCP サーバー：任意の
claude mcp addの行を表示するので、実行はあなたが行います ~/.claude.json- Codex の
~/.codex/config.toml - OpenCode の設定
その後の動作中：config.yaml で claude.auto_trust: true にした場合に限り（既定ではオフ）、harnsy は Claude Code を開く前にプロジェクトフォルダーを ~/.claude.json で信頼済みにします。その前にファイルを ~/.harnsy の claude.json.bak にコピーします。harnsy が開く Codex には、フォルダーの信頼をコマンドラインフラグで渡すので、ファイルは書き込みません。
特定のリリース、または古いリリースに戻す
特定のリリース、または古いリリースに戻すには：curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<tag> sh（変数はパイプのあとに置きます）。データベースはテーブルと列が増えるだけなので、古いビルドでも開けます。
harnsy version でインストール済みのビルドがわかります。
社内プロキシ越しの場合
社内プロキシ越しの利用（0.9.1 から）: HTTPS_PROXY（と HTTP_PROXY）にプロキシを、NO_PROXY に直接つなぐホストを設定し、NO_PROXY には localhost,127.0.0.1,::1 を残してください。harnsy は起動時に一度だけこれらを読みます。Windows ではユーザー環境変数として設定してからサインアウトして再度サインインし、Linux と macOS では harnsy のサービス（systemd のユニットか launchd の plist）に追加してから再起動してください。harnsy net check が、ホストごとに到達できるか、できない理由（プロキシのログイン、TLS 検査、経路なし）を教えてくれます。
harnsy からエージェントを開く
harnsy は、あなたのエージェントをそれぞれ、自分で操作するウィンドウで、1 エージェント 1 タブで開きます。そのため、エージェントを開く、一覧にする、開き直すことができます。ターミナルをインストールしたり設定したりする必要はありません。harnsy がお使いのシステムに合うものを選びます。ターミナルがなくても、メッセージ、チーム、ダッシュボードは同じように動きます。エージェントを開いたり開き直したりできないだけです。
~/.harnsy/config.yaml
terminal:
driver: tmux # or: conpty~/.harnsy/config.yaml で手動で設定します。インストーラーまたは --first-run が代わりに設定します。
インストールについての質問
始める前に
最初に何が必要ですか？ Linux、macOS 13 以降、または Windows 10（1809）以降のコンピューター。そして、インストールしてサインインした Claude Code または Codex と、それに使える Anthropic または OpenAI のプランか API キーです。アカウント、インストール、サインインは、上のステップで順に案内します。harnsy が Claude Code や Codex を代わりにインストールすることはありません。
どのプランが必要ですか？ どのプランに Claude Code や Codex が含まれるかは提供元のルールで、変わることがあります。ステップ 1 にリンクがある、Anthropic と OpenAI の料金ページをご確認ください。harnsy がプログラムに尋ねるのは、サインインしているかどうかだけです。
特別なターミナルが必要ですか？ いいえ。harnsy はエージェントを、自分で操作するターミナルで動かし、お使いのシステムに合うものを選びます。Linux と macOS では tmux がインストールされていれば（3.1 以降）tmux、なければ harnsy 独自のターミナルホスト、Windows では常に harnsy 独自のターミナルホストです。そのために何かをインストールする必要はなく、ダッシュボードで各エージェントの様子をリアルタイムで見られます。ターミナルがなくても、メッセージ、チーム、ダッシュボードは動きます。harnsy がエージェントを開いたり開き直したりできないだけです。
プログラミングができないといけませんか？ いいえ。あなたは目標をふつうの言葉で伝え、チームが計画して作業します。始めるには、AIプログラムと harnsy をインストールし（ターミナルでコマンドを1〜2個）、サインインします。やり方は上のステップにあります。コードなど技術的な結果を判断するには、技術の分かる人がそばにいると楽です。
インストール
スクリプトをダウンロードするコマンドを実行する前に、知っておくことは？ スクリプトは先に読めます。ブラウザーでアドレスを開いてください。--dry-run はすべての手順とすべての変更を表示し、何も書き込みません。インストーラーはあなたのユーザーアカウントの中で動き、管理者権限を求めません。また、ダウンロードしたものをリリースの SHA256SUMS と照合します（これはファイルが壊れずに届いたことを示すもので、誰が作ったかを示すものではありません）。あなたの設定ファイルへの変更は、どれも先に差分（diff）として表示され、バックアップが残ります。
インストーラーは私のコンピューターで何を変えますか？ プログラムをあなたのユーザーフォルダーに置き、あなたのアカウント用のバックグラウンドサービスとして起動します。--first-run を付けると、さらに harnsy 自身のひとそろいの項目に前もって「はい」と答えます（エージェントがそれぞれのウィンドウで開く、新しいエージェントごとに harnsy についての短いメモが渡る、エージェントの質問にブラウザーから答えられる、エージェントが毎回確認せずに harnsy とやり取りする）。これにより Claude Code と Codex の設定ファイル（フック）が変わります。トレイのアイコンとステータスラインは設定しません。最後に「What changed on this computer」（このコンピューターで変わったこと）と、元に戻す方法を表示します。全項目は下の「インストーラーが行うこと」にあります。インストールを元に戻すには harnsy uninstall を実行します。harnsy がインストールしたプログラム、サービス、トレイを削除し、変更を1つずつ見せて確認したうえで、harnsy が Claude Code の設定に追加した項目（harnsy のフック、自動モード用の権限の項目、harnsy が設定した場合はステータスライン）を削除します。先にバックアップを作り、バックアップ、~/.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 はコマンドでインストールするので、その1ステップにはターミナルが必要です。AIプログラムに代わりにやってもらうこともできます（このページ上部のプロンプト）。インストールで何が変わるかを伝え、あなたの「はい」を待ちます。AIプログラムがインストーラーを実行できない場合は、あなた自身でコマンドを実行するよう頼まれます。
最初のチーム
初回起動では「company」、ダッシュボードでは「Organization」なのはなぜですか？ 同じものです。会社とは、あなたのプロジェクトをまとめるグループです。初回起動では、より簡単な言葉を使っています。
リードは必ず最初にプロジェクトを調べますか？ すでにあるフォルダーから始めるとき（「My project」）だけです。何も変えずにフォルダーを読み、計画を示し、あなたが承認するのを待ちます。新しいプロジェクトでは、いくつか質問をし、最初の目標を提案して、作業に取りかかります。
Claude Code の代わりに Codex を使えますか？ はい。Codex は最初の画面のもう1つの選択肢で、リードはどちらでも動きます。Codex の質問はダッシュボードに届きますが、承認の確認は Codex 自身のターミナルウィンドウに残ります。
harnsy は私の Claude のログインを見ますか？ harnsy はログインを使うために読むことはなく、どこにも送りません。Claude Code に、サインインしているかどうかを尋ねるだけです。ログインが入っていることがある Claude Code の設定ファイルのバックアップは、このコンピューターに残ります。「キー、ログイン、接続」を参照してください。Codex の場合は、保存されたログインがあるかどうかだけを見ます。コピーも保存も送信もしません。
3つ目のプロジェクトを追加できないのはなぜですか？ 無料の harnsy では、組織は1つ、プロジェクトは2つまでで、エージェントの数に上限はありません。それより多くは harnsy Max で使えます。上限に達するとメッセージでお知らせし、組織はそのまま動き続けます。（0.11.0 から。）
ここにない質問はどこで聞けますか？ 質問する。