
1Password CLI Windows【2026】EC運営のAPIキー管理術
楽天やAmazonなどのEC運営者で、受注や在庫、レポート集めをPythonで自動化している方へ。そのAPIキー(プログラムがサービスに入るための鍵)、平文のファイル(そのまま読める形)に置いていませんか。
この記事では、Windowsで「1Password CLI」を使い、キーを「実行の瞬間だけ渡す」形に移す手順を書きます。実機で試すと、3か所でつまずきました。保管庫(値をしまう引き出し)の日本語名、途中で切れるトークン(合鍵の文字列)、上書きされるクリップボードです。対処も全部載せます。(2026年10月時点)

📌 この記事でわかること
Windowsなら、1Password CLI の `op run`(実行時に値を渡す命令)を使います。読み取り専用のサービスアカウント(プログラム専用の合鍵)と組み、平文のAPIキーを減らせます
最初の1歩は、ダミーの値で疎通試験(値がきちんと届くかの試し)まで。契約が済んでいれば、保管庫づくりから疎通試験まで(1-4〜1-8)30〜60分でできます(私の環境での目安)
契約・保管庫・合鍵の保存・CLIの導入・1本目の移行まで、コマンドを全文載せました
コマンドを使わない方・スクリプトを外注している方向けに、今日できる3つ(外注先に聞く質問など)も先に載せました
この方法で守れるもの・守れないもの、向かない場面も正直に書きました
何を移して、何を移さないか。1日の読み取り上限から決める判断軸を書きました
Claude Code などのAIと同じPCで使うなら、暗号化だけでは足りません。AIがコマンドを実行する直前に止める「フック」の作り方と落とし穴3つも扱います
🧰 始める前にそろえるもの
始める前に、次の6つを確かめておきます。
1Password の契約:個人向けの Individual で、サービスアカウントを作れました(1-3)
Windows 10 か 11:私は Windows 11 で試しました
PowerShell:Windows に最初から入っています。開き方は 1-6 に書きました
Python と、その場所:自動化のスクリプトを動かしている `python.exe` の場所(調べ方は 1-8)
動かしたい bat と、定時実行のタスク:タスクがどの Windows ユーザー(PCにサインインするときのアカウント)で動いているかも確かめます(1-6)
作業時間:契約が済んでいれば、保管庫づくりから疎通試験まで(1-4〜1-8)が30〜60分ほど(私の環境での目安)。1本目の移行は2日ほど(丸1日の様子見を含む。これも私の場合の目安)
第2部のフックは、Git Bash(Git for Windows に付いてくる、コマンドを打つ画面)を使います。中級者向けの内容です。スクリプトを外注している方は、外注先や詳しい方と一緒に読むと安心できます。
💻 コマンドを使わない方は、ここだけ
この記事の第1部は、外注先にそのまま渡せる手順書として書いています。 ただし、1-5 のトークン(合鍵の文字列)のコピーと、1-6 の保存だけは、自分の手でやります。トークンを外注先に送らずに済ませるためです。
とはいえ、ひとりで抱え込む必要はありません。画面共有で外注先に手順を読み上げてもらいながら進めれば大丈夫です。
コマンドを使わなくても、今日できることが3つあります。
① 外注先に、3つだけ聞く
「APIキーは、どのファイルに、平文で置いていますか」
「実行の瞬間だけ渡す形(この記事の `op run`)に移せますか」
「AIエージェントに、そのフォルダを触らせていますか」
② 平文で書いたキーを、人用の保管庫へ移す
メモ帳・Excel・メールの下書きなどに書いたAPIキーやライセンスキーを、パスワード管理ソフトの「人用の保管庫」に移します。自動化用と人用で保管庫を分ける考え方は、1-4 と同じです。
③ キーをチャットに貼らない
チャット画面のAI(Claude や ChatGPT など)に、キーの値や設定ファイルをそのまま貼ったり、添付したりしません。エラーを相談するときも、貼るのはエラーの文面だけにします(1-12 の💡と同じ考え方です)。
第2部(AIと同じPCで使うときの守り)は、Claude Code を使っていない方なら、2-1 の考え方だけ読めば十分です。Claude Code は、PCの中でファイルを読み書きし、コマンドまで打てるAIの道具です。
※ 店名と語り手(店長あい)は架空です。検証と失敗は、私が実際の環境(Windows 11)で2026年10月24日に行いました。
※ この記事で名前を出す製品は、選択肢の一例です。各社から報酬や商品提供は受けておらず、アフィリエイトリンクも使っていません。
※ 料金・版・機能は変わります。設定前に公式の案内を確認してください。
はじめに|キーを「置く」から「渡す」へ
APIキーは、ファイルに置きっぱなしにせず、使う瞬間だけ渡す形にできます。
こんにちは。白い陶器のマグカップや木のカトラリーを扱うネットショップ「ミント雑貨店」の店長、あいです。
私の店では、毎晩・毎朝動くPythonのスクリプトがいくつもあります。
受注の確認
売上レポートの取得
チャットツールの新着の取り込み
楽天の管理画面をAPIで動かす自動化の例は、別の記事にまとめています。
https://note.com/ai_love_009/n/n7c2b646ef30c
どれも、APIキーやトークン(サービスに入るための合鍵の文字列)がないと動きません。
その合鍵を、私は長いあいだ `.env` や `.ini` という設定ファイルに、そのまま書いていました。今思えば、合鍵を机の上に出したままにしていたようなものです。
前に『【2026】楽天・Amazon出店者のセキュリティ対策|紙1枚から始める77項目』という記事を書きました。そこでは、APIキーやトークンも、パスワード管理ソフトを正本(大元になるただ1つの保管場所)にしましょう、と書いています。今回はその続きです。なかでも「自動化のスクリプトが使う合鍵」を、Windows で実際に移すための具体編になります
https://note.com/ai_love_009/n/n52bd3fc7e4cb
この記事の結論は1つです。Windowsなら、1Password CLI の `op run` と読み取り専用のサービスアカウントを使います。合鍵を「実行の瞬間だけ渡す」形に移せます。 そしてAIエージェントと同じPCで使うなら、AIがコマンドを実行する直前に止める守りを、もう一枚重ねておきたいところです。
`op run` の解説は、私が探した範囲では、英語で、Mac や Linux を前提にしたものが多い印象でした。この記事は、Windows の実機で、タスクスケジューラの無人の定時実行まで通した記録です。EC運営の目線で、つまずき・読み取り回数の実測・AIと同じPCで使うときの守りまでをまとめました。
AI活用の面でも、うれしいことがあります。Claude Code に「このフォルダのスクリプトを直して」と頼むときの話です。平文の値を書いていた古い設定ファイル(旧ファイル)を消した後は、値ごと読まれる心配が1つ減ります。設定ファイルから平文の値が減るからです。
AIに自動化のスクリプトを書いてもらうときも、値をチャットやコードに貼らずに済みます。AIに任せる範囲を広げる前の、下ごしらえです。
1Password CLI とは
1Password CLI(コマンドは `op`)とは、1Password の公式のコマンド用ツールです。保管庫の秘密の値を、スクリプトの実行時に取り出せます。
1Password は、パスワードなどをまとめて守る管理ソフトです。CLI(コマンドで操作する道具)版なら、人が画面を開かなくてもプログラムが値を受け取れます。
この記事で使うのは、そのなかの `op run` という命令です。スクリプトを起動する瞬間だけ、値を環境変数(そのプログラムだけに渡すメモ)として渡します。スクリプトが終われば、メモは消えます。
第1部|1Password CLI を Windows に入れて、平文のAPIキーを減らす
人がやる作業は「保管庫に値を入れる」「合鍵を暗号化して保存する」の2つだけ。あとは自動化のスクリプトが、合鍵1本で引き出し1つだけを読みます。

用語を先にそろえます。
保管庫:1Password の中の引き出し。今回は自動化専用を1つ作ります
サービスアカウント:人ではなく、プログラム専用の合鍵。読める引き出しと、できる操作を絞れます
トークン:その合鍵の文字列。`ops_` で始まります
DPAPI:Windows が「そのPCの、そのユーザー」でしか開けないように暗号化する仕組み
1-1 なぜ平文ファイルが危ないか
平文のファイルは、PCの中で「誰が読んでもそのまま使える」状態です。消し忘れ、バックアップへの複製、AIへの読み込みで、意図しない場所へ広がります。

