Notiamoは、プロジェクトの未対応のコメントやタスクに対してAIエージェントを動かせます。エージェントが変更を加え、チームの誰かが承認します。実行はNotiamoのサーバーでも、あなたが所有するコンピューターでも行えます。このページでは後者を説明します。マシンに入れる小さなプログラム、ランナーです。代理店チーム向けです。

ランナーとは

ランナーは、あなたの組織がNotiamoでキューに入れたエージェントの実行を待ち受けます。実行ごとに、リポジトリをクローンし(またはWordPressサイトに接続し)、その実行の指示でClaude Codeを起動し、エージェントの動きをNotiamoに送り、終わったら報告します。

  • Claudeの認証情報は持ちません。 マシンにすでにある claude プログラムを起動します。ランナーのセッションは専用の設定フォルダーを使うので、あなた自身のセッションとは分かれています。ログインそのものはClaude Codeのもので、Claude Codeが保管します。
  • NotiamoにClaudeでログインするものではありません。 NotiamoはあなたのClaudeアカウントを見ることも使うこともありません。ランナーは、あなたのマシンで、あなた自身の作業のために、あなた自身のClaude Codeを動かすだけです。

インストールする

必要なもの:

  • Node.js 22以降
  • Claude Code 2.1.314以降
  • git 2.31以降
  • LinuxとWSL2では bubblewrap と socat(DebianまたはUbuntuでは sudo apt install bubblewrap socat)。macOSでは追加のインストールは不要です。

そのうえで:

  1. Notiamoで 設定 › エージェント実行 を開きます。ランナー カードで 新しいランナー を押し、名前を付けます。トークンをコピーします。表示されるのは1回だけです。
  2. マシンで次を実行します。
npx @notiamo/runner init
  1. トークンを貼り付けます。init は、Claude Codeが動くことを確認し、ランナー用にClaude Codeのログインを実行し、サービスをインストールして起動します。
  2. プロジェクトで、エージェントの実行場所 を 自分のマシン にします。

init が終わると、ランナーは動いています。ログインや再起動のあとも、自動でもう一度起動します。

コマンド

コマンド 内容
npx @notiamo/runner init ランナーをセットアップします。トークン、Claude Codeのログイン、サービスのインストールと起動。
npx @notiamo/runner@latest update ランナーを最新バージョンにします。トークン、名前、ログインはそのままです。
npx @notiamo/runner status サービスがインストールされて動いているかを伝え、ログの最後の1行を表示します。
npx @notiamo/runner logs ログの最後の50行を表示します。
npx @notiamo/runner stop 次のログインか起動まで、サービスを止めます。
npx @notiamo/runner uninstall サービスを削除します。ランナーのフォルダーは残ります。
npx @notiamo/runner env <projectId> このマシンが1つのプロジェクトの実行に渡すenvファイルを作成または表示します。
npx @notiamo/runner start フォアグラウンドで実行します。サービスが実行するのはこれで、ふだんは使いません。

サービスは、macOSではlaunchdエージェント com.notiamo.runner、Windowsではタスクスケジューラのタスク「Notiamo runner」、Linuxではsystemdのユーザーユニット notiamo-runner です。

1台のマシンに2つのランナー

npx @notiamo/runner init --profile staging で、2つ目の独立したランナーをセットアップします。専用のフォルダー(~/.notiamo-runner/profiles/staging)と専用のサービスを持ちます。そのランナーのコマンドにはすべて --profile staging を付けてください。プロファイル名は、英字、数字、ハイフンで、1〜32文字です。

エージェントが触れるもの、触れないもの

実行ごとに、専用のClaude Code設定ファイルが作られます。次の3つがエージェントを持ち場に留めます。

ファイルツールは実行フォルダーの中だけです。 Claude自身のファイルツール(読み取り、編集、書き込み、検索)は、その実行のフォルダーの外にあるものを一切拒否します。許可を求める呼び出しは、答える人がいないので拒否されます。

シェルコマンドはOSのサンドボックス内で動きます。 macOS(Seatbelt)と、LinuxまたはWSL2(bubblewrapとsocat)では、エージェントがシェルで実行するコマンドはすべて閉じ込められます。サンドボックスを起動できないときは、実行は始まりません。

マシンの認証情報はエージェントに届きません。 Claude Codeに渡されるのは、短い環境変数のリスト(PATH、HOME、USER、LOGNAME、SHELL、LANG、LC_ALL、LC_CTYPE、TERM、TMPDIR、TZ、XDG_*、プロキシと証明書の設定)と、その実行専用の変数だけです。SSH_AUTH_SOCK、GH_TOKEN、GITHUB_TOKEN、NPM_TOKEN、AWS_*、ANTHROPIC_* は決して渡されません。エージェントのgitには、グローバルやシステムのgit設定は見えません。

