実践的な開発者ガイド
開発者がClaudeを使う方法:Claude Code、API、エージェントワークフロー
ターミナルが新しいIDEになった今も、信頼の単位はいまだにdiffだ。
開発者はAnthropicのClaudeを3つの異なる方法で使っている。計画やレビューのためのチャット相手として、ターミナルで直接動くClaude Codeとして、そして自社のAPIを使ったプロダクトを支えるモデルとして。このページでは、それぞれのモードで開発者がClaudeを使う方法を、コードレビューやテスト作成、ツール使用の実際のプロンプトとともに解説し、さらにAIが書いたコードを本番に出す前に安全に保つ習慣も紹介する。
開発者がClaudeを使う方法は、3つの場面に集約される。計画やコードレビューのためのClaude AIチャット画面、リポジトリを読み取ってファイルを直接編集する、ターミナルネイティブなエージェント型開発のためのClaude Code、そして自社プロダクトにツール使用やエージェントワークフローを組み込むためのAnthropic APIだ。多くの開発者はまずチャットから始め、繰り返しの編集やテストをClaude Codeに移し、Claudeを使った機能を実際にリリースする段になってAPIに手を伸ばす。AIが書いたコードを安全に保つ習慣は、どんなコードを安全に保つ習慣とも同じだ。小さなdiff、テスト、そしてマージ前のレビュー。
公開日 · 最終確認日
無料レッスン · アカウント不要Claudeを使う3つの方法3つのモード5 分無料レッスンを始める要点まとめ
- 開発者がClaudeを使う場面は3つに分かれる。計画とコードレビューのためのチャット、ターミナル作業のためのClaude Code、そして独自のツール使用やエージェント機能を構築するためのAnthropic APIだ。
- Claude Codeはリポジトリを読み取り、コードベース全体のファイルを編集し、テストスイートを実行し、変更をコミットすることまで、ふつうのターミナルセッションの中だけで行える。
- ツール使用を使うと、Claudeは自分で定義した関数を呼び出せるようになり、リクエストに答える過程でデータベースに問い合わせたり、内部APIを呼んだり、スクリプトを実行したりできる。
- コードレビューは、曖昧な「このコードを見て」ではなく、具体的なdiffと確認してほしい具体的な基準をClaudeに示したときに最もうまくいく。
- Claudeはテストを書いて実行できるが、生成されたコードを安全に保つ習慣は、どの貢献者のコードを安全に保つ習慣とも同じだ。小さなdiff、通過するテストスイート、そしてマージ前の人間によるレビュー。
- まずCLAUDE.mdファイルから始めよう。これは、技術スタックやコマンド、規約をClaudeに伝える短いプロジェクトの背骨のようなもので、Claudeが推測で動くのを止めてくれる。
Claude AI と Claude Code と Anthropic API の比較
| 場面 | 最適な用途 | 動く場所 |
|---|---|---|
| Claude AI (chat) | 計画立案、アーキテクチャの議論、貼り付けたdiffやスタックトレースのレビュー | ブラウザまたはデスクトップアプリ |
| Claude Code | 複数ファイルの編集、テストスイートの実行、実際のリポジトリ上での自律的な作業 | プロジェクトディレクトリ内のターミナル |
| Anthropic API | ツール使用を伴う、Claudeを使った機能やエージェントを自社プロダクトに組み込む | HTTPS経由で呼び出される自社のアプリケーションコード |
コピーして使える
今日から使えるプロンプト
特定の基準に沿ってプルリクエストのdiffをレビューする
あなたはPython FastAPIサービスのプルリクエストのdiffをレビューしています。SQLインジェクションのリスク、リクエストボディの入力検証漏れ、パラメータ化されていないデータベースクエリを特に確認してください。問題ごとにファイル名と行番号を挙げ、なぜ問題なのかを説明し、修正方法を提案してください。フォーマットやスタイルについてはコメントしないでください。
言語やフレームワーク、指摘してほしい具体的なリスクは、自分のスタックに合わせて入れ替えてください。
既存のスタイルに合わせたテストを書く
tests/test_orders.py内の既存のテストを見て、その構成、フィクスチャ、命名規則にそのまま合わせてください。orders/service.py内の新しいrefund_order関数に対するユニットテストを書いてください。正常に返金できるケース、すでに返金済みの注文への返金試行、元の課金額を超える返金の3つをカバーしてください。pytestと既存のモックパターンを使ってください。
pytest、Jest、Vitestなど、実際に使っているテストファイルとフレームワークを指定してください。
文脈をすべて渡してflakyなテストをデバッグする
このテストはCIでは断続的に失敗しますが、ローカルでは通ります:[テスト名とエラーを貼り付け]。こちらがテストファイル、対象の関数、直近3回のCI失敗ログです。修正を提案する前に、不安定になりうる原因を順に検討してください。そして、まだ確信が持てない点を明示的に教えてください。
バグを記憶だけで説明するのではなく、実際のログやファイルの内容を貼り付けてください。
Anthropic APIのツール使用関数を設計する
Anthropic APIを使って、社内のREST APIから顧客の注文状況を調べるエージェントを作っています。入力パラメータのJSONスキーマを含むツール定義の草案を作成し、結果として返されるtool_useブロックを処理してtool_resultをClaudeに送り返すPythonコードを見せてください。
内部APIとパラメータは、自分のサービスの仕様に合わせて置き換えてください。
新しいプロジェクト用のCLAUDE.mdを作成する
このリポジトリのpackage.json、README、フォルダ構成を読み込んでください。そのうえで、技術スタック、テストと開発サーバーを動かすコマンド、APIルートの命名規則、そして新しく参加するメンバーが最初の変更を加える前に知っておくべきことをまとめたCLAUDE.mdファイルの草案を作成してください。
プロジェクトの最初に一度実行し、規約が変わるたびに更新してください。
コードに触れる前に複数ファイルにわたるリファクタリングを計画する
現在3つのコントローラーに分散している決済ロジックを、単一のPaymentServiceクラスに抽出したいと考えています。コードを書く前に、現在決済ロジックを含んでいるすべてのファイルを列挙し、新しいクラスのpublicメソッドを提案し、リファクタリングで維持すべき3つの現行実装間の動作の違いを指摘してください。
2つか3つ以上のファイルに影響する変更では、まず計画を求めてください。
ここから始める
すべての開発者が最初に受けるべき無料レッスン
3つの短いレッスンで、Claudeの存在を知っている状態から、プロジェクトの背骨を用意した実際のClaude Codeセッションを動かせる状態まで進める。その日のうちに実務で使い始められるだけの内容だ。
3つの場面
開発者は実際にどうClaudeを使っているか
開発者にとってのClaudeは、ひとつの道具ではない。3つあり、目の前のタスクにどれが合うかを見極めることこそが、スキルの大半を占める。
Claude AIチャット
アーキテクチャの議論、貼り付けたdiffやエラーメッセージのレビュー、そしてコードを書き始める前に設計を考え抜くのに向いている。
Claude Code
リポジトリを読み取り、コードベース全体のファイルを編集し、テストスイートを実行し、指示があれば変更をコミットできる、ターミナルネイティブなエージェント。
Anthropic API
モデルとツール使用を組み合わせ、Claudeを自社プロダクトに組み込むための仕組み。データベースに問い合わせるサポートボット、IDE内のアシスタント、無人で動くパイプラインなどに使える。
エージェントワークフロー
ツール使用をループと組み合わせる。Claudeがどのツールを呼ぶか決め、結果を読み取り、次の手を決める。これをタスクが終わるまで繰り返す。
Claude Code
Claude Codeとは何か、どう使い始めればいいか
Claude Codeは、コードベースの中で直接Claudeと作業するための、Anthropicのコマンドラインツールだ。コードをチャット画面にコピーして答えを貼り返すのではなく、プロジェクトディレクトリから実行すると、依頼した内容の文脈として、ファイルやgitの履歴、テストの構成を読み取ってくれる。
典型的なセッションはこうなる。リポジトリでターミナルを開き、Claude Codeを起動し、POSTエンドポイントにレート制限を追加するといったタスクを平易な言葉で説明する。すると関連ファイルを読み取り、変更が及ぶファイル数にかかわらず編集を提案して適用し、テストスイートを実行し、何を変更したか、テストが通ったかを報告してくれる。
Claude Codeがエディタのプラグインと違うのは、次の1行だけでなく、タスク全体を扱える点だ。複数ステップの変更を計画し、各ステップを実行し、テストが失敗したことに気づき、修正を試す、これらすべてをあなたからの1つの指示の中で行える。あなたは、実行前に計画を読み、コミット前にdiffをレビューすることで、プロセスに関わり続ける。
最初に用意する価値があるのは、プロジェクトのルートに置くCLAUDE.mdファイルだ。これは、技術スタック、ビルドやテストのコマンド、命名規則、そして新しいメンバーが初日に必要とするその他の情報を、平易な言葉で短くまとめたファイルだ。これがあれば、Claude Codeは推測する代わりに、毎回のセッションの開始時に自動でこれを読み込む。
実際の作業
開発者が今週実際に使っているワークフロー
セキュリティに絞ったコードレビュー
一般的なレビューを依頼するのではなく、diffと特定のリスクの種類(認証バイパス、インジェクション、検証されていない入力など)をClaudeに示す。
テストの作成と実行
Claudeは既存のテストパターンとフレームワークを読み取り、スタイルに合わせたテストを書いて実行し、失敗があれば修正を重ねる。
複数ファイルにまたがるリファクタリング
2、3ファイル以上に影響する変更では、まず計画を求める。どのファイルが変わるのか、新しい構成はどうなるのか、変えてはいけない動作は何か。
再現しにくいバグのデバッグ
失敗しているテスト、対象の関数、実際の失敗ログを渡し、修正を提案する前に原因を順に検討させる。
未知のコードベースで見通しを立てる
リクエストがコードベースの中をどう流れるかをたどって説明するようClaudeに頼む。コードをいちから読むより、たいてい速い。
Anthropic API
ツール使用、エージェント、そしてAnthropic APIでの開発
Anthropic APIは、チャット画面を通してClaudeを使う代わりに、自社プロダクトの中にClaudeを組み込む手段だ。プロンプトを添えてリクエストを送り、レスポンスを受け取る。これはどのHTTP APIとも同じ形であり、Pythonのサービスでも、Nodeのアプリでも、それ以外の何であっても、すでに動いているバックエンドのスタックにそのまま収まる。
ツール使用は、単発のリクエストとレスポンスのやり取りを、エージェントに近いものへと変える機能だ。Claudeが使えるツールを、名前、説明、入力のJSONスキーマを持つ関数として記述する。例えば、注文IDを受け取るlookup_order関数などだ。Claudeが質問に答えるためにそのツールが必要だと判断すると、普通の答えの代わりにtool_useブロックを返す。自分のコードが、データベースへの問い合わせであれAPI呼び出しであれスクリプトであれ、システムにとっての実際の意味に応じて関数呼び出しを実行し、結果をtool_resultとしてClaudeに送り返す。Claudeはその結果を読み取り、処理を続ける。
実際的な意味でのエージェントとは、このループを1回より多く回しているだけのものだ。Claudeがツールを選び、あなたがそれを実行し、Claudeが結果を読み取って次のツールを選ぶ。これをタスクが終わるか、答えるのに十分な情報が得られるまで繰り返す。Model Context Protocolは、こうしたツールや接続を一貫した形で記述するための標準規格であり、プロジェクトごとにゼロから配線する代わりに、同じツール定義を異なるクライアント間で使い回せるようにする。
もうひとつ知っておく価値があるのがストリーミングだ。完全なレスポンスを待つ代わりに、APIはトークンが生成されるたびに送り返すことができ、これがチャット画面やリアルタイムのコード提案を、もたつかずに軽快に感じさせている。
安全に保つために
Claudeのコード変更を安全に保つ方法
ここに書かれていることはAI特有のものではない。どの貢献者のコードを安全に保つ規律とも同じものを、一貫して適用しているだけだ。
diffを小さく保つ
一度に1つの変更を頼む。5ファイルのdiffは10分でレビューできるが、50ファイルのdiffは形だけの承認になってしまい、まさにそこからバグがすり抜ける。
テストはマージの前に、後ではなく
同じタスクの一部として、Claudeにテストを書くか更新させる。そして、diffを完了とみなす前にテストが通ることを必須にする。
diffは自分で読む
Claudeは何を変更したか、なぜそうしたかを説明できるが、コードをコミットする人は、実際にそれを読んだという責任を依然として負っている。
プロンプトに秘密情報を貼り付けない
APIキー、認証情報、顧客データは、Slackのメッセージに書くべきでないのと同じように、チャットの履歴やClaude Codeのセッションにも入れるべきではない。
規約は一度教えておく
技術スタック、コマンド、スタイルガイドをまとめたCLAUDE.mdファイルがあれば、セッションの時間を食う行き来の修正が減る。
どこから始めるか
開発者のための最初のステップ
開発者としてClaudeを使うのが初めてなら、最も速い入り口は、順番に進める3つの短いレッスンだ。まずThe Three Modesコース内のThe Three Ways to Use Claudeから始めよう。これは、上で説明したチャット、Claude Code、APIという区別と同じ内容を示しているので、ターミナルを開く前にどの場面を使うべきかがわかる。
そこから、同じThe Three Modesコース内のClaude Code: Build With Wordsに進む。実際のClaude Codeのセッションがどのようなものかを順に見ていく。平易な言葉でタスクを説明し、リポジトリを読み取って編集が適用される様子を見て、出す前に結果をレビューする。
3番目の立ち寄り先は、The Practitioner Setupコースの CLAUDE.md: your project spineだ。ここでは、毎回のセッションでClaudeが技術スタックやコマンド、規約を推測し直すのを止めるファイルの書き方を学ぶ。これは、以降のすべてのセッションを速くする、ただひとつの習慣だ。
この3つを終えたら、The Practitioner Setupコースの残りの部分では、フックと自動化、MCPサーバーを通じてClaudeを技術スタックに接続すること、そして毎週のオペレーターワークフローの構築を扱う。これこそが、開発者としてClaudeを使う日々の習慣が本当に積み重なっていく部分だ。
限界
Claudeが間違えること、そして責任は依然としてあなたにあること
Claudeは、自信を持って間違えることがある。渡したテストには通るが、テストすることを思いつかなかったエッジケースを見落とした修正を提案することもあれば、存在しないライブラリ関数を使うこともある。その出力は、すでに決定されたものではなく、速くて博識な協力者による、質の高い初稿として扱おう。
生成されたコードには、人間が書いたコードと同じセキュリティレビューが必要であり、自分のコードベースでどこを間違えやすいかを見極められるようになるまでの、最初の数回はむしろ注意が必要とも言える。流暢にコードを書くツールから出てきたからといって、認証、決済、ユーザーデータに関わるものへのセキュリティ重視のチェックを省略してはいけない。
機密のソースコード、顧客データ、認証情報は、まず自社のポリシーを確認せずにいかなるAIツールにも入れるべきではない。データの取り扱いポリシーや顧客との機密保持の義務がある職場で働いているなら、レビュアーが人間ではなくモデルになったからといって、その義務が変わるわけではない。
最後に、自律性はダイヤルであって、スイッチではない。許可すれば、Claude Codeはテストを実行し、自分でコミットすることまでできる。しかし、プロフェッショナルな習慣は、共有ブランチや本番環境に到達する前に人間によるレビューの段階を置いておくことだ。これは、新しく入ったメンバーの最初の1か月のプルリクエストに望むのと同じ関門だ。
Claudeを使う3つの方法を解説する無料レッスンを始める
開発者がClaudeを使う方法について読むことと、実際に自分のターミナルでClaude Codeを動かすことは別物だ。Nightschool AIのカリキュラムは最初のレッスンから実践的で、このページで取り上げたチャットとClaude CodeとAPIの区別と同じところから始まる。
よくある質問
開発者はどのようにClaudeを使っているのか?
開発者は通常、3つの場面でClaudeを使う。計画立案、設計の議論、貼り付けたコードのレビューのためのClaude AIチャット画面、Claudeが実際のリポジトリを読み取って編集する、ターミナルネイティブな作業のためのClaude Code、そしてツール使用やエージェントループを含めて、Claudeを自社プロダクトに組み込むためのAnthropic APIだ。
Claude Codeとは何か、どう使い始めればいいか?
Claude Codeは、プロジェクトの中で直接Claudeを動かすコマンドラインツールだ。リポジトリのルートディレクトリから起動し、タスクを平易な言葉で説明する。すると、ファイルとCLAUDE.mdを読み取り、編集を行い、テストを実行し、結果を報告してくれる。先に技術スタックとコマンドを記したCLAUDE.mdファイルを用意しておくと、最初のセッションの精度が大きく上がる。
Claudeはコードレビューに向いているか?
向いている。特に、セキュリティ上の問題や入力検証の漏れ、チームの規約への準拠など、具体的なdiffと確認してほしい具体的な基準を与えたときに強い。曖昧な「このコードをレビューして」よりも、具体的な確認事項を頼んだときにはるかに力を発揮する。これは、明確な基準があるほど人間のレビュアーも良い仕事をするのと同じだ。
Anthropic APIはどう使えばいいか?
プロンプトを添えてHTTPリクエストを送り、テキストのレスポンスを受け取る。これはどのAPI呼び出しとも同じ形で、Python、Node、その他使っているどのバックエンドからでも呼び出せる。単発の一問一答より進んだものを作るには、ツール使用を加えて、Claudeが呼び出せる関数を与え、結果として生じるtool_useとtool_resultのやり取りを自分のコードで処理する。
Claudeのツール使用とは何か?
ツール使用を使うと、注文を調べたりデータベースに問い合わせたりといった、Claudeが呼び出せる関数を、名前と入力のJSONスキーマとともに記述できる。Claudeがツールが必要だと判断すると、普通の答えの代わりにtool_useリクエストを返す。自分のコードが実際の関数を実行して結果を送り返すことで、Claudeは処理を続けられる。これが、ほとんどのエージェントワークフローの基礎になっている。
Claudeは自分のコードのテストを書けるか?
書ける。pytest、Jest、Vitestなど、既存のテストパターンとフレームワークを読み取り、スタイルに合ったユニットテスト、結合テスト、エンドツーエンドテストを書ける。Claude Code内では、書いたテストを実際に実行し、失敗を繰り返し修正することもできる。テストだけ渡されて自分でデバッグする必要はない。
Claudeのコード変更をどう安全に保てばいいか?
どの貢献者にも求めるのと同じ規律を保とう。大がかりな変更の代わりに小さなdiffを求める、マージ前にテストが通ることを必須にする、コミット前にdiffを自分で読む、そしてプロンプトに秘密情報や顧客データを貼り付けないことだ。CLAUDE.mdファイルがあれば、Claudeが規約を推測することで起きるミスが減る。
Claudeはどのプログラミング言語に対応しているか?
Claudeは、Python、TypeScript、JavaScript、Go、Rust、Java、C/C++、Ruby、PHPをはじめとする主要な言語に幅広く対応しており、React、Next.js、Django、FastAPIといったツールの一般的なフレームワークのパターンも理解している。Claude Codeは、言語専用のプラグインではなくファイルやシェルコマンドを直接操作するため、ターミナルで動くどの言語でも使える。
Claude Codeのインストールは無料か?
Claude Code自体のインストールは無料だ。使用するには、トークン単位で課金されるAnthropic APIキー、またはClaude Codeへのアクセスを含むClaudeのサブスクリプションプランが必要になる。このコマンドラインツールに対して、それ以上の別のライセンス料はかからない。