HN 日本語サマリー

← 一覧へ戻る
プログラミング

コーディングエージェントに認証情報を渡さずに実行する方法

Running coding agents without handing them my credentials (blog.antonio.cx)

113 pointsby antoniomika80 コメント

要約

この記事では、リモートで動作するコーディングエージェントがローカルマシン上のツールや認証情報に安全にアクセスできるようにするための「lend」というツールの仕組みを解説しています。lendは、エージェントが直接認証情報にアクセスするのではなく、ユーザーの承認を得てローカルでコマンドを実行するプロキシとして機能し、セキュリティリスクを低減します。

全文翻訳

コーディングエージェントに認証情報を渡さずに実行する方法

2026-11-13 · antonio's blog


目次

リモートエージェントが私の承認を得てラップトップ上のツールを使用できるようにするために lend を開発しました。私のワークフローにどのように組み込まれているか説明します。

背景 #

私は現在、ツールチェーンの一部としてエージェントを多用しています。通常、同時にいくつか稼働させています。Claude Code があるリポジトリで作業し、Codex が別のリポジトリのブランチをレビューし、何か長時間実行されるものがバックグラウンドで動いています。しばしば、それらが互いの作業をレビューさせることもあります。それらのどれも私のラップトップ上では実行されません。使い捨て可能なVM上で実行され、私のラップトップは私が気にかけているもの、つまり私のSSHキー、1Passwordのボールト、そして私としてログインしている gh およびクラウドCLIを保持します。

エージェントがこれらのいずれかを必要とするまで、これはうまく機能します。この記事では、herdr と Ovis を使用してエージェントを並列実行する方法と、認証情報の問題を解決するために私が書いたツール lend について説明します。

herdr #

herdr はコーディングエージェントのために構築されたターミナルマルチプレクサです。通常のワークスペース、タブ、ペインに加え、各ペインでどのエージェントが実行されており、何をしているかを認識します。サイドバーには、各エージェントが作業中か、私を待っているか、完了したかが表示されるため、どれが注意を必要としているかを一目で判断できます。

CLIは実行中のセッションと通信するため、エージェントは互いを駆動できます。エージェントは別のペインでCodexを起動し、プロンプトを与え、完了を待って、その内容を読み取ることができます。

1herdr agent start reviewer --kind codex --pane "$PANE"
2herdr agent prompt reviewer "Review the diff on am/fix-retries" --wait --until done
3herdr agent read reviewer --source recent

リモートホストも同様に機能します。herdr machine add agent-vm はVM上にherdrを設定し、そのセッションをローカルクライアントに追加します。それらのセッションは、私が切断した後も実行を続けます。

Ovis #

Ovis はherdrのブラウザおよび電話クライアントです。各エージェントのトランスクリプトをチャットとして表示し、ライブターミナルはタップでアクセスできます。エージェントが承認を求めたり質問したりすると、Ovis はそれをカードに変換して私が応答できるようにし、プッシュ通知を送信します。herdrに保存されているマシンを拾うため、VMは追加設定なしで表示されます。Tailscale経由でアクセスします。

デスクから離れている間にエージェントが質問でスタックした場合、電話から応答すると、他のエージェントは続行します。

認証情報の問題 #

VM上のエージェントは、私として行動する必要があります。私はそれらを使用して gh でCIを監視したり、1PasswordのトークンでAPIを呼び出したり、他のホストにSSH接続したりします。それを行うための一般的な方法は2つありますが、どちらも気に入っていません。

1つ目は、VMに認証情報をコピーすることです。~/.config/gh/hosts.yml のトークンは、トークンが有効である限り、そのマシン上のすべてのプロセス(エージェントとその実行プロセスを含む)が読み取ることができます。

2つ目は、ssh -A でSSHエージェントをフォワーディングすることです。秘密鍵は私のラップトップに残りますが、VMはエージェント内のすべてのキーを尋ねることなく、記録なしで使用できます。また、SSHキーのみをカバーします。

私が望んでいたのは、認証情報がラップトップに残り、それらを必要とするコマンドもそこで実行されることでした。エージェントが何かを実行するように求め、私がTouch IDで承認し、エージェントが出力を受け取る、という流れです。

