Claude Codeの使い方｜ターミナルで動くAIエージェントの始め方

Claude Codeとはどんなツールか

Claude CodeはAnthropicが提供するターミナル型のAIエージェントだ。GUIのコードエディタに統合されたものではなく、ターミナルで直接動作する。

僕がこのツールを知った時、最初の感想は「ターミナルだけで本当に役に立つのか」というものだった。でも実際に使ってみると、その心配は杞憂だった。むしろプロジェクト全体を俯瞰できるため、コードベース全体の理解が深くなる。

プロジェクトディレクトリで claude と打つだけで、AIエージェントが動作を開始する。ファイル構造を自動で解析し、依存関係まで把握する。その上で、あなたの指示に応じてコードを書いたり修正したりする。

Anthropicが提供するモデルを使用しているため、最新のClaudeの能力を直接活用できる点も魅力だ。

CursorやWindsurfとの違いを比較表で理解する

CursorやWindsurfはGUIエディタなので、編集画面を見ながらAIに指示できる。一方Claude Codeはターミナル環境なので、ファイルシステム全体を把握しやすい。

インストール手順は本当に5分で終わる

node --version

npm install -g @anthropic-ai/claude-code

export ANTHROPIC_API_KEY='your-api-key'

claude

これだけだ。GUIエディタのようにインストーラーを何度もクリックする必要もない。npm一発でセットアップが完了する。

基本的な使い方とコマンド

Claude Codeを起動すると、対話形式でAIと会話できる。ターミナルに日本語で指示を入力するだけだ。

たとえば「このJavaScriptファイルをTypeScriptに書き換えて」と指示すれば、AIが自動でファイルを修正する。修正内容を確認した上で、確定するか却下するか選択できる。

主なコマンドは以下の通り。

• claude – AIエージェントを起動
• exit – セッションを終了
• git status – git操作も可能（Claude Codeが代行）
• test – テストの実行や生成

ターミナルに日本語で「このファイルをリファクタリングして、変数名をわかりやすくして」と指示すると、AIが自動で処理する。その様子をターミナルで確認できるのが、CursorなどのGUIエディタとの大きな違いだ。

Claude Codeが本当に得意なこと5つ

僕が実際に使って感じた、Claude Codeの強みを5つ紹介する。

1. 大規模リファクタリング。複数ファイルにまたがるコード修正が必要な場合、プロジェクト全体の依存関係を理解した上で対応できる。

2. テストコードの生成。既存のコードを解析して、自動でユニットテストを作成してくれる。テストカバレッジも考慮される。

3. コードレビュー。セキュリティ脆弱性やパフォーマンス問題を指摘してくれる。修正提案も出してくれる。

4. Git操作の自動化。修正内容に応じて、自動でコミットメッセージを生成し、git操作を代行できる。

5. ドキュメント生成。コードから自動でREADMEやAPIドキュメントを作成できる。

料金体系を理解する

Claude CodeはAnthropic APIの使用量に応じた課金体系だ。CursorやWindsurfのようなサブスクリプション制ではない。

つまり、使った分だけ払う。月に少ししか使わないなら、月々数百円で済む。毎日バリバリ使っても、月に数千円程度だ。

料金の詳細は以下の通り。

• 入力トークン：$0.003 / 1000トークン
• 出力トークン：$0.015 / 1000トークン
• 月額最低料金：なし
• クレジットカード登録：必須

Anthropicアカウントを作成して、APIキーを取得すれば使用開始できる。無料トライアルもあるため、まずは試してみるのがいい。

僕がWordPressテーマ開発で実際に使った体験

僕がClaude Codeを活用したのは、WordPressテーマの大規模リファクタリング時だった。既存テーマのCSS・JavaScriptを最新の標準に合わせる必要があったのだ。

複数のPHPファイル、JavaScriptファイル、CSSファイルが相互に依存していて、手作業での修正は非常に危険だった。そこでClaude Codeに「このテーマのJavaScriptを最新のES2020標準に統一して、互換性も確保して」と指示した。

AIが自動でコードベース全体を解析し、修正箇所を特定した。ファイルごとの差分を確認でき、おかしな修正は途中で止められる。このプロセスにより、手作業では見落とすバグも事前に防ぐことができた。

修正後、自動生成されたテストコードも役に立った。ブラウザでのビジュアルテストは僕が行い、ロジック部分のテストはAIが行う。こうした役割分担が実現できたのだ。

最終的に、本来なら1週間かかる作業が3日で完了した。品質も高かった。

CursorとClaude Codeの併用が最強

ここまで読むと「Claude CodeとCursor、どちらを選ぶべきか」という質問が出るかもしれない。その答えは「両方使い分ける」だ。

Cursorはコード編集中にAIの提案を受けたい時に最適だ。エディタの画面を見ながら、AIに「この部分をこう修正して」と指示できる。GUIなので直感的だ。

一方Claude Codeは、大規模な変更や全体的な構造把握が必要な時に活躍する。ターミナル環境だからこそ、ファイルシステム全体を俯瞰できるのだ。

僕の現在の開発フローは以下の通り。

朝、プロジェクト全体の構造確認はClaude Codeで行う。その後、具体的なコード編集はCursorで進める。リファクタリングが必要になったら、再びClaude Codeに切り替える。このようにツールを使い分けることで、両者の強みを最大限引き出せる。

決して「どちらか一方」ではなく「シーンに応じた使い分け」が重要だ。