自分の 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)にあります。
用意するもの
Section titled “用意するもの”- Claude Console のアカウント — Anthropic の開発者向けのサイトで、platform.claude.com にあります。以前は Anthropic Console という名前でした。
- ミニオンに入った Claude Code。 まだ入っていなければ、頭脳 タブから入れられます。
1. Anthropic の側を準備する
Section titled “1. Anthropic の側を準備する”以下の画面の名前は、この文書を書いた時点の Claude Console のものです(英語の表示)。画面が違って見えるときは、Anthropic のヘルプ(API キーの作り方・支出の上限)を見てください。
クレジットを買う
Section titled “クレジットを買う”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 の既定のワークスペースには、個別の支出の上限を決められません)。
支出の上限を決める
Section titled “支出の上限を決める”Minion Workspace は自分の API キーでの利用に金額の上限を持ちません。請求額を抑えるのは、Anthropic で決める上限です。 ミニオンは人が見ていないあいだも自分で動きます。ルーティンやワークフローは予定どおりに動き、何かがおかしいとき(ワークフローが同じ手順を繰り返すなど)もキーを使い続けます。Minion Workspace は短い時間に多く使ったミニオンを一時停止しますが(下)、1 か月ぶんの額を抑えられるのは Anthropic の上限だけです。
- ミニオン用のワークスペースに: Settings → Workspaces でワークスペースを選び、Spend limits を開いて月の上限を決めます。上限の一部に達したときに Anthropic から知らせを受ける設定もできます。
- アカウント全体に: Settings → Billing の Spend limits で Set limit(または Adjust limit)を押します。
上限に達すると、翌月になるか上限を上げるまで、Anthropic はリクエストを断ります。
API キーを作る
Section titled “API キーを作る”- Settings → API keys を開き、Create key を押します。
- キーに名前を付け(ミニオンの名前がわかりやすいです)、ミニオン用に作った ワークスペースを選びます。そのワークスペースの上限が効くようになります。ミニオンごとに 1 本ずつ作ると、Anthropic の側でミニオンごとの利用を見られ、1 体だけ止めることもできます。
- 有効期限を決めた場合は、期限が来るとミニオンが動かなくなります。その前に新しいキーをつなぎ直してください。
- キーをコピーします。
sk-ant-で始まり、Claude Console が表示するのは 作ったときの 1 回だけ です。
2. 頭脳タブでキーをつなぐ
Section titled “2. 頭脳タブでキーをつなぐ”- Minion Workspace でミニオンのページを開き、頭脳 タブを開きます。
- 頭脳エンジンを追加 で、Claude Code の 自分の API キー(プロキシ経由) のカードを探します(プロキシ式 のフィルタで絞り込めます)。カードが 未導入 のときは、先に 導入する を押して、終わるまで待ちます。
- 入力欄(
ANTHROPIC_API_KEYと表示されています)にキーを貼り付け、接続する を押します。2 段階認証を使っているアカウントでは、認証アプリの確認コードを求められることがあります。 - Minion Workspace は、何かを保存する前に Anthropic でキーを確かめます。カードが 接続済 になれば完了です。
接続すると、それまでミニオンが使っていたものと入れ替わります。ミニオンAI につないでいた場合は、その接続が外れます。キーをつないでいるあいだは、Claude Code が Claude のプランにサインインしていても、キーのほうを使います。
キーが受け付けられないとき
Section titled “キーが受け付けられないとき”| 表示 | 意味 |
|---|---|
| Anthropic がこの API キーを受け付けませんでした。Claude Console からコピーしたキーを確かめてください。 | キーが間違っている、欠けている、または削除されています。コピーし直すか、新しいキーを作ってください。何も保存していません |
| この API キーには API を使う権限がありません。Claude Console で、キーのワークスペースと組織を確かめてください。 | Anthropic はキーを知っていますが、使わせません(ワークスペースがアーカイブされた、など)。使っているワークスペースでキーを作り直してください。何も保存していません |
| 自分の API キーで接続しましたが、いまは Anthropic でキーを確かめられませんでした。キーが正しくないと、ミニオンが作業を始めたときに失敗します。 | Anthropic に問い合わせられなかったので、確かめずに保存しました。ミニオンの最初の作業が認証のエラーで失敗したら、正しいキーでつなぎ直してください |
| 試行が多すぎます。1 分ほど待ってから、もう一度お試しください。 | 1 分のあいだに 5 回を超えて接続を試しました。1 分ほど待ってから、もう一度試してください |
確かめるのはキーが有効かどうかで、クレジットが残っているかどうかではありません。
3. ミニオンが使った額を見る
Section titled “3. ミニオンが使った額を見る”キーをつないでいるあいだ、カードに 今月(UTC)のこのミニオンの利用 が出ます。月の 1 日(UTC)からの金額(ドル)とリクエスト数です。
金額は 公開定価での試算 です。実際に支払うのは Anthropic からの請求額で、割引や税などでずれることがあります。正確な額は Claude Console の利用と請求のページで確かめてください。カードの Anthropic で支出の上限を設定する のリンクから Claude Console を開けます。
新しいモデル は、Anthropic が出したその日から使えます。Minion Workspace がそのモデルの単価を登録するまでは、Anthropic のモデルで知られている最も高い単価で試算するので、しばらく試算額は高めに出ます。
安全のための制限
Section titled “安全のための制限”Anthropic で決める上限とは別に、自分の API キーで動くミニオンには Minion Workspace の制限が 2 つあります。どのプランでも同じです。
- ミニオン 1 体につき 1 分に 20 リクエストまで。 それを超えたリクエストには少し待ってもらいます。Claude Code は自分で待ってやり直すので、作業が失敗するのではなく、少しのあいだ遅くなります。
- 短い時間に多く使ったミニオンの一時停止: 直近 1 時間で $20 を超えた とき(公開定価での試算)。下で説明します。
ミニオンが一時停止したとき
Section titled “ミニオンが一時停止したとき”一時停止すると:
- そのミニオンのリクエストを Anthropic へ送らなくなり、ミニオンは新しい作業(ルーティン・ワークフロー・ボードのタスク)を始めません。会話・実行履歴・設定はそのまま残ります。
- Minion Workspace の中とメールでお知らせします。
- 頭脳 タブのカードに「自分の API キーを短い時間に多く使ったため、このミニオンを一時停止しています。再開するまで、LLM へのリクエストは送りません。ルーティンやワークフローが同じ作業を繰り返していないか確かめてから、再開してください。」と出ます。
ミニオンのルーティンとワークフローを確かめてください(同じ手順が繰り返されていないか、など)。問題が無いとき、または意図した利用(大きな作業)だったときは、カードの 再開する を押します。一時停止は自動では解けません。
カードに「運営がこのミニオンの LLM の利用を一時停止しています。サポートにお問い合わせください。」と出ているときは、不正な利用の疑いやセキュリティ上の理由などで、Minion Workspace の運営が止めています。自分では再開できないので、お問い合わせ ください。また、セキュリティ上の問題などがあるときは、利用規約にもとづいて、自分の API キーでの接続をまとめて一時停止することがあります。
接続を解除する
Section titled “接続を解除する”カードの 接続を解除 を押します。ミニオンの通行証はすぐに使えなくなり、Minion Workspace は保管していたキーを削除します。別のキーをつないだとき、ミニオンAI に切り替えたとき、ミニオンを削除したときも同じです。
キーそのものは Anthropic でまだ使える状態です。もう使わないなら、Claude Console(Settings → API keys)で削除してください。
うまくいかないとき
Section titled “うまくいかないとき”ミニオンの作業が認証のエラーで失敗する — Anthropic でキーが削除されたか、期限が切れています。新しいキーを作ってつなぎ直してください。
ミニオンの作業がクレジットの残高不足で失敗する — Claude Console(Settings → Billing)でクレジットを足してください。
ミニオンの作業が利用の上限に達したと言って失敗する — Anthropic の支出の上限に達しています。Claude Console で上限を上げるか、翌月まで待ってください。