lend #

そこでlendの出番です。lendは既存のSSHエージェントの前に配置されるプロキシであり、実際のソケットの代わりにそのソケットをフォワーディングします。SSHとGitは通常通り機能し続け、lendはSSHエージェント拡張機能を通じてコマンドを実行する方法を追加します。

VM上のエージェントが gh を実行するように求めると、リクエストはソケットを介して送信され、gh は私のログイン情報でラップトップ上で実行されます。トークンはラップトップから離れないため、エージェントはそれを決して取得しません。署名であれコマンドであれ、すべてのリクエストはラップトップ上のポリシーに対してチェックされ、何も起こる前に私の承認が必要です。

1Remote: lend exec -- command args
2                  |
3          forwarded SSH agent socket
4                  |
5Laptop: lend agent -> policy + local approval -> local command
6                                           -> original SSH agent (signing)

ポリシーはラップトップ上にあり、VMが要求できるものをリストします。それ以外はすべて拒否されます。私のポリシーはかなり短いです。

 1{
 2  "default": "deny",
 3  "commands": [
 4    {"executable": "/opt/homebrew/bin/gh", "approval": "biometric:inline"}
 5  ],
 6  "ssh": {
 7    "default": "deny",
 8    "keys": [
 9      {"fingerprint": "SHA256:...", "approval": "biometric:inline"}
10    ]
11  }
12}

ルールは、サブコマンドの一部のみを許可したい場合に args_prefix のようなもの(例: ["pr", "view"])を取ることもできます。biometric:inline は、リクエストダイアログに直接Touch IDを配置するため、リクエストを読んで一度タッチするだけで承認できます。通常の biometric は、許可をクリックした後に別のプロンプトでTouch IDを求めます。

接続するには、ラップトップから lend ssh を実行します。これは1つの接続のためにプロキシを開始し、SSHが終了すると停止します。

1lend ssh --config ./policy.json -- agent-vm

VM上でherdrを実行します。Claude Codeは、run_local_command という単一のツールを持つMCPサーバーである lend mcp を介してlendと通信します。このツールは、実行するコマンドと理由を受け取ります。理由は必須です。

1{
2  "mcpServers": {
3    "laptop": {"command": "lend", "args": ["mcp"]}
4  }
5}

ここで、Claude CodeにVM上でlendリポジトリの説明を求めたところ、ツールを gh repo view で呼び出し、私のMacにリクエストが表示され、一度のタッチで承認されました。

[画像: VM上のClaude Codeがラップトップ上で gh repo view を実行するように求めます。Mac上のlendダイアログにはリクエストと呼び出し元が表示され、Touch IDで承認されると、Claudeはリポジトリの説明を出力します。]

ダイアログには、実行可能ファイルのフルパス、すべての引数、ラップトップ上で実行されるディレクトリ、理由、およびリモートプロセスが自身について述べた内容が表示されます。承認すると、gh はラップトップ上で実行され、stdout、stderr、および終了コードがエージェントにストリームバックされます。理由と呼び出し元の詳細はVMから提供されるため、検証済みでないとマークされます。これらは私が決定するのに役立ちますが、ポリシーが許可するものを変更することはできません。

MCPをスキップしたい場合は、VM上での通常のCLI呼び出しとして同じリクエストが機能します。

1lend exec --reason "Read the repo description" -- gh repo view antoniomika/lend
再接続を跨いでソケットを安定させる #

herdrのペインはSSH切断を乗り越えますが、フォワーディングされたソケットはその接続に属します。再接続すると、SSHは新しいソケットパスを提供します。ペインでまだ実行中のエージェントは古い SSH_AUTH_SOCK を保持します。

固定パスにシンボリックリンクを使用し、VM上の ~/.ssh/rc から更新します。SSHはシェルを開始する前にこれを実行するため、新しい接続によってフォワーディングされたソケットを確認します。

 1#!/bin/sh
 2
 3if [ -n "${SSH_AUTH_SOCK:-}" ] &&
 4    [ "$SSH_AUTH_SOCK" != "$HOME/.ssh/lend/agent.sock" ] &&
 5    "$HOME/.local/bin/lend" doctor --remote --socket "$SSH_AUTH_SOCK" --timeout 1s >/dev/null 2>&1; then
 6  install -d -m 700 "$HOME/.ssh/lend" &&
 7    ln -sfn -- "$SSH_AUTH_SOCK" "$HOME/.ssh/lend/agent.sock"
 8fi
 9
