「Claude CodeでAPIを使うと、何が変わるんですか?」 最近、この質問を本当によく受けるようになりました。 Claude Codeでコードを書いたり、ファイルを整理したり、そこまではできるようになった。でも、X・Slack・Google・Notion・OpenAI…といった外部サービスと連携する一歩が踏み出せない。 原因は、だいたい次の4つです。
APIとは、アプリやサービスを機械から操作できるようにする窓口です。 人間はXをブラウザやアプリから開いて投稿します。APIは、同じ投稿操作を「プログラムから」できるようにするものです。Slack、Gmail、Google Drive、Notion、Figma、Stripe、OpenAI、ほぼすべての現代サービスはAPIを公開しています。 Claude Codeは、ローカルのファイルを読み書きし、ターミナルでコマンドを実行できます。ここにAPI連携が加わると何が起きるか。
API連携というと、エンジニア専用の難しい話に聞こえますが、実態はシンプルです。
抽象論だけだと使い方が見えないので、川合が実際に回している自動化を7つ挙げます。
記事を書き終わったら、「この記事の告知文を3案作って、良い方をXに投稿して」と指示するだけ。キャプション作成→投稿までノータッチで完了します。
#design チャンネルの未返信を朝9時にまとめて「今日対応すべき依頼」としてDMで送らせる。朝、PCを開いた瞬間にTODOが決まります。
Gmailの未読スレッドを読ませて、「この問い合わせに対する返信下書きを作って」と指示。Gmailの下書きフォルダに自動保存されます。送信は人間が確認してから。
Stripeの売上データを取得→Google Sheetsに貼り付け→月次サマリをMarkdownで書き出す。手動で30分かかっていた作業が3分になります。
Xの特定リストから「今日のAIニュース」をAPI経由で取得→Claude Codeが選別→要約。朝の5分でその日のトレンドが頭に入ります。
「この記事の図解プロンプトを5枚作って、それぞれGemini APIで生成して」で、画像生成まで一気通貫。1枚ずつ手で回していた作業がコマンド1発になります。
議事録、タスク、デザインファイルの管理ツール側にも書き込みできます。Claude Codeが全部の部屋に出入りできる鍵を持つ感覚に近いです。
「送信系の自動化」は最初は人間確認を挟む。メール送信・SNS投稿・決済・削除といった取り消せない操作は、ドラフト保存まででいったん止めて、人間がチェックしてから送ることを推奨します。自動化の事故は「完璧にしよう」と欲を出したときに起きます。
ここからは具体的な手順です。新しいAPIを1つ追加するたびに、毎回同じ3ステップを踏むだけ。
各サービスの管理画面で「APIキー」「アクセストークン」を発行します。場所はサービスによって違いますが、だいたいこのあたりです。
キーをClaude Codeに教える方法は2つあります。下の方法だけ使ってください。上の方法は事故のもとです。
.env ファイルに保存する
環境変数で保存する例。ターミナルで次のコマンドを一度打っておきます(macOSの場合)。echo 'export OPENAI_API_KEY="sk-xxxxx"' >> ~/.zshrc
source ~/.zshrc
.env ファイルで保存する場合は、プロジェクトフォルダの中に .env というファイルを作り、こう書きます。
OPENAI_API_KEY=sk-xxxxx
SLACK_BOT_TOKEN=xoxb-xxxxx
.env は必ず .gitignore に追加する。GitHubにプッシュすると世界中に公開されます。事故の9割はここで起きます。
ここからは楽です。Claude Codeに日本語で話しかけるだけ。
環境変数のOPENAI_API_KEYを使って、
OpenAIのAPIでgpt-4.1に「今日の天気を一言で」と聞いて、
結果を表示して
Claude Codeはcurlコマンドを組み立て、APIを叩き、結果を返します。エラーが出たら「なぜ失敗したか」も教えてくれるので、そのまま「直して」と言えば直ります。
頻繁に使うサービスは、MCP(Model Context Protocol)という仕組みでClaude Codeに常駐させると楽です。Slack、Notion、GitHub、Playwright(ブラウザ操作)などは公式MCPサーバーが提供されています。 設定方法は公式ドキュメントから1行コマンドをコピペするだけで済みます。詳しくは別記事「Claude CodeからSlackを操作する方法」で手順を追っています。 使い分けの目安:
API連携を始めるなら、この順番で触るのが効率的です。すべて無料枠から始められます。
料金:従量課金。gpt-4.1 miniなら1,000回呼び出しても数百円。 用途:Claude Code以外のAIモデルを使い分けたい時。音声書き起こし(Whisper)、画像生成(DALL-E 3は2026年5月2日廃止予定、gpt-image-1へ移行推奨)もここ。
料金:従量課金。定額プラン(Max等)利用中でもAPIは別課金。 用途:バッチ処理や大量並列タスク。Claude Codeのサブエージェントとして組み込み可能。
料金:完全無料(Bot Tokenの発行・呼び出しに料金なし)。 用途:メッセージ読み書き、未返信検知、定時リマインド、チャンネル要約。
料金:完全無料(通常業務の量なら無料枠で足りる)。 用途:メール下書き、スプレッドシート集計、ファイル管理、予定追加。社会人の日常業務自動化の7割はここでカバーできます。
料金:完全無料。 用途:議事録・タスク・ナレッジベースの自動記入。Notionを使っているなら必須。
料金:2026年2月からPay-Per-Use(従量課金)がデフォルト。Legacy Free枠利用者には$10バウチャー付与で移行。新規は無料枠なし(公益アプリ等は個別審査)。最新価格は公式参照。 用途:自動投稿、リスト取得、エンゲージメント分析。個人運用ならPay-Per-Useで少額から開始可能。
料金:無料枠が大きい(Imagen 4 / Nano Banana (Gemini 2.5 Flash Image)。Nano Banana Proは有料のみ)。 用途:画像生成、動画生成、マルチモーダル分析。コスト効率が非常に良い。
迷ったら次のように選んでください。
ここが最大の不安ポイントです。結論から言えば、次の5つを守れば事故は起きません。
繰り返しですが、最重要です。ソースコード、チャット履歴、Slackの投稿、Notionのメモ、どこにもキーの文字列を残さない。必ず環境変数か .env に保存し、プログラム内では process.env.API_KEY のように参照します。
.gitignore に .env を入れるGitHubに公開したリポジトリでAPIキーを漏洩させると、数分以内に世界中のボットが検知して悪用を試みます。これは誇張ではなく、実際に毎日起きています(GitGuardian報告で2025年だけで2,865万件の秘密情報がpublicリポジトリに漏洩)。
# .gitignore に追加
.env
.env.local
*.key
secrets.json
不安な人は git-secrets や trufflehog というツールをインストールしておくと、コミット時に自動で鍵漏洩を検知してくれます。
OpenAIやAnthropicなどの有料APIは、用途別にキーを分けて発行してください。「Claude Code用」「検証用」「本番用」と分ければ、1つ漏れても他に影響しません。怪しいと思ったら即失効できます。
OpenAI・Anthropic・Google・Stripeなど、従量課金のAPIは必ず利用上限(Usage Limit)を設定します。OpenAIなら「月$10まで」と決めておけば、キーが漏れて悪用されても被害は$10で止まります。設定画面の「Limits」「Budget」「Quota」の項目です。
Slack、Google、Notionなどは、トークンに権限スコープを指定できます。「読み取りだけ」「特定チャンネルだけ」と絞れます。最小権限で発行するのが鉄則です。「何でもできる全権キー」を作らない。
最後に、事故の典型パターンを3つ挙げます。
最後に、今日・明日でできる小さな一歩をまとめます。
.env ファイルを作ってキーを入れる:プロジェクトフォルダに .env、隣に .gitignore(.env を追加)。Claude Codeに「こう書いて」とお願いするだけでOK