Claude API のはじめての呼び出し｜コードは Claude Code に書いてもらう

準備：キーとクレジット

はじめる前に、Claude Console のアカウントと APIキー（レッスン2）、使えるクレジット（レッスン3）を用意します。月の上限（支出上限）も先に決めておきましょう。

この講座では、コードは Claude Code に書いてもらいます。Claude Code には、Claude API のためのスキル（/claude-api）がはじめから入っていて、公式の資料を読みこんでくれます。依頼文を送る前に /claude-api と打っておくと確実です。

このレッスンでは、公式の Get started に合わせて Python で試します。公式の Python の SDK は Python 3.10 以上が必要です。レッスン7からは、サイトと同じ JavaScript で書いてもらうので、Python を覚える必要はありません。

分ける理由があります。Claude Code を起動するターミナルに ANTHROPIC_API_KEY が入っていて、その利用を承認すると、Claude Code 自体がプランではなく API の料金で動くようになります。

Claude Code にコードを書いてもらう

新しいフォルダ claude-quickstart を作って、そこで Claude Code を起動し、/claude-api と打ってから、下の「やってみよう」の依頼文を送ります。ポイントは、キーをコードに書かないことと、キーを聞かないでと伝えることです。

別のターミナルで動かす

もう1つターミナルのウィンドウを開いて、同じフォルダに cd で移動します。ここで、キーを環境変数に入れます。Mac なら、公式の「Claudeを使い始める」と同じ形の1行です（your-api-key-here を自分のキーに置きかえます）。Windows では書き方がちがうので、Claude Code（ターミナル A）に「Windows で、このターミナルにだけ ANTHROPIC_API_KEY を入れるコマンドを教えて。キーの値は聞かないで」と聞いてください。

準備のコマンドでは「仮想環境」を作ります。このフォルダ専用に道具（anthropic など）を入れておく箱のようなものです。仮想環境を有効にしたのと同じターミナル B で python quickstart.py を打ちます。

うまくいかないときは、エラーの文をそのまま Claude Code（ターミナル A）に貼って相談します。ただし、キーが映っている部分は消してから貼りましょう。

playground で試す

コードを書く前に、Console の playground（platform.claude.com/playground）で、頼み方や答えを画面で試すこともできます。モデルや設定を変えて「Run」を押すだけです。試した内容は、「code」の切りかえで、そのままコードとして書き出せます。

やってみよう

1. ターミナルで新しいフォルダ claude-quickstart を作って移動し、claude を起動します（このターミナルには APIキーを入れません）
2. Python 3.10 以上が入っているか、Claude Code に python3 --version で確かめてもらいます（古ければ、入れ方も聞きます）
3. /claude-api と打って Claude API のスキルを読みこんでから、下の依頼文を送って、quickstart.py と準備のコマンドを作ってもらいます
4. もう1つ別のターミナルのウィンドウを開いて同じフォルダに移動し、下の1行の your-api-key-here を自分のキーに置きかえて打ちます（Mac の場合。Windows の書き方は Claude Code に聞きます）
5. その別のターミナルで、Claude Code が教えてくれた準備のコマンド（仮想環境と anthropic のインストール）を打ち、同じターミナルで最後に python quickstart.py を打ちます
6. 答えと usage が出たら成功です。Console の Usage のページで、記録が増えたことも確かめます

確認問題