見出し画像

Claude API入門｜APIキーの取得方法からPython実装・企業導入まで解説

株式会社AIworker

※最終更新：2026年8月1日。現行モデル、APIキーの取得方法、Python SDKの実装例、Claude Code・Skills・MCPとの違いを公式情報に基づいて更新しました。

「Claudeを社内システムへ組み込みたい」
「定型処理を繰り返し実行したい」
と考えたとき、選択肢になるのがClaude APIです。

ただし、APIキーを発行して動かすことと、業務で安全に運用することは別です。本記事では、最初の1回を動かす手順だけでなく、モデル選定、エラー処理、費用管理、人による確認まで解説します。

この記事の要点

・Claude APIは、Claudeへプログラムからリクエストを送り、既存システムや定型処理へ組み込む仕組み
・最初はConsoleでAPIキーを発行し、公式SDKからMessages APIを1回呼び出せばよい
・本番導入では、モデル単価だけでなく、入力制限、再試行、ログ、権限、人の確認まで設計する

Claude APIとは

Claude APIは、AnthropicのClaudeモデルをプログラムから利用するためのインターフェースです。チャット画面を人が操作する代わりに、業務システムから文章、画像、指示を送り、生成結果を受け取れます。

たとえば、問い合わせの分類、議事録の要約、社内文書からの情報抽出、コードレビュー、画像を含む書類確認などに使えます。外部ツールを呼び出す機能と組み合わせれば、取得、判断補助、出力までの処理も構築できます。

APIは完成した業務システムではありません。 認証、画面、データ連携、ログ、監視、例外処理は利用企業側で設計します。

Claude API・Claude Code・Skills・MCPの違い

似た言葉が増えていますが、役割を分けると判断しやすくなります。

担当者が対話しながら仕事を進めるなら、まずClaude Codeで試せる場合があります。決まった入力を受け、同じ処理を複数人やシステムから繰り返すならAPIが候補です。

最初からAPI開発を選ぶ必要はありません。 Claude Codeで業務手順と効果を確かめ、再現できる工程だけをAPIへ移すと、作り直しを減らせます。

2026年8月時点のモデル選定

Claude APIでは複数のモデルを選べます。最新のモデル名や提供状況は変わるため、実装前にAnthropicのモデル一覧を確認してください。

迷ったら、最初の検証はSonnetを基準にします。その後、代表的な入力を用意して、品質が足りない処理だけ上位モデルへ、単純な処理はHaikuへ分けます。

モデル選びを単価だけで決めると、誤りの修正や再実行で総費用が増えることがあります。出力単価ではなく、人の確認まで含む1業務当たりの費用で比べてください。具体的な料金は変更されるため、公式料金表を確認します。

APIキーを取得する手順

1つ目｜Claude Consoleへ登録する

Claude Consoleへアクセスし、アカウントを作成します。チャットサービスのClaude.aiとは、利用料金や管理が別です。

2つ目｜支払いと利用上限を確認する

Consoleで請求設定、利用上限、組織やワークスペースを確認します。無料クレジットの有無は時期や条件で変わるため、付与を前提にしないでください。

3つ目｜APIキーを発行する

API Keysの画面からキーを作成し、用途が分かる名前を付けます。キーは画面に再表示できない場合があるため、安全な管理場所へ保存します。

開発、本番、部署、用途でキーを分けると、漏えい時の停止範囲と利用状況を把握しやすくなります。個人のキーを複数人で共有しないでください。

4つ目｜利用期限と権限を決める

現在のConsoleでは、キー作成時に有効期限を選べます。検証用のキーを無期限で残さず、不要になったら無効化します。本番ではワークスペースを分け、利用上限と監視方法も設定します。

Pythonで最初のAPI呼び出しを試す

公式SDKをインストールする

pip install anthropic

APIキーはコードへ直接書かず、環境変数へ設定します。

export ANTHROPIC_API_KEY="your-api-key"

リポジトリ内の`.env`へ安易に保存すると、誤って共有・公開する恐れがあります。組織ではシークレット管理サービスを使用してください。

Messages APIを呼び出す

from anthropic import Anthropic

client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="あなたは社内文書の要約担当です。事実と推測を分けてください。",
    messages=[
        {
            "role": "user",
            "content": "次の文章を、決定事項・未決事項・担当者に分けて要約してください。"
        }
    ],
)

print(message.content[0].text)

この例では、SDKがAPIキーと必要なヘッダーを処理します。モデルIDは更新時点の例です。実装時にはModels APIまたは公式モデル一覧で、利用できるIDを確認してください。

cURLで疎通を確認する

