コンテンツにスキップ

自分の API キーでつなぐ

ミニオンは Claude Code で考えます。Claude Code が Claude を使えるようにする方法の 1 つが、Anthropic で発行した 自分の API キー です。ミニオンが使ったぶんは Anthropic に直接支払い、Minion Workspace からは請求しません。

  • Anthropic のサイトで API キーを作り、Minion Workspace のミニオンの 頭脳 タブに貼り付けます。
  • Minion Workspace はキーを 暗号化して保管 し、ミニオンには渡しません。ミニオンが受け取るのは、Minion Workspace を通したときだけ使える専用の通行証で、接続を解除すると使えなくなります。
  • ミニオンの Claude Code が Claude を呼ぶたびに、リクエストは Minion Workspace を通り、そこであなたのキーを付けて Anthropic へ送ります。会話の中身は Minion Workspace を通りますが、保存しません。 残すのは利用の記録(日時・ミニオン・モデル・トークン数・試算額)だけです。
  • 利用料は、あなたと Anthropic との契約にもとづいて Anthropic から請求されます。

詳しくは 利用規約(第7条の2)と プライバシーポリシー(2.6)にあります。

  • Claude Console のアカウント — Anthropic の開発者向けのサイトで、platform.claude.com にあります。以前は Anthropic Console という名前でした。
  • ミニオンに入った Claude Code。 まだ入っていなければ、頭脳 タブから入れられます。

以下の画面の名前は、この文書を書いた時点の Claude Console のものです(英語の表示)。画面が違って見えるときは、Anthropic のヘルプ(API キーの作り方・支出の上限)を見てください。

API の利用料は、前払いで買うクレジットから支払います。Claude Console で Settings → Billing を開き、Buy credits を押します。クレジットが無くなると Anthropic が応答しなくなり、足すまでミニオンの作業は失敗します。

auto-reload(残高が減ったら自動でクレジットを買う設定)を使うときは、下の支出の上限も必ず決めてください。auto-reload があると、ほかに支出を止めるものがありません。

ミニオン用のワークスペースを作る(おすすめ)

Section titled “ミニオン用のワークスペースを作る(おすすめ)”

Claude Console には独自の ワークスペース があります。Minion Workspace のワークスペースとは関係ありません。ミニオン用のワークスペースを作ると、ミニオンだけに支出の上限を決められ、ほかの API の利用と分けて利用額を見られます。

Settings → Workspaces を開いて Create workspace を押し、「Minions」などの名前を付けて作ります(Anthropic の既定のワークスペースには、個別の支出の上限を決められません)。

Minion Workspace は自分の API キーでの利用に金額の上限を持ちません。請求額を抑えるのは、Anthropic で決める上限です。 ミニオンは人が見ていないあいだも自分で動きます。ルーティンやワークフローは予定どおりに動き、何かがおかしいとき(ワークフローが同じ手順を繰り返すなど)もキーを使い続けます。Minion Workspace は短い時間に多く使ったミニオンを一時停止しますが(下)、1 か月ぶんの額を抑えられるのは Anthropic の上限だけです。

  • ミニオン用のワークスペースに: Settings → Workspaces でワークスペースを選び、Spend limits を開いて月の上限を決めます。上限の一部に達したときに Anthropic から知らせを受ける設定もできます。
  • アカウント全体に: Settings → Billing の Spend limits で Set limit(または Adjust limit)を押します。

上限に達すると、翌月になるか上限を上げるまで、Anthropic はリクエストを断ります。

  1. Settings → API keys を開き、Create key を押します。
  2. キーに名前を付け(ミニオンの名前がわかりやすいです)、ミニオン用に作った ワークスペースを選びます。そのワークスペースの上限が効くようになります。ミニオンごとに 1 本ずつ作ると、Anthropic の側でミニオンごとの利用を見られ、1 体だけ止めることもできます。
  3. 有効期限を決めた場合は、期限が来るとミニオンが動かなくなります。その前に新しいキーをつなぎ直してください。
  4. キーをコピーします。sk-ant- で始まり、Claude Console が表示するのは 作ったときの 1 回だけ です。
  1. Minion Workspace でミニオンのページを開き、頭脳 タブを開きます。
  2. 頭脳エンジンを追加 で、Claude Code の 自分の API キー(プロキシ経由) のカードを探します(プロキシ式 のフィルタで絞り込めます)。カードが 未導入 のときは、先に 導入する を押して、終わるまで待ちます。
  3. 入力欄(ANTHROPIC_API_KEY と表示されています)にキーを貼り付け、接続する を押します。2 段階認証を使っているアカウントでは、認証アプリの確認コードを求められることがあります。
  4. Minion Workspace は、何かを保存する前に Anthropic でキーを確かめます。カードが 接続済 になれば完了です。

