読み込み中

Claude Codeで構築する

レッスン 135 分
読み込み中

Claude Codeで構築する

Claude APIを呼び出すコードを手で書くのも問題ありませんが、さらに速い方法があります。それは、Claudeに書かせることです。このレッスンでは、Claude Codeを使って、スタブ化されたファイルからAPI統合を埋めていきます——このコース全体を通して学んできたのと同じプリミティブを使います。

スタブから始める

プロジェクトはシンプルです。天気を取得するTypeScriptファイルで、2つのスタブが含まれています。

  • getWeather — 都市を受け取り、気温と天候を返します。
  • run — ツールランナーとClaude TypeScript SDKを使用するはずの関数です。

ツールランナーは、ツール呼び出しとエージェントループを処理してくれる部分なので、それを手動で配線する必要はありません。

Claude API スキル

Claude CodeにはClaude APIという組み込みスキルが付属しています。/claude-apiで直接呼び出すこともできますし、TypeScript SDKを使用していることを検知すると、Claude Codeが自動的に呼び出します。

1つのプロンプトで動くコードに

ターミナルでプロジェクトフォルダを開き、Claude Codeを起動します。

そこから先は、1つのプロンプトで済みます。良いプロンプトは次の3つを行います。

  • 変更したいファイルを指定する。
  • 使いたいパターンを指定する。
  • 期待する最終状態を指定する。

すると、Claude Codeは型に沿ってgetWeatherとrunを埋め、ファイルの末尾に呼び出しを追加し、スクリプトを実行して、出力を報告します。何かエラーが発生した場合は、エラーメッセージを読み取り、その場でコードを修正します。

プロンプトを受け取った後、ターミナルでweather.tsとツールランナーファイルを読み込むClaude Code

Claude Codeが生成したもの

この実行では、Claude Codeは入力を解析し、都市の型に基づいて出力を返すZodツールを作成しました。また、私たちが求めていたツールランナーとrun関数も作成し、エージェントループの最終結果を出力しました。

ターミナルで天気コードを生成するClaude Code。betaZodToolのインポートとハードコードされた都市データが見える

覚えておくべきパターン

Claude APIに対して書くもののほとんどは、見慣れた形をしています。

  1. ツールを定義する。
  2. それをランナーに渡す。
  3. 結果を返す。

毎回これを記憶から書き起こす必要はありません。代わりに、ファイルをスタブ化し、それをClaude Codeに渡して、差分をレビューするだけです。

まとめ

  • Claude Codeは、ターミナル内でファイルを編集しコマンドを実行するエージェントです。
  • 組み込みのClaude APIスキルは、Claude CodeがTypeScript SDKを検知すると自動的に読み込まれます。または/claude-apiで呼び出すこともできます。
  • ファイル、パターン、最終状態を指定したプロンプトを与えれば、コードを書き、実行し、その場でエラーを修正してくれます。
  • Claude APIのコードは見慣れた形に従います。ツールを定義し、ランナーに渡し、結果を返す。スタブ化し、委任し、差分をレビューする。