Claude APIとは｜できること・向く人・最小の利用例まで解説

チャットやClaude Codeには慣れてきたけれど、そろそろ自分のスクリプトからClaudeを呼び出したい。そう思って公式ドキュメントを開くと、英語のリファレンスとSDKごとのサンプルが並んでいて、何から手を付ければよいか迷う人は多いはずです。

本記事では、Claude API（自分のコードからClaudeモデルを呼び出す仕組み）でできることと向く人の判断を先に示し、そのあとプレースホルダのAPIキーを使った最小の利用例1つまでを通して解説します。

なお、ターミナルで対話しながらコーディングを進める「Claude Code」の使い方は、本記事とは別の入り口です。始め方はこちらにまとめてあるので、対話型CLIを探している場合はそちらを先にご覧ください。

今日の結論

• Claude APIは自分のコードやスクリプトからClaudeを呼び出す仕組みで、チャット画面やClaude Code（対話型CLI）とは経路が異なります。処理の自動化や自作ツールへの組み込みができます
• 向いているのは、定型のやり取りをスクリプト化したい人や、自分のツールにClaudeを組み込みたい人です。チャットで用が足りているなら、無理にAPIへ移る必要はありません
• 動かすまでの流れは「アカウント→APIキー→最小のコード1つ」です。本記事は1つの言語で書いた最小例を、実際に動くところまで通します（モデル名やエンドポイントは執筆時点の公式ドキュメントで確認した値、キーはプレースホルダです）
• 途中でエラーが出て止まったら、認証・モデル名・送信先（エンドポイント）の3点から見直すと切り分けやすくなります
• APIキーの発行手順や環境変数への安全な置き方は、続編（準備中）で詳しく扱う予定です。料金やレート制限の詳細も別記事に譲ります

Claude APIでできることと向く人（チャット・Claude Codeとの違い）

Claude API（プログラムから機能を呼び出す窓口）は、自分のコードやスクリプトの中からClaudeモデルを呼び出す仕組みです。ブラウザのチャット画面のように人が一往復ずつ入力する代わりに、プログラムが用意したテキストを送り、返ってきた応答をそのまま別の処理に渡せます。

執筆時点の公式ドキュメントで確認した範囲では、代表的な使い方として次のようなものが挙げられます。

• 定型のメール返信やレポート作成など、繰り返し発生する処理の自動化
• 自作のツールやアプリにClaudeの応答生成を組み込む
• 大量のテキストをまとめて要約・分類するバッチ処理

向いているのは、同じ種類の処理を繰り返したい人、自分のアプリの一部としてClaudeを動かしたい人。逆に、日々の調べ物や単発の質問で用が足りているなら、急いでAPIに移る理由はありません。チャットの手軽さの方が合っている場面も多いはずです。

経路ごとの違いを整理すると、次のようになります。

この違いが生まれるのは、チャットとClaude Codeが対話の窓口をあらかじめ用意しているのに対し、APIは窓口そのものを自分のコードで組み立てる必要があるためです。

なお、Claudeにツールや外部データへのアクセスをつなぐ「MCP」はAPIとは別の経路です。設定方法はClaude MCPの始め方にまとめてあるので、混同しないよう注意してください。

始める前の前提（アカウント・APIキーの考え方）

最小の例を動かす前に、次の3点を用意しておきます。

1. 開発者向けのアカウント（Claude Consoleにサインインできる状態）
2. APIキー（Consoleで発行する、呼び出し元を識別するための秘密の文字列）
3. コードを実行する環境（本記事ではPythonを想定します）

このうちAPIキーは、リクエストを送ってきたのが誰かをAnthropic側のサーバーが確認するための鍵のような文字列です。人に見せたり、コードにそのまま書いて公開リポジトリに上げたりすると、第三者に成りすまされて使われてしまう恐れがあります。値そのものを画面に映したり、コードへ直書きしたまま公開したりしない、という原則だけ先に押さえておいてください。

キーの発行手順や、環境変数への安全な置き方、漏えいしてしまった場合のローテーションは、続編（準備中）で手順を追って説明します。ここでは概念だけをつかんでおけば十分です。

最小の利用例1つ（Python・プレースホルダキーで動きを確認）

ここからは、実際にコードを1つ動かして応答が返ってくるところまでを確認します。言語は公式クイックスタートに合わせてPythonを使います。

1. ターミナルでSDKをインストールします。

pip install anthropic

1. 次のコードをquickstart.pyなどの名前で保存してください。<APIキー>の部分は、この記事ではプレースホルダのまま残しています（実際のキーの安全な扱い方は続編で説明します）

import anthropic

client = anthropic.Anthropic(api_key="<APIキー>")

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "こんにちは、Claudeについて一言自己紹介してください"}
    ],
)

print(message.content[0].text)

1. ファイルを実行しましょう。

python quickstart.py

実行してClaudeからの応答テキストが表示されれば、最初の1例は完了です。ここで使ったモデル名（claude-sonnet-5）とエンドポイント（https://api.anthropic.com/v1/messages）は、執筆時点の公式ドキュメントで確認した値です。モデル名は今後変わる可能性があるため、動かない場合はまず公式ドキュメントで現在の名称を確認してください。

動かないときの見直し3点（認証・モデル名・エンドポイント）

最小の例が動かないときは、認証・モデル名・エンドポイントの3点から見直すと切り分けやすくなります。執筆時点の公式ドキュメントで確認できる範囲を表にまとめました。

認証エラーは、サーバー側が送られてきたAPIキーから呼び出し元を確認できないときに返ってきます。まずキーの中身とヘッダー名を疑うのが近道です。モデルが見つからない旨のエラーは、リクエストで指定した名前のモデルをサーバー側が見つけられないために起こります。コードを書いた時点の名称のままにしていると、ある日突然動かなくなることも珍しくありません。リクエスト形式のエラーは、送信先やパラメータの組み立て方が公式の仕様とずれているときに返ってきます。エンドポイントやヘッダーの綴りを一つずつ確認すると、原因を絞り込みやすくなります。

次に読む（キーの安全な設定は続編へ・シリーズの読む順）

APIキーの発行手順や環境変数への安全な置き方は、続編で詳しく扱う予定です。現在は「準備中」のため、公開まではもうしばらくお待ちください。

ターミナルで対話しながらコーディングを進める使い方に興味がある場合は、Claude Codeの始め方から読み進めてください。インストールから確認したい場合はClaude Codeのインストール手順も参考になります。

Claude Code・MCP・APIがそれぞれどこを担当しているかの全体像は、Claude Code入門ガイドにまとめてあります。シリーズ全体の地図として活用してください。

本記事の内容は執筆時点（2026-08-29）の情報に基づきます。Claude APIのモデル名・エンドポイント・料金・仕様は変更される可能性があります。重要な判断は公式ドキュメントで確認してください。