秘密情報の漏れは増えています。GitGuardian の年次調査(2026年3月公開)によると、2025年に公開のGitHubへ追加された新しい秘密情報は28,649,024件。前年より34%増えました。
なかでもAIサービス関連の秘密情報は1,275,105件で、81%増です。
もちろん、これは公開されたGitHubの話で、私たちのPCの中の `.env` とは場所が違います。それでも、平文で置いた値がいつのまにか外へ出ていく流れは同じです。
平文ファイルには、こんな弱さがあります。
同じPCで動くプログラムなら、どれでも中身を読める
バックアップやNAS(事務所の共有ディスク)へ、そのまま複製される
AIに「このフォルダを見て」と頼むと、値ごと読まれることがある
「どのファイルに、どのキーがあるか」を誰も覚えていない
`op run` に移すと、設定ファイルに書くのは `op://automation/…` という「場所の書き方」(参照)だけになります。値はファイルに保存しません。値そのものは 1Password の中にあり、PCに残るのは、参照と、暗号化した合鍵のファイル1つです。
こうすれば、平文で置いておくより、漏れる経路を減らせます。ただし、穴が1つ残ります。同じ Windows ユーザーで動くAIなら、合鍵に手が届きうるのです(第2部)。
この方法で守れるもの・守れないもの
先に、できることと、できないことを分けておきます。
◆ 守れるもの
設定ファイルを持ち出されたとき(値が書かれていない)
別の Windows ユーザー・別のPCからの読み取り(合鍵のファイルは DPAPI で暗号化)
バックアップ・NAS・クラウド同期への、平文の値の混入
コードやスクリプトへの、値の書き込み(参照だけを書く)
◆ 守れないもの
同じ Windows ユーザーで動く、任意のプログラム。合鍵を開ければ、その保管庫の中身をまるごと読めます
管理者の権限を持つ人やプログラム
値を受け取ったスクリプトが、その値をどう扱うか(ログに書く、など)
つまり合鍵1本で、引き出し1つ分の値すべてに届きます。だから保管庫は自動化専用に分け、合鍵は読み取りだけにします(1-4・1-5)。
「Export-Clixml で値そのものを暗号化すれば、足りるのでは?」
1-6 で使う `Export-Clixml`(DPAPI で暗号化して保存する命令)で、APIキーそのものを暗号化して置く手もあります。PCが1台で、キーが1〜2本、外注先もいないなら、それで足りる場面もあります。
それでも私が 1Password を挟んだ理由は4つです。
値の置き場所が1か所になる:どのPCのどのファイルにあるか、探さなくて済みます
出し直しや取り消しを 1Password 側でできる:キーを替えても、PCで作り直すファイルは合鍵の1つだけです
人用の保管庫と同じ道具で管理できる:ふだんのパスワードと同じ画面で、置き場所を確かめられます
使われ方を確かめられる:読み取りの回数を、コマンドで見られます(1-8)
個人情報・モールの決まりとの関係
個人情報との関係も一言だけ。 合鍵そのものは個人データではありません。けれど、受注や顧客の情報を扱うスクリプトの合鍵が漏れれば、個人データの漏えいにつながりえます。
個人情報保護法は、安全管理措置(法第23条)を定めています。個人情報保護委員会のガイドライン(通則編)には、その「技術的安全管理措置」として、アクセスの制御や、外部からの不正アクセスの防止などが挙げられています。
平文のファイルにキーを置かない今回の手順は、この考え方と同じ向きの工夫のひとつです。ただし、実施すれば法令に適合する、という意味ではありません。
ガイドラインは見直しが予定されています(2026年10月24日時点)。同委員会は2026年10月7日にも、大規模な漏えい等の事案を踏まえた注意喚起を出しています。ご自身の状況は、専門家や同委員会の案内で確認してください。あわせて、お使いのモールの規約や開発者向けの案内も、ご自身で確かめておきましょう。
1-2 1Password for Agents との違い(Windowsで今できること)
Windows の Claude Code に、パスワードを見せずにログインさせる。その公式の方法は、2026年10月24日に私が確認した範囲では示されていません。だから今は CLI で「実行の瞬間だけ渡す」を選びます。

2026年10月22日、1Password は「1Password for Agents」を発表しました。AIエージェントがログインを求めると、人が自分の端末で承認し、1Password が入力欄を埋めます。AIはパスワードそのものを受け取りません。
公式ブログによると、Individual と Families のプランで追加料金なしで使えます。ただし、対応OSや機能は連携ごとに異なる、と書かれています。
Claude 向けの連携は「Claude Duet」で、公式の表記は「近日対応」。Claude Duet は、2026年10月24日に私が確認した範囲の公式の案内では、Claude Code とは別の製品として書かれています。
すでにある「1Password for Claude」の公式の要件は、次のとおりです。
Mac と、1Password for Mac(8.12.28以降)
Claude デスクトップアプリと Claude in Chrome
有料の Claude プラン
要件のどこにも、Windows と Claude Code は出てきません。Windows で Claude Code を使っている身としては、少し肩すかしでした。だから私は、ブラウザのログインをAIに任せる話(1Password for Agents)は保留にしました。かわりに選んだのが、Windowsで今動く CLI で、スクリプトの合鍵から片づける道です。
1-3 契約とプラン(Individual で足りるか)
私は個人向けの Individual でサービスアカウントを作れました。ただし1日の読み取りは、アカウント全体で1,000回までです。

料金は、2026年10月24日時点の公式表示(米ドル・年払いの月額換算)です。
Individual(1人):通常 $3.99。新規で 1password.com から直接契約すると、最初の12か月は $2.99
Families(5人まで):通常 $5.99。同じ条件で最初の12か月は $4.49
Business:1ユーザー $8.99
14日の無料体験があります。年払いなので、請求は1年分がまとめて来ます。円換算は為替で動くので、契約画面で確かめてください。
私が確認した範囲では、公式の説明に、サービスアカウントをどのプランで作れるかは書かれていませんでした。試してみると、私の環境では Individual で作れました。
プランの種類より気にしたいのは、読み取りの上限のほうです。公式の上限は、2種類あります。
1時間あたりの上限は、トークン(合鍵)ごとに数えます。
個人・Families・Teams:読み取り1,000回、書き込み100回
Business:読み取り10,000回、書き込み1,000回
1日あたりの上限は、アカウント全体で数えます。 サービスアカウントを何本作っても、全部の回数を合わせて1つの上限で数えます(本数を増やしても上限は増えません)。読み取りと書き込みも合算します。
個人・Families:1,000回
Teams:5,000回
Business:50,000回
超えると、エラーになって読めなくなります。この上限が、1-10 で「何を移さないか」を決める根拠です。
1-4 保管庫を作る(名前は英字)
自動化専用の保管庫を1つ作り、名前は英字にします。日本語の名前は、参照(値の場所を示す `op://` の書き方)に使えませんでした。

1password.com か、Windows の 1Password アプリで、新しい保管庫を作ります。私は `automation` という名前にしました。
ここに入れるのは、自動化スクリプトが使う値だけです。人がふだん使うパスワードは、別の保管庫に置いたままにします。合鍵で開けられる範囲を、この引き出し1つに絞るためです。
公式の説明では、サービスアカウントには、個人用の保管庫と、最初からある共有の保管庫は付けられません。そのため、自動化用の保管庫は新しく作る必要があります。
名前を英字にする理由は、私の失敗です。 最初は日本語の名前で作りました。すると、`op://` で始まる参照を CLI に読ませたところで、こう返されました。
invalid character in secret referencesecret reference は「参照」の英語名です。公式の説明では、参照の名前に使える文字は、英数字と `-`・`_`・`.`(と空白)です。それ以外の文字を含む名前は、名前ではなくID(1Password が振る識別番号)で書く決まりになっています。日本語は許可された文字に入らないので、英字に直すのが早道でした。
参照の書き方は、`op://<保管庫>/<項目>/<欄>` です。項目の中にセクション(欄のまとまり)がある場合は、項目と欄のあいだにセクション名が入ります。
1Password アプリの欄のメニューに「シークレット参照をコピー」が出る場合は、それを使うと打ち間違いがありません。使えない場合は、上の規則どおりに手で書きます。画面の欄の名前(日本語の表示)と、参照に書く名前が違うことがあるので、1-8 の試験で確かめてください。
次に、ダミーの項目を1つ作ります。 疎通試験(1-8)用です。
保管庫:`automation`
項目の名前:`CLI-Test`
項目の種類:パスワード欄のある種類(「パスワード」など)
パスワード欄の値:`demo-only-not-a-real-key`
本物の値ではないので、試験で何が起きても困りません。
1-5 サービスアカウントを作る(読み取りだけ)
サービスアカウントは「automation 保管庫を読むだけ」で作ります。作った後は権限を変えられません。

⚠️ 作成ボタンを押す前に、1-6 を最後まで読んでください。 トークンは一度しか表示されません。先に PowerShell を開いて 1-6 のコマンドを実行し、「Enter待ち」の状態にしておきます。作成に進むのは、それからです。
1password.com にブラウザでサインインし、左のメニューの「開発者」→ 上の「ディレクトリ」タブ →「アクセストークン」の「サービスアカウント」から作ります。私の画面では、次の順に進みました。
1. 名前を付ける(例:`ec-automation-reader`)
2. 保管庫アクセス:`automation` だけを選び、権限は「読み取る」だけにする
3. 環境アクセス:付けない
4. PowerShell が 1-6 の「Enter待ち」になっているのを見てから、作成する
5. トークンが表示されたら、画面を閉じずにコピーし、PowerShell に戻って Enter を押す(1-6 の手順3〜5)
要点は3つです。
読み取りだけにする:書き込み権限を付けると、漏れたときに値を書き換えられる恐れが増えます
作り直す前提で考える:公式の説明では、権限・保管庫・環境のアクセスは作成後に変えられません。変えるなら作り直しです
トークンは一度しか表示されない:画面を閉じる前に保存します
作成の画面には、トークンを保管庫へ保存する選択肢がありました。私の環境では、`automation` に「Service Account Auth …」という項目ができました。保存を選んだ場合は、その項目からトークンをコピーして 1-6 を進めることもできます。
私はこの項目を、ローテーション(合鍵の出し直し・2-4)の後に消しました。自動化が読める引き出しに、合鍵そのものを置いておく理由はないからです。保存するなら、人用の保管庫に置くほうが筋がいいと思います。
1-6 トークンを暗号化して保存する(クリップボード方式)
トークンは、PowerShell の `Export-Clixml`(値をファイルに書き出す命令)で暗号化して保存します。順番は「先にコマンドを実行→Enter待ち→その間にトークンをコピー→Enter」です。
💻 外注先に頼む場合も、この節の操作だけは、ご自身の手で行います。コマンドの貼り付けや Enter を押すタイミングは、外注先に指示してもらってかまいません。