シェルのサンドボックスが許可するものと拒否するもの:

  • 読み取りを拒否: 他のプロジェクトのフォルダー(同時に動いている他の実行を含む)、ランナー自身のファイル、あなたの認証情報のファイルとフォルダー(SSHキー、クラウドのログイン、パッケージレジストリのログイン、git認証情報)。
  • 書き込みを許可: 実行フォルダーと、その隣にあるプロジェクトのパッケージキャッシュフォルダーのみ。実行の .git/hooks と .git/config は読み取り専用です。
  • ネットワークを許可: GitHub、npm、Notiamo、WordPressサイト(WordPressの実行の場合)、そして ランナー カードの エージェントが接続できる追加ホスト に追加したホスト。それ以外はすべて拒否されます。

エージェントは決してプッシュせず、認証情報も持ちません。エージェントの作業が終わったあと、ランナーが自分で実行のブランチをプッシュします。

実行が終わると、ランナーは、開発サーバーなど、エージェントが残したプロセスをすべて止めます。

macOSのキーチェーン

macOSのサンドボックスは、キーチェーンを完全には閉じません。ですから、ランナーを動かすユーザーのキーチェーンにGitHubのログインを残さないでください(init は見つけると警告します)。最も安全なのは、専用のキーチェーンを持つ専用のmacOSユーザーを使うことです。

Windows

通常のWindowsには、シェルのサンドボックスがありません。そのため、コメント内の文章によって、実行があなたの権限で任意のコマンドを動かしてしまうおそれがあります。WSL2の中でランナーを動かしてください。通常のWindowsでは、ランナーの config.json に "allowUnsandboxed": true を追加しない限り、ランナーは起動しません。追加するのは、ほかに何も置いていないマシンだけにしてください。

同時に複数の実行

ランナー カードで 同時実行数 を1〜3に設定します。実行ごとにあなたのClaudeプランを使うので、プランに余裕のある数にしてください。1つのプロジェクトが同時に2回動くことはありません。同じプロジェクトの2回目の実行は、1回目を待ちます。

同時に動く実行には、それぞれ専用のスロットフォルダーがあります。ある実行のサンドボックスは、他のスロットを読めません。

1つのクライアント専用のランナー

ランナーを作るとき、実行対象 で1つのワークスペースに限定できます。そうすると、そのクライアントの実行だけを受け取ります。クライアントのコンピューターで設定するには、そこにClaude Codeをインストールし、npx @notiamo/runner init を実行して、ランナーのトークンを貼り付けます。実行の費用は、そのコンピューターのClaudeログインが負担します。支払うべきアカウントでログインしてください。

セットアップコマンドとテストコマンド

クローンしたばかりの状態には、パッケージが入っていません。インストール方法とテスト方法をエージェントに伝えましょう。プロジェクトのエージェント設定を開き、セットアップコマンド と テストコマンド を1行ずつ入力します。

  • エージェントは、最初の変更の前に セットアップコマンド を1回実行します。例:pnpm install --frozen-lockfile。
  • エージェントは、コミットのたびに テストコマンド を実行します。それに通らない変更は、直すか取り消されます。例:pnpm typecheck && pnpm lint。
  • エージェントは両方を、他のコマンドと同じサンドボックスの中で自分で実行します。パッケージレジストリは許可されたホストに入っている必要があります。GitHubと registry.npmjs.org は初期設定で入っています。それ以外(PyPI、crates.io、プライベートレジストリ)は、ランナー カードの エージェントが接続できる追加ホスト に追加してください。
  • プロジェクトごとに、クローンの隣に パッケージキャッシュフォルダー があります。サンドボックスがホームフォルダー内のふだんの場所を閉じているため、npm、pnpm、Yarn、Corepack、Bun、pip、uv、Composerはキャッシュをここに置きます。このフォルダーはプロジェクトの実行のあいだ残り、クローンと一緒になくなります。通常のWindowsにはありません。
  • テストコマンドは軽くしてください。Dockerが必要なテストは動きません。データベースが必要なテストは、プロジェクトのenvファイルが、あなたが動かし続けているデータベースを指している場合にだけ動きます(下記参照)。

エージェントは「Notiamo agent」としてコミットし、項目ごとにシンプルな1行を書きます。ランナーはClaude Codeの「Co-Authored-By」トレーラーと「Generated with」の行をオフにするので、リポジトリにAIの共同作成者は表示されません。

自分のプロジェクト用の環境

GitHubプロジェクトでの実行には、きれいなクローンだけが渡されます。それ以外はありません。自分のソフトウェアプロジェクトでは、テストにデータベース、ファイルストア、メールキャッチャー、.env も必要になることがあります。ランナーのマシンは、1つのプロジェクトの実行に、次のようなプレーンなファイルでそれらを渡します。

npx @notiamo/runner env <projectId>

<projectId> は、Notiamoのプロジェクトページのアドレスの最後の部分です。このコマンドは ~/.notiamo-runner/env/<projectId>.env を作成し(あなただけが読めます)、そのパスを表示します。1行に1つ、KEY=VALUE を書きます。そのプロジェクトの次の実行は、シェルでその変数を受け取り、エージェントには名前だけが伝えられて、値は決して伝えられません。ファイルを削除すれば、変数もなくなります。このファイルはマシンの外に出ません。Notiamoはその存在を知りません。

