Claude_Code_API入門うさうさ

Claude Code・Claude API 入門 ターミナルで使うAIの開発ツールと、アプリから呼ぶAPI ― 初心者のための徹底解説 公式参考：日本語・英語を併記 ／ 講師：うさうさ先生 ／ 確認日：2026/10/24 うさうさ研修工房

この講座で学ぶこと 3つの製品の違いから、最初の一歩まで 1 3つの製品の違い 2 Claude Code とは 3 Claude API とは 4 Claude Code の導入 5 APIキーと最初の呼び出 し 6 レスポンスの読み方 7 つまずきと安全 8 公式参考と確認 対象：プログラミングの基本（変数、関数）が分かる方。ターミナルを開いたことがあると進めやすい Claude Code・Claude API 入門 2

まず、3つの製品を区別する Claude.ai・Claude Code・Claude API は別の製品です Claude.ai Claude Code Claude API ブラウザで会話する （チャット画面） ターミナルで使う コーディングエージェント プログラムから呼ぶ （HTTPのインターフェース） 文章作成、質問、要約 プロジェクトを読み、編集し、コマンド を実行 アプリやシステムへの組み込み Claude Code の利用には、無料のClaude.aiプランは含まれていません（公式インストールガイドの記載）。 Claude Code・Claude API 入門 3

Claude Code とは 指示を受けて、読む・書く・実行する、ターミナルのコーディングツール 指示を出す 関連ファイルを読む 変更案を作る 許可を得て編集・実行 • プロジェクトのフォルダの中で動く（作業する場所を決めてから起動する） • 変更や実行の前に、確認を求める設定ができる（権限の仕組み） • 既定では Claude API を使って動く（公式の説明） 公式参考（英）：Claude Code overview ／（日）：日本語版がある場合は、公式サイトの言語切替で確認。 Claude Code・Claude API 入門 4 結果を確認する

Claude API とは アプリがHTTPでClaudeにメッセージを送り、返答を受け取る POST あなたのプログラム api.anthropic.com /v1/messages JSON の返答 • リクエストの中身：モデル名、メッセージ、最大トークン数 • 認証：x-api-key ヘッダーに APIキーを入れる • 料金：従量課金（使った分だけ。料金は公式で確認） 公式参考（英）：Messages API（platform.claude.com/docs/en/api/messages/create）／ 公式の Get started ガイド。 Claude Code・Claude API 入門 5 Claude（モデル）

Claude Code をインストールする 公式は「ネイティブインストーラー」を推奨 方法 内容 注意 ネイティブインストーラー（推奨） 公式の手順で導入。Node.js は不要 OSごとの手順は公式ページで確認 Homebrew（macOS） brew install --cask claude-code macOSの場合の例 npm（従来の方法） npm install -g @anthropic-ai/claude-code Node.js 18以上が必要。非推奨扱い Windows PowerShell / WSL2 から導入 ネイティブWindowsでは Git for Windows が必 要 claude --version claude doctor # 版の確認 # 導入状態の診断 公式参考（英）：code.claude.com/docs/en/getting-started/installation ／（日）：言語切替で確認。 Claude Code・Claude API 入門 6

APIキーを準備する キーは「パスワードと同じ」。コードに書かない ① コンソールで キーを作成 ② 環境変数に設定 export ANTHROPIC_API_KEY="ここに自分のキー " ③ プログラムが読む # macOS / Linux（一時的な設定） 注意：キーを、コード・チャット・画面共有・Gitに入れない。漏えいしたら、すぐに無効化して作り直す。 公式参考（英）：Get started（platform.claude.com/docs/en/get-started）。SDK は ANTHROPIC_API_KEY を自動で読みます。 Claude Code・Claude API 入門 7

最初のAPI呼び出し（curl）
まずは、HTTPの形を目で確かめる

curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-haiku-5-5",
"max_tokens": 200,
"messages": [{"role": "user", "content": "Pythonとは何か、一文で教えて"}]
}'

•

x-api-key：認証（キーを入れる）

•

anthropic-version：API の版を指定する（公式の例に合わせる）

•

model：使うモデル名。利用可能なモデル名は公式の一覧で確認

公式参考（英）：Messages API リファレンス・Models 一覧。モデル名は版の更新で変わるため、必ず確認。
Claude Code・Claude API 入門 8

Python SDK で呼ぶ
SDKを使うと、ヘッダーの組み立てを任せられる

import anthropic
client = anthropic.Anthropic()

手順
# ANTHROPIC_API_KEY を自動で読む

message = client.messages.create(
model="claude-haiku-5-5",
max_tokens=1000,
messages=[
{"role": "user", "content": "Pythonとは何か、一文で教えて"}
],
)
for block in message.content:
if block.type == "text":
print(block.text)

公式参考（英）：Get started（Python タブ）。日本語の説明は言語切替で確認。
Claude Code・Claude API 入門 9

•

pip install anthropic

•

APIキーを環境変数に設定

•

python quickstart.py で実行