10if [ -n "${DISPLAY:-}" ] && read -r _ssh_proto _ssh_cookie; then
11  case $DISPLAY in
12    localhost:*) _ssh_display="unix:${DISPLAY#localhost:}" ;;
13    *) _ssh_display=$DISPLAY ;;
14  esac
15  printf 'add %s %s %s\n' "$_ssh_display" "$_ssh_proto" "$_ssh_cookie" | /usr/bin/xauth -q -
16fi

チェックは、フォワーディングされたソケットがlendを話すことを確認してからリンクを更新します。ディレクトリは私のユーザー専用であり、このリンクを他のエージェントソケットから分離します。lendの絶対パスを使用するのは、シェルが ~/.local/bin をPATHに追加する前にこれが実行されるためです。X11ブロックは、ファイルが存在する場合にSSHがこれを委任するCookieセットアップを処理します。

私の ~/.bashrc は、それをエクスポートする前に安定したパスをチェックします。

1if [ -S "$HOME/.ssh/lend/agent.sock" ] &&
2    "$HOME/.local/bin/lend" doctor --remote --socket "$HOME/.ssh/lend/agent.sock" --timeout 1s >/dev/null 2>&1; then
3  export SSH_AUTH_SOCK="$HOME/.ssh/lend/agent.sock"
4fi

herdrペインでの新しいBashシェルは、それが機能する場合に安定したパスを取得します。チェックが失敗した場合、Bashは SSH_AUTH_SOCK を変更しません。MCP、承認フック、およびGitは、それらを起動したときにそのパスを継承します。再接続後、SSHフックはシンボリックリンクを更新し、それらのプロセスは後続のリクエストで新しいソケットを使用します。古いソケットパスで既に実行されているエージェントは、環境に安定したパスを設定して一度再起動する必要があります。

ラップトップからのSSH接続は開いたままにする必要があります。切断中はリクエストは失敗し、再接続すると新しい承認とリースを持つ新しいlendセッションが開始されます。リンクは一度に1つの接続を指すため、最後の更新が優先されます。

エージェントが見ることのないシークレット #

gh は私のラップトップで既にログインしているため機能します。一部のツールはトークンを渡す必要があります。それらの場合、コマンドルールは op read のようなものでシークレットを読み取り、承認されたコマンドに環境変数として渡すことができます。

 1{
 2  "secret_reader": "/opt/homebrew/bin/op",
 3  "secret_reader_args": ["read", "--no-newline"],
 4  "commands": [
 5    {
 6      "executable": "/opt/homebrew/bin/gh",
 7      "args_prefix": ["pr", "view"],
 8      "approval": "biometric",
 9      "secrets": {"GH_TOKEN": "op://Development/github/token"}
10    }
11  ]
12}

エージェントが gh pr view を実行するように求め、私がそれを承認すると、lendは1Passwordからトークンを読み取り、GH_TOKEN を設定して gh を実行し、出力を返します。トークンはラップトップ上に留まります。VMはどの変数が設定されるか、どの参照が読み取られるかを選択できません。プロンプトには変数名と参照が表示されますが、値はプロンプトや履歴に表示されることはありません。

ここでは、GH_TOKEN を注入するルールで gh api user を実行しているVMを示します。lendで承認した後、op read がトークンを返す前に、1Passwordが独自のTouch IDを求めます。VMは私のログイン情報を受け取りますが、VM自身の環境には GH_TOKEN はありません。

[画像: VMが gh api user を実行し、ラップトップ上で承認を求めます。]

1つの注意点があります。これは、承認されたコマンドが環境を出力しない場合にのみ機能します。env や sh を承認した場合、値はそのまま返されます。同様に、op 自体をコマンドとして許可する場合も同様です。なぜなら、op read はシークレットを出力し、その出力は直接エージェントに送られるからです。

SSHキー #