`Export-Clixml` は、Windows の DPAPI で暗号化して保存します。Microsoft の公式説明では、復号できるのは「そのPCの、そのユーザーだけ」です。別のPC・別のユーザーでは開けない仕組みです。
この作業は、定時実行でスクリプトを動かすのと同じ Windows ユーザーで行います。 別のユーザーで保存すると、タスクから復号できません。タスクの実行ユーザーは、タスクスケジューラでタスクを開けば確かめられます。「全般」タブの「タスクの実行時に使うユーザーアカウント」の欄です。
鍵付きの箱にたとえると、DPAPIの鍵は「Windows のユーザーごと」に1本ずつあります。箱を閉めた人の鍵でしか、箱は開きません。
作業の前に:クリップボードの履歴を確かめる
Windows には、コピーしたものを貯めておく「クリップボードの履歴」(Win+V で開く)があります。「デバイス間で共有(同期)」がオンだと、ほかの端末へ送られることも。
設定→システム→クリップボード で、「クリップボードの履歴」と「デバイス間で共有」の2つがオンになっているかを先に見ておきます。
「デバイス間で共有」がオンなら、作業の前にオフにします。 後から履歴を消しても、ほかの端末へ送られた分は戻せないためです。
「クリップボードの履歴」は、オンのままでもかまいません。その場合は、保存の後に履歴を消します(下の手順6)。
コマンド
コマンドは、次の1行です。トークンはコマンドの中に書きません。
Read-Host "1Passwordでトークンをコピーしてから Enter" | Out-Null; $dir = Join-Path $env:LOCALAPPDATA "EcAutomation"; New-Item -ItemType Directory -Force $dir | Out-Null; $t = ConvertTo-SecureString ((Get-Clipboard -Raw).Trim()) -AsPlainText -Force; [System.Management.Automation.PSCredential]::new("op-sa", $t) | Export-Clixml (Join-Path $dir "op-service-account.xml"); Remove-Variable t; Set-Clipboard -Value " "; $c = Import-Clixml (Join-Path $dir "op-service-account.xml"); $p = $c.GetNetworkCredential().Password; "先頭3文字: " + $p.Substring(0,3) + "… / 全" + $p.Length + "文字 / 先頭がops_: " + $p.StartsWith("ops_"); Remove-Variable c, p動きは「Enterを待つ→クリップボードを読んで暗号化保存→クリップボードを上書き→読み直して確かめる」の順です。保存先は `%LOCALAPPDATA%\EcAutomation` です。
コマンドの中身
長い1行ですが、部品に分けるとこうなります。
`Read-Host …`:Enter が押されるまで待つ
`Get-Clipboard -Raw`:クリップボードの中身を読む
`ConvertTo-SecureString` から `Export-Clixml` まで:暗号化してファイルに書く
`Set-Clipboard -Value " "`:クリップボードを空白で上書きする
`Import-Clixml` 以降:読み直して、先頭3文字と文字数だけを表示する
クリップボードを最後に上書きするのは、トークンをすぐ貼り付けられる状態で残さないためです。ただし、上書きは完全な消去ではありません。履歴や同期には残りえます。
PowerShell の開き方です。 スタートボタンを右クリックし、「ターミナル」を選びます(Windows 10 では「Windows PowerShell」)。
管理者として開く必要はなく、ふだん使うユーザーのままで大丈夫です。貼り付けは Ctrl+V か、画面の上での右クリックです。
手順
1. PowerShell を開き、上のコマンドを貼って Enter を押す
2. 「コピーしてから Enter」と出て止まる(ここで 1-5 の作成に進む)
3. 1Password の画面で、トークンをコピーする
4. PowerShell に戻って Enter を押す
5. 表示が「先頭3文字: ops… / 全○○文字 / 先頭がops_: True」なら成功
6. Win+V で履歴を開き、`ops_` で始まる項目があれば、項目の「…」から削除する。「デバイス間で共有」がオフのままになっていることも、設定→システム→クリップボード で確かめる
先頭3文字が `ops` 以外だったり、最後が `False` だったりしたら、保存し直します。クリップボードが空のまま Enter を押すと、赤い文字のエラーが出ます。そのときはトークンのコピー忘れなので、慌てずに最初からやり直しましょう。原因の見当は 1-12 の②③にまとめました。
この順番には、2つの失敗が詰まっています。
1つ目。最初は `Read-Host` で、トークンを直接貼り付けていました。すると後の試験で、こう返されました。
failed to parseToken, format is invalid貼った文字列が途中で切れていたようです。原因の細かいところまでは確かめていません。クリップボードから直接読む形に変えたら、解消しました。
2つ目。クリップボードは「1枚しか入らない付箋」です。後からコピーしたものが、前のものを上書きします。
私は、トークンをコピーしてから、保存コマンドをコピーしていました。すると、表示された先頭3文字が `ops` ではなく `$di` でした。一瞬「何これ?」となりましたが、正体はコマンドの頭の `$dir` です。
コマンドをコピーした瞬間に、トークンが上書きされていたのです。だから「先にコマンドを動かして待たせ、その間にトークンをコピーする」順にしました。
1-7 1Password CLI を入れる(winget)
CLI は winget(Windows に入っているアプリの導入コマンド)で入れ、署名を確かめます。デスクトップアプリとの連携は、オフのままにします。
公式の書き方は次のとおりです。
winget install 1password-cli私は、パッケージのIDを指定して入れました。公式の書き方と私の書き方を `winget show` で見比べると、どちらも同じパッケージでした。
winget install --id AgileBits.1Password.CLI --exact初めて winget を使うときは、ソースの利用規約への同意を [Y/N] で聞かれることがあります。内容を読んでから答えます。
入れる前に、3つを調べました。版は、2026年10月時点の最新版 v2.41.1。入手元は winget の公式リポジトリで、発行元は 1Password の運営会社。インストール後に動く仕組みはなく、zipを展開する形でした。
入れたら、PowerShell を開き直して版を見ます。
op --version署名も見ておきます。次のコマンドで `Status` が `Valid` なら、署名が有効です。改ざんされていないことの目安にはなりますが、安全の保証ではありません。
$pkg = Get-ChildItem (Join-Path $env:LOCALAPPDATA "Microsoft\WinGet\Packages") -Directory -Filter "AgileBits.1Password.CLI*" | Select-Object -First 1
Get-AuthenticodeSignature (Join-Path $pkg.FullName "op.exe") | Format-List Status, SignerCertificateデスクトップアプリの「CLIと連携」は、オンにしません。 連携は、人がその場で Windows Hello(指紋・顔・PINでの本人確認)で承認する仕組みです。公式の説明では、10分操作しないと切れ、最長でも12時間で承認し直しになります。無人の定時実行には向きません。
それに、連携をオンにすると、人用の保管庫までCLIから届く道が1本増えます。この記事の自動化は、サービスアカウントの合鍵だけで動かします。
1-8 ダミーの値で疎通試験
本物の値を入れる前に、ダミーの値が `op run` で渡るかを試します。値は画面に出さず、「読めた」かだけを確かめます。
💻 外注先に頼んだ場合は、`OK:` で始まる行(試験に通った印)が出た画面を見せてもらいます(値は画面に出ません)。
使うファイルは2つです。どちらも、作業フォルダ(例:`C:\ec-tools`)の中の `1password` フォルダ(`C:\ec-tools\1password\`)に置きます。フォルダがなければ、先に作ります。
ファイルの作り方
メモ帳で中身を貼り、「名前を付けて保存」を選びます。ファイルの種類は「すべてのファイル」にします。そうしないと `test_op_run.ps1.txt` のように、最後に `.txt` が付いてしまうので要注意です。
日本語のコメントを含む `.ps1` は、文字コードを「UTF-8(BOM付き)」で保存します。Windows に最初から入っている PowerShell 5.1 は、BOMのない UTF-8 の日本語を正しく読めないことがあるためです。
1つ目:参照だけを書いたファイル
`test.oprefs` です。値は書きません。
OP_TEST_VALUE=op://automation/CLI-Test/password2つ目:試験スクリプト
`test_op_run.ps1` です。私が使ったものを、名前だけ置き換えて全文載せます。
# 試験:サービスアカウント+op run でダミーの項目を読む(値は表示しない)
# 自分の PowerShell で実行する。出力にトークンや値は出ない
$ErrorActionPreference = "Stop"
$here = Split-Path -Parent $MyInvocation.MyCommand.Path
$tokenFile = Join-Path $env:LOCALAPPDATA "EcAutomation\op-service-account.xml"
$refs = Join-Path $here "test.oprefs"
$python = "C:\ec-tools\venv\Scripts\python.exe" # 自分の Python の場所に書き換える
$pkg = Get-ChildItem (Join-Path $env:LOCALAPPDATA "Microsoft\WinGet\Packages") -Directory -Filter "AgileBits.1Password.CLI*" | Select-Object -First 1
if (-not $pkg) { Write-Output "NG: op.exe not found"; exit 2 }
$op = Join-Path $pkg.FullName "op.exe"
# Connect の設定はサービスアカウントより優先されるため、混ざっていたら止める
if ($env:OP_CONNECT_HOST -or $env:OP_CONNECT_TOKEN) { Write-Output "NG: OP_CONNECT_* is set"; exit 2 }
if (-not (Test-Path $tokenFile)) { Write-Output "NG: token file not found"; exit 2 }
$exitCode = 1
try {
$env:OP_SERVICE_ACCOUNT_TOKEN = (Import-Clixml $tokenFile).GetNetworkCredential().Password
# 子プロセスで「値がある・参照が解決された・ダミーと一致」を確かめ、OK/NG だけを返す
$check = "import os,sys; v=os.environ.get('OP_TEST_VALUE',''); " +
"sys.exit(0 if v=='demo-only-not-a-real-key' else (3 if v.startswith('op://') else 4 if not v else 5))"
& $op run --env-file="$refs" -- $python -c $check
$exitCode = $LASTEXITCODE
switch ($exitCode) {
0 { Write-Output "OK: dummy value was read through op run (value not printed)" }
3 { Write-Output "NG: reference was not resolved" }
4 { Write-Output "NG: value is empty" }
5 { Write-Output "NG: value differs from the dummy (check the CLI-Test password field)" }
default { Write-Output "NG: op run failed (exit $exitCode)" }
}
# このサービスアカウントの読み取り回数(秘密の値は含まない)
Write-Output "--- rate limit usage ---"
& $op service-account ratelimit
}
finally {
Remove-Item Env:OP_SERVICE_ACCOUNT_TOKEN -ErrorAction SilentlyContinue
}
exit $exitCodePython の場所の調べ方
`$python` の行は、ご自分の環境に合わせて書き換えます。いま定時実行で使っている bat があれば、その中の `python.exe` の場所(`%PY%` などの変数に入っていることが多い)をそのまま使います。
bat に書かれていない場合の調べ方は、PowerShell で次のどちらかです。
where.exe python
(Get-Command python).Source`...\WindowsApps\python.exe` と出たら、それは Microsoft Store の入口で、本物の Python ではありません。venv(Python の作業用の環境)を使っているなら、`<venv のフォルダ>\Scripts\python.exe` が場所です。
実行は、自分で開いた PowerShell で行います。 AIに実行させません(理由は第2部)。
powershell -NoProfile -ExecutionPolicy Bypass -File C:\ec-tools\1password\test_op_run.ps1`-NoProfile` は、個人の設定を読み込まずに起動する指定です。`-ExecutionPolicy Bypass` は、この1回の起動にだけ効き、スクリプトの実行制限を外す指定です。PC全体の設定は変えません。
結果の読み方です。
`OK: dummy value was read through op run` → 成功。値は画面に出ていません
`NG: reference was not resolved` → 参照の書き方の誤り。保管庫名・項目名・欄名を見直します
`NG: value differs from the dummy` → 項目の値が違います。`CLI-Test` のパスワード欄を確かめます
`NG: op run failed` → トークンの不備が多いです。1-6 からやり直します
`NG: op.exe not found` → CLI が見つかりません。1-7 の導入を見直します
`NG: token file not found` → 合鍵のファイルがありません。1-6 の保存先と、保存したユーザーを確かめます
最後に、読み取り回数の表が出ます。`op service-account ratelimit` は公式の確認コマンドです。トークンの行が1時間あたり、アカウントの行が1日あたりの使用量です。
私の結果です(2026年10月24日・v2.41.1)。
1回目は、日本語の保管庫名で失敗しました(1-4)
英字に直したら OK が出ました
参照1つの `op run` で、成功1回につき読み取りが約2回数えられました
名前を解決できずに失敗した実行でも、読み取りが数えられました(最大4回)
市販のセキュリティソフトを入れた環境でしたが、`op run` から Python を起動する流れは止められませんでした
この回数について、公式の説明には `op run` の場合の明記がありません。版や書き方で変わりうるので、ご自分の環境で `op service-account ratelimit` を見てください。名前を解決できない失敗でも数えられたので、私は本番の参照をIDで書くことにしました。
なお、セキュリティソフトの有無と、認証情報を平文で置かない対策は別の話で、どちらも必要です。
ここまでが「最初の1歩」です。おつかれさまでした。契約が済んでいれば、1-4 の保管庫づくりからここまで、私の環境で30〜60分ほどの作業です。
1-9 1本目を移す(6手順)
1本目は「止まっても翌日で済む」スクリプトにします。bat(Windows の一括実行ファイル)の1行だけを替え、丸1日動いてから旧ファイルを消します。

私が1本目に選んだのは、毎晩チャットツールから新着を取り込む情報収集スクリプトです。1日1回しか動かず、止まっても翌日やり直せば済みます。
手順1:値を保管庫に登録する(人の作業)
旧ファイルにあるトークンを、`automation` 保管庫に項目として登録します。私は項目の種類を「API認証情報」にしました。名前は `chat-reader`、値の欄は `credential` です。
手順2:スクリプトの読み込み口を直す
「環境変数があればそれを使い、なければ旧ファイル」にします。移行中は、どちらでも動く形です。どちらから読んだかを1行だけ出しておくと、あとで確かめやすくなります。
import os
import sys
def load_token():
v = os.environ.get("CHAT_READER_TOKEN")
if v:
print("token: 環境変数(1Password)から読み込み", file=sys.stderr)
return v
# 移行が終わるまでだけ残す、旧い読み方
print("token: 旧ファイルから読み込み", file=sys.stderr)
return read_old_config_file()`read_old_config_file()` は、今まで使っていた読み方をそのまま入れる場所です。
手順3:参照ファイルを作る
値ではなく、場所だけを書いたファイルです。私は `collector.oprefs` という名前にしました。
CHAT_READER_TOKEN=op://automation/chat-reader/credential名前に `.env` を付けなかったのは、値が入ったファイルと見分けるためです。秘密のファイルにさわる操作を止める守りの仕組みは、`.env` という名前に反応することがあります。
手順4:中継ぎスクリプトを置いて、手で試す
複数のスクリプトで使い回せるように、中継ぎのスクリプトを1つ作りました。合鍵を復号して `op run` に渡し、指定したプログラムを起動します。これも名前だけ置き換えて全文載せます。保存のしかたは 1-8 と同じです(UTF-8・BOM付き)。
# op run で、1Password の値を環境変数として渡してコマンドを1つ実行する
# 無人の定時実行用。AI からは起動させない(第2部)
#
# powershell -NoProfile -ExecutionPolicy Bypass -File C:\ec-tools\1password\op_exec.ps1 -Refs <name>.oprefs <program> [args...]
#
# <name>.oprefs(このスクリプトの隣)には op:// の参照だけを書き、値は書かない
# 終了コード:実行したコマンドの終了コード。2 = 準備に失敗(トークン・op.exe・参照ファイルがない)
# 出力にトークンは出ない。op run は渡した値が標準出力に出ても伏せ字にする
param(
[Parameter(Mandatory = $true)][string]$Refs,
[Parameter(ValueFromRemainingArguments = $true)][string[]]$Cmd
)
$ErrorActionPreference = "Stop"
$here = Split-Path -Parent $MyInvocation.MyCommand.Path
$tokenFile = Join-Path $env:LOCALAPPDATA "EcAutomation\op-service-account.xml"
$refsPath = if ([IO.Path]::IsPathRooted($Refs)) { $Refs } else { Join-Path $here $Refs }
$pkg = Get-ChildItem (Join-Path $env:LOCALAPPDATA "Microsoft\WinGet\Packages") -Directory -Filter "AgileBits.1Password.CLI*" -ErrorAction SilentlyContinue | Select-Object -First 1
if (-not $pkg) { Write-Output "[op_exec] NG: op.exe not found"; exit 2 }
$op = Join-Path $pkg.FullName "op.exe"
if (-not (Test-Path $tokenFile)) { Write-Output "[op_exec] NG: token file not found"; exit 2 }
if (-not (Test-Path $refsPath)) { Write-Output "[op_exec] NG: refs file not found: $Refs"; exit 2 }
if (-not $Cmd -or $Cmd.Count -lt 1) { Write-Output "[op_exec] NG: no command given"; exit 2 }
# Connect の設定はサービスアカウントより優先されるため、混ざっていたら止める
if ($env:OP_CONNECT_HOST -or $env:OP_CONNECT_TOKEN) { Write-Output "[op_exec] NG: OP_CONNECT_* is set"; exit 2 }
$exitCode = 1
try {
$env:OP_SERVICE_ACCOUNT_TOKEN = (Import-Clixml $tokenFile).GetNetworkCredential().Password
$prog = $Cmd[0]
$rest = @()
if ($Cmd.Count -gt 1) { $rest = $Cmd[1..($Cmd.Count - 1)] }
& $op run --env-file="$refsPath" -- $prog @rest
$exitCode = $LASTEXITCODE
}
catch {
Write-Output "[op_exec] NG: $($_.Exception.Message)"
$exitCode = 2
}
finally {
Remove-Item Env:OP_SERVICE_ACCOUNT_TOKEN -ErrorAction SilentlyContinue
}
exit $exitCodeop.exe は、PATH(コマンドを探す場所の一覧)に頼らず、winget の入れ場所から探す形にしました。タスクスケジューラ(Windows の定時実行の機能)から動かすときに、迷わないようにするためです。
`op run` の伏せ字が効くのは、渡した値と同じ文字列だけです。値の一部や、形を変えた値は伏せられません。スクリプトが値をログに書かないことは、別に確かめます。
手で動かして確かめる
自分の PowerShell で、中継ぎスクリプト経由で `collector.py` を動かします。引数は、軽い動作確認用のものにします。形は次のとおりです。
powershell -NoProfile -ExecutionPolicy Bypass -File C:\ec-tools\1password\op_exec.ps1 -Refs collector.oprefs C:\ec-tools\venv\Scripts\python.exe <collector.py の場所> <確認用の引数>確認用の引数が `-` で始まる形(`--dry-run` など)だと、PowerShell が自分の指定と取り違えて、うまく渡らないことがあります。試すときは `fetch` のような、`-` のない引数にします。
標準エラー(エラー用の出力先)に「環境変数(1Password)から読み込み」と出れば、新しい道を通っている証拠。私の環境では、ここまで成功しました。
手順5:bat の1行だけを替える
タスクスケジューラが起動する bat の、スクリプトを呼ぶ行だけを差し替えます。`%PY%`・`%BASE%`・`%LOG%` は、今の bat に書いてある変数(Python の場所・作業フォルダ・ログの場所)です。`%BASE%` は作業フォルダ(例:`C:\ec-tools`)を指し、`1password` フォルダはその中にある前提です。
変更前:
"%PY%" "%BASE%\collector.py" fetch >> "%LOG%" 2>&1変更後:
powershell -NoProfile -ExecutionPolicy Bypass -File "%BASE%\1password\op_exec.ps1" -Refs collector.oprefs "%PY%" "%BASE%\collector.py" fetch >> "%LOG%" 2>&1ほかの行は触りません。戻すときは、この1行を元に戻すだけです。Claude Code と同じPCなら、この bat のファイル名(例:`run_collector.bat`)を 2-2 のフックの規則3の一覧にも書き足します。AIがこの bat を起動しようとしたときに、止めるためです。
`-ExecutionPolicy Bypass` は、この行で起動する PowerShell の1回にだけ効きます。PC全体の設定は変えません。付けるのは自分で書いた中継ぎスクリプトにだけで、出所のわからないスクリプトには付けません。
合鍵が必要なのは、この行で動くスクリプトだけです。同じ bat の中でほかの処理(たとえばAIで要約する処理)を動かしていても、そちらには合鍵を渡しません。
ただし、`op_exec.ps1` は `op run` を動かす前に、合鍵を環境変数に入れています。そのため、`op run` が起動するスクリプト(とそこから起動されるプログラム)にも、合鍵が引き継がれうると考えておきます。私はこの点を確かめていません。
起動したスクリプトから、さらに別のプログラムを動かす作りなら注意が要ります。根本の対策は、2-5 の専用ユーザーです。
定時実行で起きうる注意
タスクの「ユーザーがログオンしているかどうかにかかわらず実行する」+「パスワードを保存しない」:この組み合わせでは、DPAPI で保存したトークンを開けないことがあります。一般に言われる話で、私は試していません。私は「ユーザーがログオンしているときのみ実行する」で動かしています
ログへの書き出し(`>> "%LOG%" 2>&1`):環境によっては、標準エラーの扱いで PowerShell が途中で止まることがあります。私の環境で見本を作って試したところ、止まりませんでした。とはいえ1回は、定時実行と同じ形(ログに書き出す形)で試します。タスクスケジューラでタスクを右クリックし、「実行する」で動かしてログを見るのが手早いです
手順6:丸1日動いてから、旧ファイルを消す
定時の実行が、新しい道で丸1日(1周)動いたのをログで見届けます。それから古い設定ファイルを消します。NASやバックアップに複製があれば、そちらも忘れずに。
旧ファイルを消すまでは、そのフォルダをAIに丸ごと読ませないようにします。旧ファイルには、まだ平文の値が入っているからです。
私の環境は、この記事を書いている時点(2026年10月24日時点)で手順5まで済んだところです。定時実行で1周動くのを確かめてから、旧ファイルを消します。
💡 AIに頼むなら:Claude Code に頼むのは、トークンに触れない作業だけにします。bat の1行の変更、スクリプトの読み込み口の書き換え、参照ファイル(値なし)の作成です。トークンの保存、値の登録、試験の実行は、自分の手でやります。
AIが書き換えた差分は、値をファイル・ログ・外部へ出す行がないかを自分の目で見てから保存します。AIに書き換えを頼むのは移行作業の間だけです。移し終えたら、AIがこのフォルダを編集できないようにします(2-2)。
1-10 何を移して、何を移さないか
止まると困る処理と、それと共有している鍵は移しません。止まっても翌日で済むものから、1本ずつ移します。

理由は、1日の読み取り上限です。個人プランは、アカウント全体で1日1,000回でした。
たとえば10分ごとに動く処理は、1日に144回起動します。私の環境のように1回で約2回数えられれば、288回です。参照が多ければ、その分だけ上乗せです。
こうした処理が3本あれば約864回で、上限の約86%です。4本なら約1,152回で、上限(1,000回)を超えます。失敗した実行も数えられるので、3本でも届くことがあります。
あなたの店では、10分ごとに動く処理が何本あるでしょうか。
上限に届くと、移したすべての処理が、しばらく値を読めなくなります。在庫の同期や受注の取り込みが止まれば、売り越しや発送遅れにつながります。
回数の見積もり方
1日の読み取りの見込みは、次の掛け算でおおよそ出せます。
1日の読み取り ≒ 1日の起動回数 × 参照の数 × 約2(私の環境の実測)
参照1つのとき、目安はこうなります。
10分ごと:144回起動 → 約288回
1時間ごと:24回起動 → 約48回
1日1回:1回起動 → 約2回
失敗した実行でも数えられるので(最大4回)、余裕を見て、上限の7割ほどまでに収めるのが無難です。
私の判断は、こうなりました。
◆ 移さない
在庫・受注・価格・広告の入札など、止まると困る処理の鍵
それらと同じ鍵を共有している、ほかのスクリプトの鍵
自動で新しくなり、そのたびに保管庫へ書き戻す必要がある鍵(読み取り専用の合鍵では書き戻せない)
◆ 移す(この順で)
1日1回だけ動く取り込み・集計・バックアップ
手で動かすことが多いスクリプト
回数が多い処理は最後。1日の回数を数えてから
◆ 1本ごとに挟むこと
移した先で丸1日動いたのを確かめてから、旧ファイルを消す
同じ鍵を使っているスクリプトの探し方
設定ファイルの名前で、スクリプトを検索します。値では検索しません(検索の履歴に値が残るため)。
Get-ChildItem C:\ec-tools -Recurse -Include *.py,*.bat | Where-Object { $_.FullName -notmatch '\\venv\\' } | Select-String -Pattern 'config.ini','.env' -SimpleMatch -List | Select-Object Path作業フォルダの下を、サブフォルダまで含めて探します。対象は Python のスクリプトと bat です。venv(Python の作業用の環境)の中は、ライブラリのファイルが多いので外しています。
`.env` で探すと、`os.environ` のような別の書き方にも当たるため、出てきた一覧は目で見て絞り込みます。
同じ設定ファイルを読んでいるスクリプトは、同じ鍵を共有している候補です。AIに頼むなら、ファイル名の一覧だけを作ってもらい、設定ファイルの中身は開かせません。
上限が大きいプラン(Teams は1日5,000回、Business は50,000回)なら、判断の線は変わります。変わらないのは「1本ずつ・丸1日待つ」のほうです。
1-11 1Password に頼るリスクと、向かない場面
移した処理は、1Password が読めない日には止まります。戻し方を先に決め、向かない場面では無理に移しません。
1Password に頼るリスク
移した処理は、値を毎回 1Password から受け取ります。次のような日には、値を読めずに止まります。
1Password 側の障害
ネットの回線が切れたとき
1日の読み取り上限に届いたとき(1-10)
契約が切れたときの動きは、私は確かめていません。止まると困る処理を移さない理由は、上限のほかにもう1つあります。1Password 側の障害や回線の切断でも、止まることがあるからです。
戻し方
旧ファイルを消す前:bat の1行を元に戻すだけです(1-9 手順5の逆)
旧ファイルを消した後:保管庫の値を、一時的に設定ファイルへ書き戻してから、bat の1行を戻します
旧ファイルを消す前に、戻し方を一度試しておきます。いざというときに迷わずに済みます。
やる価値が大きい店
AIエージェントに、スクリプトのフォルダを触らせている
外注先や家族など、複数の人がスクリプトを触る
NAS やクラウドへ、スクリプトのフォルダごとバックアップしている
鍵が何本もあって、どこに何があるかわからなくなっている
向かない場面3つ
1. 自動化が1〜2本だけで、PCも1人専用:1-1 の `Export-Clixml` で値を直接暗号化すれば足りる場面があります
2. 止まると、すぐ売上に響く処理しかない:在庫や受注の同期だけなら、移せるものがありません(1-10)
3. ネットが不安定な環境:値を読めない日が増え、移した処理が止まりやすくなります
1-12 つまずき早見表
つまずきの多くは、参照の書き方・トークンの保存・プランの上限・タスクの設定のどれかです。

① `invalid character in secret reference`
原因:保管庫名などに、許可されていない文字(日本語など)がある。
対処:名前を英字にするか、IDで参照する。
② `failed to parseToken, format is invalid`
原因:トークンが途中で切れて保存された。
対処:1-6 のクリップボード方式で保存し直す。
③ 保存後の先頭3文字が `ops` でない
原因:コピーの順番が逆で、クリップボードが上書きされた。
対処:先にコマンドを実行し、Enter待ちの間にトークンをコピーする。
④ `NG: reference was not resolved`
原因:参照の保管庫名・項目名・欄名が違う。
対処:1Password の画面の表記と照らし合わせる。使える場合は「シークレット参照をコピー」で取り直す。
⑤ 読み取りの上限に届いた
原因:移した処理の回数の合計が多い。
対処:`op service-account ratelimit` で数え、回数の多い処理を戻す。
⑥ `NG: OP_CONNECT_* is set`
原因:別の仕組み(Connect)の設定が残っている。公式の説明では、こちらがサービスアカウントより優先される。
対処:その環境変数を消してから動かす。
⑦ タスクからだけ失敗する(ユーザーが違う)
原因:タスクが、トークンを保存したのと別の Windows ユーザーで動いている。
対処:タスクの実行ユーザーを確かめる。DPAPIは、保存したユーザーでしか開けない。
⑧ 同じユーザーなのに、タスクからだけ失敗する
原因:タスクが「ログオンしているかどうかにかかわらず実行」+「パスワードを保存しない」設定で、DPAPI の鍵が使えないことがある(一般に言われる話で、私は未検証)。
対処:「ユーザーがログオンしているときのみ実行する」にする。
💡 AIに頼むなら:エラーの文面だけを貼って「原因の候補を3つ」と頼みます。トークン・参照ファイルの中身・ログの全文は貼りません。
第2部|AIエージェントと同じPCで使うときの守り
同じ Windows ユーザーで動くAIは、暗号化した合鍵にも届きえます。AIがコマンドを実行する直前に止める「フック」を重ねます。
💻 Claude Code を使わず、チャット画面だけでAIを使っている方は、2-1 の考え方を読めば足ります。やることは「キーをチャットに貼らない」の1つだけです。
⚠️ 最初に、私の失敗から。 私の試験の途中で、守りがまだ効いておらず、AIのシェル(AIがコマンドを打つ画面)で試験スクリプトが1回動きました。合鍵が1回、AIの側で復号されたことになります(値は画面に出ていません)。第2部は、その反省から書いています。
2-1 同じ Windows ユーザーなら、AIは合鍵に届きうる
DPAPIは「別のユーザーや別のPCから」の守りです。同じユーザーで動くAIからは守れません。
AIが外から読み込んだ文章にだまされて、思わぬコマンドを打つ手口(プロンプトインジェクション)は、前後編の記事で詳しく書きました。
https://note.com/ai_love_009/n/n6aa91e59ba1a
https://note.com/ai_love_009/n/n312f1629e1a9

1-6 で見たとおり、`Export-Clixml` の保存物を復号できるのは「そのPCの、そのユーザー」です。1-1 の「守れないもの」に書いた、同じユーザーで動くプログラムの話にあたります。
ここからは私の読み方です。Claude Code などのAIエージェントが、私と同じ Windows ユーザーで動いているとします。するとAIのシェルも、私と同じ「そのPCの、そのユーザー」です。つまり、AIが復号のコマンドを打てば、合鍵のファイルを開けてしまいます。
試験スクリプトや中継ぎスクリプトも同じです。AIが起動すれば、その中で合鍵が復号されます。私の失敗は、まさにこれでした。
そこで、2つの守りを重ねます。
AIがその種類のコマンドを打つ直前に止める(2-2・2-3)
いずれは、無人の定時実行を別の Windows ユーザーに分ける(2-5)
2-2 Claude Code のフックで止める3つ
止めるのは「合鍵の保存先と復号」「op で値を取り出す命令」「中継ぎスクリプトと、移した処理の bat の起動」の3つです。
Claude Code の権限の設定(settings.json の allow・ask・deny)とサンドボックスの基本は、こちらの記事で先にまとめています。
https://note.com/ai_love_009/n/nfb0c67b9633d
フックとは、AIがコマンドを実行する直前に割り込んで、通すか止めるかを決める仕組みです。Claude Code では「PreToolUse」(道具を使う直前に動く種類)のフックで作ります。
このフックが見張るのは、Claude Code だけです。ほかのAIエージェントを同じユーザーで動かすなら、それぞれの仕組みで止めるか、2-5 のユーザー分離が必要です。
公式の仕様では、フックは決まった形のJSON(データの書き方の一種)を返します。止めるときは `permissionDecision` に `deny`(拒否)を入れます。理由の文 `permissionDecisionReason` は、AIへそのまま伝わる仕組みです。
Windows ならではの注意も1つ。公式のガイドには、Bash(コマンドを打つ道具の1つ)だけを見張るのでは足りない、という趣旨の記述があります。PowerShell の実行も見張る対象に入れます。
最小の例です。 考え方を伝えるための例で、私が実際に使っている守りの全文ではありません。
設定ファイルに足す部分
設定ファイル(`settings.json`)の hooks の部分です。ユーザー全体に効かせるなら、置き場所は `~/.claude/settings.json` です。`~` は `C:\Users\<ユーザー名>` を指します。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash|PowerShell",
"hooks": [
{ "type": "command", "command": "bash ~/.claude/hooks/op_guard.sh" }
]
}
]
}
}すでに `settings.json` がある場合、ファイルを丸ごと置き換えるのはやめてください。先にファイルのコピーを取り、`"hooks"` の塊だけを足します。すでに `"hooks"` があるなら、その中に `PreToolUse` の1件を足すだけです。反映したら Claude Code を起動し直し、`/hooks` で登録されているかを確かめます。
フック本体(`op_guard.sh`)
Git Bash で動かす前提です。保存するときは、改行を LF(Linux 式)にします。メモ帳の既定の改行(CRLF)のままだと、bash がうまく読めず、フックが壊れます。VS Code なら、画面右下の「CRLF」を押して「LF」に替えられるので簡単です。
#!/usr/bin/env bash
# AI が打とうとしているコマンド文字列を受け取り、危ないものだけ deny を返す
# 読めなかったときも deny(壊れたら閉じる側に倒す)
deny() {
# 理由の文にバックスラッシュを入れない(JSON が壊れる。2-3 参照)
printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"%s"}}\n' "$1"
exit 0
}
input=$(cat)
# 0) コマンド文字列を取り出す。失敗・空なら止める(fail closed)
if ! cmd=$(printf '%s' "$input" | python -c "import sys,json; c=json.loads(sys.stdin.buffer.read())['tool_input']['command']; sys.stdout.buffer.write(c.encode('utf-8'))" 2>/dev/null) || [ -z "$cmd" ]; then
deny "hook could not read the command, so it was stopped"
fi
# 1) 合鍵の保存先・復号・合鍵の環境変数
if printf '%s' "$cmd" | grep -Eiq 'op-service-account|OP_SERVICE_ACCOUNT_TOKEN|OP_CONNECT_TOKEN|EcAutomation|import-clixml'; then
deny "1Password token is handled only by the owner or the scheduled task"
fi
# 2) op で値を取り出す命令と、伏せ字の解除(フルパスの op.exe も拾う)
if printf '%s' "$cmd" | grep -Eiq "(^|[[:space:];&|(\"'/\\])op(\.exe)?[\"']?[[:space:]]+(read|inject|item[[:space:]]+(get|list))|--no-masking|--reveal"; then
deny "op commands that reveal secret values are blocked"
fi
# 3) 合鍵を復号する中継ぎスクリプトと、移した処理の bat の起動
# 名前が出たら止める。作業フォルダのパスと .ps1/.bat が並んでも止める
# 移した処理の bat は、名前をここに足す(例:run_collector.bat。| で区切って増やす)
if printf '%s' "$cmd" | grep -Eiq '(op_exec|test_op_run)\.ps1|run_collector\.bat|ec-tools[\\/][^;&|]*\.(ps1|bat)'; then
deny "wrapper scripts and task bat files are run by the owner or the scheduled task"
fi
exit 03つの規則を、ふつうの言葉で言うと
規則1:合鍵の置き場所の名前(`EcAutomation` など)や、合鍵を開ける命令(`Import-Clixml`)が、コマンドに出てきたら止めます
規則2:1Password から値をそのまま取り出す命令(`op read` など)と、伏せ字を外す指定が出てきたら止めます
規則3:合鍵を開ける中継ぎスクリプトや、移した処理の bat(名前を一覧に足したもの)を起動しようとしたら止めます
記号だらけの部分は、この3つを機械が見分けるための書き方です。中身が全部わからなくても、そのまま使えます。
この例の作りの要点
読めなかったら止める:コマンドの文字列を取り出せなかったとき(Python が動かない・入力が壊れている・空)は、通さずに止めます。守りが壊れたときに、コマンドを素通しする「開く」のではなく、止める「閉じる」側に倒すためです。そのぶん、Python が動かない状態では、AIのコマンドが全部止まります
op.exe をフォルダの場所ごと指定しても拾う:`op` の直前が空白だけでなく、`\`・`/`・引用符でも当たるようにしました
ファイルの場所を書くだけで起動しても拾う:中継ぎスクリプトの名前が出たら、起動の書き方によらず止めます。作業フォルダ(例では `ec-tools`)のパスと `.ps1`・`.bat` が並んだときも、同じ扱いです
移した処理の bat は、名前を足して止める:AIによる bat の起動が止まるのは、bat の名前が規則3の一覧にあるとき(例の `run_collector.bat`)か、フォルダの場所ごと書かれたときです。一覧にない bat は、起動の書き方によっては素通りします。処理を1本移すたびに、その bat の名前をここへ足すのはそのためです。なお、AIがシェルでその bat の中身を表示するだけの操作も、止まる対象に入ります
止めないものも決めておきます。`op --version` は通します。タスクスケジューラのタスクを名前で起動する命令も、通す側です。タスクは別のプロセス(AIとは別に起動するプログラム)で動き、合鍵はAIのシェルに入らないからです。
このフックで守れないもの
このフックが見るのは、AIが打つコマンドの文字列だけです。次のものは守れません。
AIがファイル編集の機能(Edit/Write)で、スクリプトや bat を書き換える経路
Claude Code 以外のAI
書き方を変えたコマンドや、別のファイルを経由した実行
公式の権限の説明にも、コマンドのパターンで縛るやり方は崩れやすい、という趣旨の記述があります。
中継ぎスクリプトと bat の編集は、Claude Code の権限の設定(permissions)でも止めておきます。たとえば deny(禁止)の一覧に、作業フォルダ(例では C:/ec-tools の下すべて)の編集を止める項目を1つ足す形です。書き方は、公式の権限の説明で確かめてください。フックと合わせて、二重の守りです。
入れる順番に気をつけます。 1-9 の書き換えをAIに頼むのは、移行作業の間だけです。1本目を移し終えてから、この deny を入れます。範囲は、少なくとも中継ぎスクリプトのフォルダ(例:C:/ec-tools/1password の下)と、移した処理の bat です。
そのうえで、より強い守りは 2-5 の「ユーザーを分ける」です。
💡 AIに頼むなら:Claude Code に、フックの差分と、見本の入力を流す試験を作ってもらいます。設定ファイルへの反映は自分の手でやります。AIが自分の守りを書き換えられる状態は、作らないほうが安心です。
2-3 フックの落とし穴3つと確かめ方
フックは「書いたら効く」とは限りません。私は3回すり抜けられました。直したら、見本の入力を流して確かめます。

落とし穴①:先に当たった「確認(ask)」が、素通りした
私のフックは、上から順に照合し、最初に当たった判定を返す作りです。前からある行に「password を含むなら確認(ask)」がありました。新しい deny の行は、その後ろに足していました。
ところが、中継ぎスクリプトの置き場所の名前には「1password」が入っています。その中の「password」に、先に ask が当たったのです。
公式の説明では、自動で進むモード(auto モード)でも、ask のルールは確認を出すとされています。けれど私の環境(Claude デスクトップアプリ・自動モード)では、ask を返したコマンドが確認なしに実行されました。
私の環境と設定での観察で、再現の条件は確かめていません。製品の不具合と断定するものではありません。ご自分の環境でも試して確かめてください。
私の結論は1つだけです。止めたいものは deny にして、ask より前に置きます。 ask に頼らない形にしておけば、モードの違いに左右されません。
落とし穴②:理由の文のバックスラッシュで、JSONが壊れた
deny の理由の文に、フォルダの場所を `\` 区切りで書きました。するとフックが返すJSONに、正しくない書き方が混ざりました。Claude Code は判定を読めず、コマンドはそのまま実行されてしまったのです。
これは公式の仕様どおりの動きです。公式の説明では、フックの出力が正しいJSONとして読めないとき、既定では処理を止めずに進めます。守りが壊れると、開いたままになるのです。
対処は次のとおりです。
理由の文にバックスラッシュを入れない。場所を書くなら `/` 区切りにする
公式には、終了コード2で止める方式や、失敗したら止める設定(onFailure)も載っている(私はまだ試していません)
落とし穴③:メモ帳の編集で、改行が消えた
フックの本体をメモ帳で直したら、改行が消えて2つの行がつながりました。前からある別の判定が、黙って効かなくなっていました。
フックのファイルは、もとの保存形式(文字コードと改行の種類)のまま編集します。
⚠️ ここからが一番大事です。 落とし穴は3つとも、見た目では気づけませんでした。直したら必ず、次の確かめ方を通します。
確かめ方1:見本の入力を流す
直したら、AIに頼む前に、見本の入力をフックへ直接流します。見るのは「判定」と「JSONの正しさ」の2つです。コマンドは Git Bash の画面で打ちます(PowerShell では `printf` が使えません)。
止めるべきものの例です。
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"op item list"}}' | bash ~/.claude/hooks/op_guard.sh | python -m json.tool
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"& \"C:/tools/op.exe\" read op://automation/x/y"}}' | bash ~/.claude/hooks/op_guard.sh | python -m json.tool
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"C:/ec-tools/1password/test_op_run.ps1"}}' | bash ~/.claude/hooks/op_guard.sh | python -m json.tool
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"powershell C:/ec-tools/1password/test_op_run.ps1"}}' | bash ~/.claude/hooks/op_guard.sh | python -m json.tool
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"cmd /c run_collector.bat"}}' | bash ~/.claude/hooks/op_guard.sh | python -m json.tool
printf '%s' 'not json' | bash ~/.claude/hooks/op_guard.sh | python -m json.toolどれも `permissionDecision` が `deny` で、エラーなく整形されて表示されれば合格です。JSONが壊れていれば、ここでエラーになります。
5行目は、移した bat を名前だけで起動する形で、名前を規則3に足していれば止まります。最後の行は、壊れた入力でも止まる(閉じる側に倒れる)ことの確かめです。
止めてはいけないものも流します。
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"op --version"}}' | bash ~/.claude/hooks/op_guard.sh
printf '%s' '{"tool_name":"PowerShell","tool_input":{"command":"Get-Date"}}' | bash ~/.claude/hooks/op_guard.sh何も表示されなければ、通す判定です。
私はこの例を、手元の Git Bash で試しました。流したのは、ここに挙げた形を含む20通りほどの見本の入力と、Python が動かない場合です。どれも判定が想定どおりになるのを確かめました。ご自分のフォルダ名に書き換えたら、同じように流してください。
確かめ方2:実発火テスト
最後に、AIに実際に打たせる「実発火テスト」をします。このとき、存在しないファイル名や項目名を使います。万一すり抜けても、何も漏れないようにするためです。
`op read op://automation/does-not-exist/credential` → 止まればOK
`Test-Path $env:LOCALAPPDATA\EcAutomation\no-such-op-service-account.xml` → 止まればOK
`C:\ec-tools\1password\no-such-test.ps1` → 止まればOK
`op --version` → 通ればOK
2-4 もしAIのシェルで合鍵が復号されたら
値が画面に出ていなくても、念のため合鍵を新しくします。切り替わったかは、読み取り回数を目安に確かめます。
私の試験では、落とし穴②の間に、AIのシェルで試験スクリプトが1回動きました。出力は OK/NG だけなので、値は表示されていません。ただ、合鍵がAIの側で一度開いたことは事実です。
影響の範囲も書いておきます。このときの合鍵は、読み取りだけで、`automation` 保管庫1つにしか届かない設定でした。そのため、影響が及ぶのは、その保管庫の値までと想定しています。
AIの会話の記録に、値が出ていないことも確かめました。それでも、念のため出し直しました。一度開いた合鍵を使い続けるのは、どうにも落ち着かなかったからです。
私がやったことは5つです。
1. 1password.com のサービスアカウントの画面で「トークンをローテーション」を選び、新しいトークンを出す
2. 1-6 のコマンドで、新しいトークンを保存し直す
3. 1-8 の試験を、自分の PowerShell で動かす
4. `op service-account ratelimit` のトークンの行が、0から数え直されているのを見る
5. AIの会話の記録に、値が出ていないかを見る
トークンの行はトークンごとに数えるので、0に戻れば切り替わった目安になります。ただし、1時間たてば数は戻るので、確かな証明ではありません。旧トークンが使えなくなったかは、取り消しや削除の状態を、サービスアカウントの画面で別に確かめます。
公式の説明によると、トークンの扱いはローテーションのほかに2つ。取り消しと、サービスアカウントの削除です。作成時に保管庫へ保存された古いトークンの項目があれば、それも消します(1-5)。
漏れを疑ったら、発行元で合鍵を作り直して差し替える。これは、モールのAPIキーでも同じ考え方です。
2-5 その先:無人の定時実行を別のユーザーに分ける
より強い守りは、無人の定時実行専用の Windows ユーザーを作ることです。AIを動かすユーザーからは、合鍵にもスクリプトにも触れなくします。
フックは文字列で止める守りなので、抜け道が残ります(2-2)。公式の権限の説明も、OSの側で強制するならサンドボックス(隔離した実行環境)を使うよう案内しています。
私の次の段階は、こうです。
無人の定時実行専用の Windows ユーザーを作る
そのユーザーで、合鍵を保存し直す(DPAPIはユーザーごと)
移した処理のタスクを、そのユーザーで登録し直す
AIを動かすユーザーからは、スクリプトも合鍵も読み書きできないようにする
こうすれば、残っていた2つの弱点も、AIを動かすユーザーから切り離せます。1つは、AIがファイル編集の機能でスクリプトを書き換える経路です。もう1つは、`op run` から起動したプログラムに合鍵が引き継がれる点です。それでも、管理者の権限を持つプログラムからは守れません。
ただ、専用ユーザーへの切り替えは、共有ディスクの権限、Pythonの環境、ログの置き場所と、決めることが多い作業です。移行が一通り終わってから、計画するつもりです。
💡 AIに頼むなら:専用ユーザーへ移すときの「確認項目の一覧づくり」を頼みます。タスク名・フォルダの権限・ログの場所を表にしてもらい、実際の設定は自分でします。
📌 まとめ|合鍵は「置く」から「実行の瞬間だけ渡す」へ
Windowsなら、1Password CLI の `op run` と読み取り専用のサービスアカウントを使います。平文のAPIキーを減らし、「実行の瞬間だけ渡す」形に移せます。
作業の前後で、次の5点を見直してください。
保管庫は自動化専用の1つで、名前は英字か。サービスアカウントは「読み取るだけ」か
トークンは `Export-Clixml` で暗号化して保存したか。先にコマンドを動かして待たせ、その間にコピーしたか。保存後にクリップボードの履歴も消したか
守れるもの(設定ファイルの持ち出し・別ユーザー・別PC・バックアップへの平文の混入)と、守れないもの(同じユーザーのプログラム)を分けて考えたか
個人プランの1日の上限(アカウント全体で1,000回)を見積もったか。止まると困る処理と、その鍵は移さずにおいたか
AIと同じユーザーなら、暗号化だけでは足りない。読めなかったら止めるフックを、deny を ask より前に置いて作り、見本の入力で確かめたか
最初の1歩は、ダミーの値で疎通試験まで。契約が済んでいれば、保管庫づくりから疎通試験まで(1-4〜1-8)、私の環境で30〜60分です。
保管庫 `automation` に `CLI-Test` を作ります(1-4)。読み取り専用のサービスアカウントを作って合鍵を保存し(1-5・1-6)、CLI を入れて(1-7)、1-8 の試験で OK が出るのを見てください。本物の値は、それからで十分です。
コマンドを使わない方の最初の1歩は、冒頭の「💻 コマンドを使わない方は、ここだけ」にある3つの質問を、外注先に送るところまでです。キーをチャットに貼らないことも、今日から始められます。
平文の値が設定ファイルから減れば、AIにスクリプトの手直しを頼むときの不安も1つ減ります。AIに任せる範囲を広げる前に、まず1本から試してみてください。
本記事は2026年10月24日時点の、私の環境での検証結果です。セキュリティに万全はなく、結果を保証するものではありません。実施は自己責任で、まずはダミーの値で試してください。
1Password は自費で契約しています。各社からの報酬・無償提供・紹介リンクはありません。
1Password は AgileBits Inc. の商標または登録商標です。Windows・Windows Hello・PowerShell は Microsoft Corporation の商標または登録商標です。Claude・Claude Code は Anthropic, PBC の商標または登録商標です。本記事は各社の公認・提携を受けたものではありません。
✨ この記事が役に立ったら、応援していただけると記事執筆の励みになります ✨
❤️ スキ:ハートマークひとつが、次の記事を書く励みになります
🔔 フォロー:新しい記事をいち早くお届けします
💬 コメント:ご質問・ご感想は今後の記事づくりの参考になります
みなさまの応援が、毎回の執筆を支えてくれています 🙇♂️
🔗 関連記事
【2026】楽天・Amazon出店者のセキュリティ対策|紙1枚から始める77項目
【2026年版】Claude Codeセキュリティ対策|settings.json権限設定とサンドボックスで押さえる5つの急所
【前編・2026年版-プロンプトインジェクション対策】EC運営者のAIが乗っ取られる7つの手口|顧客問い合わせ・PDF・レビューが侵入口に
【後編・2026年版-プロンプトインジェクション対策】EC事業者の5つの自衛策|「受付係」と「決裁者」を分けるだけでいい
【2026年版】楽天の管理画面は言葉で動く|EC運営者のAPI自動化20選
【2026保存版】Claude Code×Codex連携|EC運営の3コマンド
【2026年版】ハーネスエンジニアリング実践ガイド|Claude Code・Codex・Hermes・OpenClaw 徹底比較とEC活用法
📖 出典
はじめに・第1部
GitGuardian『The State of Secrets Sprawl 2026』(2026年3月公開)
https://blog.gitguardian.com/the-state-of-secrets-sprawl-2026/
個人情報保護委員会『個人情報の保護に関する法律についてのガイドライン(通則編)』(令和8年6月一部改正)
https://www.ppc.go.jp/files/pdf/260614_guidelines01.pdf
個人情報保護委員会『大規模な漏えい等事案を踏まえた対応について(注意喚起)』(2026年10月7日)
https://www.ppc.go.jp/files/pdf/261007_alert_dataleakage.pdf
1Password『Introducing 1Password for Agents』(2026年10月22日)
https://1password.com/blog/1password-for-ai-agents
1Password『1Password for Agents Launches as the Trust Layer for Personal AI Agents』(2026年10月22日)
https://1password.com/press/2026/october/1password-for-agents-trust-layer-personal-ai-agents
1Password『1Password for Claude』(サポート)
https://support.1password.com/1password-claude/
Claude『Get started with 1Password for Claude』(2026年7月16日)
https://support.claude.com/en/articles/15936181-get-started-with-1password-for-claude
1Password『料金(個人・ファミリー)』
https://1password.com/pricing/password-manager
1Password『料金(ビジネス)』
https://1password.com/business-pricing
1Password『Service accounts』
https://www.1password.dev/service-accounts/
1Password『Get started with service accounts』
https://www.1password.dev/service-accounts/get-started/
1Password『Service account security』
https://www.1password.dev/service-accounts/security/
1Password『Service account rate limits』
https://www.1password.dev/service-accounts/rate-limits/
1Password『Use service accounts with 1Password CLI』
https://www.1password.dev/service-accounts/use-with-1password-cli/
1Password『Secret reference syntax』
https://www.1password.dev/cli/secret-reference-syntax/
1Password『op run』
https://www.1password.dev/cli/reference/commands/run/
1Password『Load secrets into scripts』
https://www.1password.dev/cli/secrets-scripts/
1Password『Get started with 1Password CLI』
https://www.1password.dev/cli/get-started/
1Password『1Password CLI app integration security』
https://www.1password.dev/cli/app-integration-security/
1Password『1Password CLI 版履歴』
https://app-updates.agilebits.com/product_history/CLI2
Microsoft『winget-pkgs:AgileBits.1Password.CLI』
https://github.com/microsoft/winget-pkgs/tree/master/manifests/a/AgileBits/1Password/CLI
Microsoft Learn『Export-Clixml』
https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-clixml
第2部
Claude Code『Hooks reference』
https://code.claude.com/docs/en/hooks
Claude Code『Hooks guide』
https://code.claude.com/docs/en/hooks-guide
Claude Code『Permissions』
https://code.claude.com/docs/en/permissions
Claude Code『Permission modes』
https://code.claude.com/docs/en/permission-modes
#1PasswordCLI #1Password #APIキー管理 #シークレット管理 #opコマンド #サービスアカウント #PowerShell #タスクスケジューラ #Python自動化 #ClaudeCode #winget #Windows #楽天市場 #Amazon出品 #ネットショップ #EC運営 #EC事業者 #店長 #2026年 #AIエージェント #生成AI #セキュリティ #業務自動化 #DX