SDKを入れる前に、リクエストが通るかだけを確認したい場合はcURLも使えます。

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "こんにちは。1文で自己紹介してください。"}
    ]
  }'

認証エラーが出たら、キーの文字列、環境変数、対象ワークスペースを確認します。モデルエラーの場合は、モデルIDと提供状況を確認してください。

実務で使う前に追加する5つの設計

入力を制限する

利用者が何でも送れる状態にせず、対象ファイル、文字数、形式、入力してよい情報を決めます。個人情報や機密情報を扱う場合は、社内規程、契約、保存方針を確認します。

出力形式を固定する

後続システムが使うなら、文章ではなく構造化された形式で返す設計が必要です。必須項目、許容値、欠損時の扱いを決め、形式違反は再処理または人の確認へ回します。

エラーと再試行を設計する

レート制限、接続エラー、タイムアウトは起こる前提にします。失敗時に同じ処理を無制限に繰り返すと、重複実行や費用増加につながります。再試行回数、待機時間、中断条件を決めます。

費用と利用量を監視する

入力と出力のトークンだけでなく、再試行、キャッシュ、バッチ処理、外部ツールの利用も費用へ影響します。用途別にキーやワークスペースを分け、上限とアラートを設定します。

処理を即時に返す必要がなければ、Message Batches APIで非同期化できる場合があります。Anthropicは通常のMessages APIより費用を抑えられる仕組みとして案内しています。

人が確認する境界を決める

Claudeの結果をそのまま顧客へ送信したり、契約、採用、会計などの重要判断へ使ったりしないでください。APIは処理を自動化できますが、正しさを保証する仕組みではありません。

下準備はAI、最終判断は人を基本にし、確信度が低い、根拠がない、入力が矛盾する場合は自動処理を止めます。

よくある失敗

本番化の前に、実際の入力から代表例、失敗例、機密を除いたテスト例を作ります。品質、処理時間、人の修正時間、失敗率を記録し、どこまで自動化するかを決めます。

AIworkerが支援できること

AIネイティブX研修｜APIの前に業務を分解する

Claude Codeを使い、対象業務の入力、完成形、確認項目、停止条件を整理します。APIのコードだけを学ぶのではなく、どの工程ならAIへ任せられるかを実務題材で検証します。社内に判断できる人材を残したい企業に向いています。

AIネイティブX伴走｜試作を現場運用へつなげる

小さな検証を現場で回し、例外、差し戻し、人の確認工数を記録します。モデル変更や業務変更にも対応できるよう、評価例、手順、更新責任者を整えます。試作品はあるものの、利用が定着していない企業に向いています。

業務AIプロ｜既存システムへ安全に組み込む

認証、社内データ連携、MCP・API、権限、ログ、監視、例外処理を含めて業務特化AIを構築します。1部署・1業務から効果を確認し、運用保守まで含めて横展開できる基盤を設計します。

FAQ

Q. Claudeの有料プランに入ればAPIも使えますか？

Claude.aiの契約とAPI利用は別です。Claude ConsoleでAPIキーと請求設定を用意してください。

Q. APIキーに無料クレジットは付きますか？

常に付与されるとは限りません。登録時のConsole表示と最新の公式案内を確認してください。

Q. どのモデルから試せばよいですか？

一般的な業務処理はSonnetを基準にし、実際の入力で評価します。高難度処理はOpusやFable、単純な大量処理はHaikuも比較します。

Q. Claude CodeとAPIのどちらを選ぶべきですか？

担当者が対話しながら作業するならClaude Code、既存システムから同じ処理を繰り返すならAPIが候補です。最初はClaude Codeで業務を検証してからAPI化する方法もあります。

Q. APIの出力をそのまま顧客へ送ってよいですか？

おすすめしません。根拠確認、形式検証、禁止表現、個人情報、送信先を確認し、影響に応じて人の承認を置いてください。

最後まで読んでいただきありがとうございます。励みになりますので、参考になったらスキをお願いします。

▶️ サービス資料のダウンロード（資料請求）

▶️ 無料カウンセリング・AI活用診断のご予約

#ClaudeAPI #AnthropicAPI #Claude #Anthropic #生成AI #AI活用 #AI導入 #API #API連携 #Python #プログラミング #システム開発 #業務効率化 #業務改善 #業務自動化 #AIエージェント #ClaudeCode #ClaudeSkills #AgentSkills #MCP #法人AI #企業研修 #AI研修 #DX推進 #社内AI #セキュリティ #LLM #チャットボット #クラウド #デジタル変革

いいなと思ったら応援しよう！