キーにも独自のポリシーがあります。リストされていないキーはVMから隠され、リストされているキーは署名できるものに制限できます。max_signatures は、セッション中にキーが作成できる署名の数を制限します。

リース #

ルールは承認時にリース(例: 5分または3回使用)を提供できます。リースは lend ssh セッション内でのみ存在し、私が承認した正確なコマンドと引数にのみ一致します。セッションが終了するか、画面がロックされると消滅します。

何が起こったかを確認する #

lend status --all --watch は、接続されているもの、待機中、実行中、およびアクティブなリースを表示します。lend pause --all はすべてをキャンセルし、再開するまで新しいリクエストを拒否します。lend history は、何が実行され、どのように承認されたかの記録を保持します。引数、出力、およびシークレットは除外され、引数のロギングをオプトインできます。

ラップトップからエージェントのプロンプトに応答する #

エージェントは、VM上のシェルコマンドの実行、ファイルの編集、URLの取得など、私の認証情報とは無関係なことの許可も求めます。lend approve はこれらの質問を私のMac上の同じダイアログに送信します。ラップトップ上で何も実行しません。私に尋ね、エージェントは回答をどうするかを決定します。

Claude Codeの場合、VM上の PermissionRequest フックです。

1{
2  "hooks": {
3    "PermissionRequest": [
4      {"matcher": "*", "hooks": [{"type": "command", "command": "lend approve --hook claude-code"}]}
5    ]
6  }
7}

これで、Claude Codeが通常ターミナルで停止して尋ねる代わりに、私のMacにコマンドまたはツールの入力が表示され、Touch IDで応答します。ラップトップのポリシーは、どのトピックが質問を許可されるかをリストし、それぞれに独自の承認があります。

1"approvals": {
2  "topics": [{"name": "claude-code", "approval": "biometric:inline"}]
3}

Codex、Antigravity、pi 用のアダプターがあり、その他すべて用のプレーンJSON形式もあります。スクリプトでも使用できます。lend approve --topic deploy --title "terraform apply" && terraform apply は、ラップトップで承認された後にのみ terraform apply を実行します。ラップトップに到達できない場合、フックは邪魔にならず、エージェントは通常通り独自のUIで尋ねます。

lendが保護しないもの #

承認されたコマンドは私のユーザーとして実行され、私のファイルにアクセスできます。承認は実行されるものを決定し、lendはそれをサンドボックス化しません。シェル、インタプリタ、または標準入力から命令を読み取るものを承認した場合、標準入力は承認後にストリームされ、プロンプトに表示されないため、基本的にラップトップ上のすべてを実行することを承認したことになります。

プロンプトの呼び出し元詳細はVMから提供され、偽造される可能性があります。VM上のフォワーディングされたソケットにアクセスできる人(rootを含む)は、セッションが開いている間リクエストを行うことができます。ポリシーは依然として要求できるものを制限し、すべてのリクエストは依然として私の承認を必要とします。

lendはまだ初期段階であり、macOSとLinuxで動作します。PTYを割り当てないため、インタラクティブなプログラムはlend経由では機能しません。Linuxでは、承認はZenityダイアログまたはターミナルプロンプトであり、生体認証による承認はmacOSのみです。

先行事例 #

ssh-rev-exec はローカル実行リクエストをSSHエージェントプロキシ経由で送信し、op-forward はデスクトップ認証を備えたマシンに1Password CLIコマンドをフォワーディングします。lendは、同じエージェント拡張トリックを使用し、リクエストごとのポリシー、ローカル承認、およびキーフィルタリングを追加する別の実装です。

試してみる #

ラップトップとリモートホストの両方にlendをインストールします。

1brew install antoniomika/tap/lend
2# または
3curl -fsSL https://github.com/antoniomika/lend/releases/latest/download/install.sh | sh

ラップトップで lend doctor を実行して、ポリシー、実行可能ファイル、アップストリームエージェント、および承認設定を確認します。VMで lend doctor --remote を実行して、フォワーディングされたソケットが実際にlendであることを確認します。入門ガイド は最初のセッションを walkthrough し、ドキュメント はポリシー、承認、およびMCPをカバーしています。試してみたら、GitHub でどのように進んだか教えていただけると嬉しいです。