レスポンスの読み方 返答は「content」という配列（ブロックの並び） { "id": "msg_...", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "Pythonは…" } ], "stop_reason": "end_turn", "usage": { ... } } ポイント：取り出すときは、type が text のブロックだけを読む 公式参考（英）：Messages API リファレンス（Response）。項目名は版で追加されることがある。 Claude Code・Claude API 入門 10 content 返答の本文（ブロックの配列） type: text 文字の返答のブロック stop_reason なぜ止まったか（例：end_turn） usage 使ったトークン数（料金の目安）

Claude Code を最初に動かす 作業するフォルダに移動してから起動する mkdir my-first-project && cd my-first-project claude # 起動（初回はログイン案内が出ることがある） claude doctor # 導入と設定の診断 • まずは小さな依頼：「README.md を作って、このフォルダの説明を書いて」 • 依頼の後、変更内容を読んでから許可する（内容を理解せずに承認しない） • 困ったら claude doctor の結果を見る 公式参考（英）：Claude Code quickstart（code.claude.com/docs/en/quickstart）。画面や操作は版で変わることがある。 Claude Code・Claude API 入門 11

料金と安全の考え方 費用と、権限の境界を先に決める 料金（API） 安全（Claude Code） • 従量課金：入力と出力のトークン数で決まる • 変更や実行の許可を、内容を見て判断する • 料金表は公式サイトで最新を確認 • 信頼できないフォルダで使わない • 試すときは max_tokens を小さくする • 秘密情報（キーや.env）を読ませない設定を検討する 結論：キーと権限は、最初に決めておく。あとから直すより、ずっと楽。 公式参考（英）：Pricing（claude.com/pricing）／ Claude Code の権限とセキュリティ（code.claude.com/docs/en/security）。 Claude Code・Claude API 入門 12

よくあるつまずき 症状から原因を探す 症状 よくある原因 対処 claude: command not found インストール後にターミナルを開き直していない ターミナルを再起動し、claude --version 401 / 認証エラー キーが空、前後に空白、別のキー キーを再発行し、環境変数を設定し直す model not found 系のエラー モデル名が古い、綴りが違う 公式のモデル一覧でモデル名を確認 Claude Code が起動しない 導入が不完全、ログインの未完了 claude doctor で診断 npm の権限エラー グローバルの権限が足りない ネイティブインストーラーに切り替える 公式参考（英）：Troubleshooting（code.claude.com/docs/en/troubleshooting）／ API のエラー（platform.claude.com/docs/en/api/errors）。 Claude Code・Claude API 入門 13

公式参考（日本語・英語） 迷ったら、まず公式で確認する 分類 英語（作成時点のURL） 日本語 使いどころ Claude Code 概要 code.claude.com/docs/en/overview 言語切替で確認 何ができるか Claude Code 導入 code.claude.com/docs/en/getting-started/installation 言語切替で確認 インストール・診断 Claude Code 安全 code.claude.com/docs/en/security 言語切替で確認 権限・データの扱い Claude API 入門 platform.claude.com/docs/en/get-started 言語切替で確認 最初のAPI呼び出し Messages API platform.claude.com/docs/en/api/messages/create 言語切替で確認 リクエスト・レスポンスの仕様 料金 claude.com/pricing 言語切替で確認 費用の確認 ※ 確認済みは Claude Code 導入（code.claude.com）と Claude API 入門（platform.claude.com）の2件。他のURLは公式の目次ページで必ず確認してください。日本語版の有無 も言語切替で確認。 Claude Code・Claude API 入門 14

学習ロードマップ 一段ずつ、動くことを確かめてから進む インストール claude --version Claude Code を起動 小さな依頼 APIキーを設定 curl で呼ぶ 次の一歩：今日は、curl でレスポンスを一度見ることを目標にする Claude Code・Claude API 入門 15 SDK で呼ぶ 返答を読む 小さなアプリを作る

確認問題 答えは次のスライド • Claude Code と Claude API の違いを一文で説明せよ • APIキーを、コードに直接書いてはいけない理由は？ • x-api-key ヘッダーの役割は？ • レスポンスの本文は、どのフィールドにあるか？ • 導入の状態を診断するコマンドは？ Claude Code・Claude API 入門 16

確認問題の解答例 • Claude Code は、ターミナルでプロジェクトを読み・編集し・コマンドを実行するツール。API は、プログラムから HTTPでClaudeを呼ぶインターフェース • キーが漏えいすると、第三者に使われ費用が発生するおそれがあるため（環境変数で渡す） • 認証のためのAPIキーを渡す（認証） • content（ブロックの配列）の中の type が text のブロック • claude doctor Claude Code・Claude API 入門 17

まとめ • Claude.ai（チャット）、Claude Code（ターミナルのツール）、Claude API（HTTPの入口）は別の製品 • Claude Code は、作業フォルダで起動し、変更を確認して許可する • APIキーは環境変数で渡し、コードや共有の場に出さない • レスポンスは content の配列。text のブロックを読む • 困った時は、公式のドキュメント（英語・日本語）で確認する Claude Code・Claude API 入門 18