接続すると、それまでミニオンが使っていたものと入れ替わります。ミニオンAI につないでいた場合は、その接続が外れます。キーをつないでいるあいだは、Claude Code が Claude のプランにサインインしていても、キーのほうを使います。

表示意味
Anthropic がこの API キーを受け付けませんでした。Claude Console からコピーしたキーを確かめてください。キーが間違っている、欠けている、または削除されています。コピーし直すか、新しいキーを作ってください。何も保存していません
この API キーには API を使う権限がありません。Claude Console で、キーのワークスペースと組織を確かめてください。Anthropic はキーを知っていますが、使わせません(ワークスペースがアーカイブされた、など)。使っているワークスペースでキーを作り直してください。何も保存していません
自分の API キーで接続しましたが、いまは Anthropic でキーを確かめられませんでした。キーが正しくないと、ミニオンが作業を始めたときに失敗します。Anthropic に問い合わせられなかったので、確かめずに保存しました。ミニオンの最初の作業が認証のエラーで失敗したら、正しいキーでつなぎ直してください
試行が多すぎます。1 分ほど待ってから、もう一度お試しください。1 分のあいだに 5 回を超えて接続を試しました。1 分ほど待ってから、もう一度試してください

確かめるのはキーが有効かどうかで、クレジットが残っているかどうかではありません。

キーをつないでいるあいだ、カードに 今月(UTC)のこのミニオンの利用 が出ます。月の 1 日(UTC)からの金額(ドル)とリクエスト数です。

金額は 公開定価での試算 です。実際に支払うのは Anthropic からの請求額で、割引や税などでずれることがあります。正確な額は Claude Console の利用と請求のページで確かめてください。カードの Anthropic で支出の上限を設定する のリンクから Claude Console を開けます。

新しいモデル は、Anthropic が出したその日から使えます。Minion Workspace がそのモデルの単価を登録するまでは、Anthropic のモデルで知られている最も高い単価で試算するので、しばらく試算額は高めに出ます。

Anthropic で決める上限とは別に、自分の API キーで動くミニオンには Minion Workspace の制限が 2 つあります。どのプランでも同じです。

  • ミニオン 1 体につき 1 分に 20 リクエストまで。 それを超えたリクエストには少し待ってもらいます。Claude Code は自分で待ってやり直すので、作業が失敗するのではなく、少しのあいだ遅くなります。
  • 短い時間に多く使ったミニオンの一時停止: 直近 1 時間で $20 を超えた とき(公開定価での試算)。下で説明します。

一時停止すると:

  • そのミニオンのリクエストを Anthropic へ送らなくなり、ミニオンは新しい作業(ルーティン・ワークフロー・ボードのタスク)を始めません。会話・実行履歴・設定はそのまま残ります。
  • Minion Workspace の中とメールでお知らせします。
  • 頭脳 タブのカードに「自分の API キーを短い時間に多く使ったため、このミニオンを一時停止しています。再開するまで、LLM へのリクエストは送りません。ルーティンやワークフローが同じ作業を繰り返していないか確かめてから、再開してください。」と出ます。

ミニオンのルーティンとワークフローを確かめてください(同じ手順が繰り返されていないか、など)。問題が無いとき、または意図した利用(大きな作業)だったときは、カードの 再開する を押します。一時停止は自動では解けません。

カードに「運営がこのミニオンの LLM の利用を一時停止しています。サポートにお問い合わせください。」と出ているときは、不正な利用の疑いやセキュリティ上の理由などで、Minion Workspace の運営が止めています。自分では再開できないので、お問い合わせ ください。また、セキュリティ上の問題などがあるときは、利用規約にもとづいて、自分の API キーでの接続をまとめて一時停止することがあります。

カードの 接続を解除 を押します。ミニオンの通行証はすぐに使えなくなり、Minion Workspace は保管していたキーを削除します。別のキーをつないだとき、ミニオンAI に切り替えたとき、ミニオンを削除したときも同じです。

キーそのものは Anthropic でまだ使える状態です。もう使わないなら、Claude Console(Settings → API keys)で削除してください。

ミニオンの作業が認証のエラーで失敗する — Anthropic でキーが削除されたか、期限が切れています。新しいキーを作ってつなぎ直してください。

ミニオンの作業がクレジットの残高不足で失敗する — Claude Console(Settings → Billing)でクレジットを足してください。

ミニオンの作業が利用の上限に達したと言って失敗する — Anthropic の支出の上限に達しています。Claude Console で上限を上げるか、翌月まで待ってください。