ファイルがあると、macOSでは、実行のシェルが 127.0.0.1 のサービスにも届きます。あなたのPostgres、ファイルストア、開発サーバーなどです。それらは動かし続けるのはあなたで、エージェントは起動できず、Dockerもエージェントの手の届かない所にあります。Linuxではサンドボックスが専用のネットワークを持つため、そこでの 127.0.0.1 はマシンのものではありません。サービスをマシンのネットワークアドレスにバインドし、そのホストを エージェントが接続できる追加ホスト に追加してください。

ルール:

  • 開発用とテスト用の値だけにしてください。 エージェントはシェルコマンドを実行し、すべての変数を読めます。本番のキーや、他で使っているパスワードは絶対に入れないでください。
  • PATH、HOME、プロキシと証明書の変数、NODE_OPTIONS、NODE_TLS_REJECT_UNAUTHORIZED、NOTIAMO_*、GIT_*、CLAUDE_*、ANTHROPIC_* は無視され、ログにそう記録されます。このファイルで変えられるのは、エージェントのコマンドに見えるものだけです。Claude CodeがAnthropicやNotiamoと通信する方法は変えられません。
  • 6文字以上の値は、Notiamoが受け取る記録の中で [secret] として伏せられます。短い値(1、true)は伏せられません。
  • 1つのランナーのプロジェクトがenvファイルを通じてデータベースを共有している場合は、同時実行数 を1のままにしてください。同時に2つの実行があると、同じデータベースでテストが動いてしまいます。

WordPressサイト

接続は、プロジェクトの ウェブサイトへのアクセス カードにあります。アプリケーションパスワードと、必要に応じてSSHまたはFTPです。ランナーは最初の接続時にSSHサーバーの鍵を記憶し、あとで別の鍵を示すサーバーを拒否します。実行は次のように進みます。

  1. 事前にバックアップ。 SSHの場合、ランナーはデータベースをエクスポートし、圧縮してNotiamoにアップロードします。上限は200 MBです。Notiamoはこれを30日間保管します。FTPまたはAPIのみの場合、バックアップはありません。
  2. エージェントは、下の許可リストに沿って作業します。
  3. 事後にサイトを確認。 ランナーはサイトを開き、まだ応答することを確認します。
  4. 失敗したら復元。 確認に失敗すると、ランナーはデータベースを復元します。

エージェントがwp-cliで実行できるもの。グループごと(プロジェクトで設定)です。

  • コンテンツ: post *、term *、menu *、media import、option get、option update。
  • データベース: search-replace(古い文字列と新しい文字列だけを指定できます。ユーザーのテーブルとオプションのテーブルには決して触れません)、cache flush、rewrite flush、transient delete。
  • プラグインとテーマ: plugin と theme の list、activate、deactivate、update。
  • 情報: core version、site list、db size。
  • ファイル: wp-cliのコマンドはありません。エージェントはファイルツールを使います。ファイルツールは、スタイル、スクリプト、そのほかサーバーが実行しないファイルを書き込みます。
  • PHPファイル(初期設定はオフ): ファイルツールはPHPも書き込めます。PHPファイルはあなたのサーバーで実行されるコードで、WordPressの実行には承認の手順がありません。変更はすぐに公開されます。コメントを書ける全員を信頼できるサイトでだけ、オンにしてください。
  • 決して許可されないもの(「すべてを許可」を選んだ場合を除く): eval、eval-file、shell、user *、db query|import|reset|drop|export、plugin install、theme install、core update|download。

何がどこに保存されるか

すべて ~/.notiamo-runner の中にあります。

パス 内容
config.json Notiamoのアドレス、ランナーの名前、ランナーのトークン。あなただけが読めます。
claude/ ランナー用のClaude Codeの設定フォルダー。ログインとセッション。
projects/ プロジェクトの作業コピー。各スロットにプロジェクトごとに1フォルダー。ランナー カードで設定した日数のあいだ使われなかったプロジェクトは削除され、次の実行でもう一度クローンされます。
git/ ランナー専用のリポジトリのコピー。エージェントはこのフォルダーを読むことも書くこともできません。
env/ あなたが作ったenvファイル。プロジェクトごとに1つ。
runs/ 進行中の各実行のClaude Code設定。シークレットは含みません。実行が終わると削除されます。
runner.log ランナーがしたこと。シークレットは含みません。
state.json 進行中の実行のID。再起動のあと、それぞれがNotiamoに失敗として報告されます。

実行のシークレット(WordPressのパスワード、その実行専用のトークン)は、実行と一緒にNotiamoから届き、メモリ上にだけ置かれます。エージェントはそれらを環境変数として受け取り、ファイルでは決して受け取りません。エージェントが出力した内容は、記録をアップロードする前にそれらが取り除かれます。

ランナーは、マシンのgit認証情報を一切使いません。実行ごとに、Notiamoから1時間だけ有効で、その実行のリポジトリにだけ使えるGitHubトークンを受け取ります。ランナーはそれをメモリ上に保持し、自分のfetchとpushに使います。プルリクエストを作成してマージするのはNotiamoです。

ランナーを止める

ランナー カードで、無効にする を押すとランナーを一時停止でき、削除 を押すと取り除けます。削除したランナーのトークンは、すぐに使えなくなります。