Claude Codeの使い方｜ターミナルで動くAIコーディングアシスタント入門

「AIにコードを書いてもらいたいけど、CursorやCopilotはエディタの設定が面倒そう」
「ターミナル（コマンドライン）で直接AIと対話しながら開発できるツールがあると聞いたけど、どうやって始めればいいのか」

そんな方に知ってほしいのが、Anthropicが開発した「Claude Code」です。ターミナル上で動くAIコーディングアシスタントで、エディタを選ばず、プロジェクトフォルダの中でAIに直接指示を出せるのが特徴です。

この記事では、Claude Codeのインストールから基本的な使い方、実務での活用例までを、2026年4月時点の情報にもとづいて解説します。GitHub CopilotやCursorとの違いも整理しているので、「自分に合うAI開発ツールはどれか」を判断する材料にしてください。

Claude Codeとは？ターミナルで動くAIアシスタント

Claude Codeは、Anthropicが提供するCLI（コマンドラインインターフェース）ベースのAIコーディングアシスタントです。ターミナル上でAIと対話しながら、コードの生成・修正・ファイル操作・Git操作まで一貫して行えます。

CursorやGitHub Copilotが「エディタの中にAIが組み込まれている」のに対し、Claude Codeは「ターミナルそのものがAIの作業場」になるイメージです。VS CodeでもVimでもEmacsでも、好きなエディタと組み合わせて使えます。

・ターミナル完結: エディタ不要。プロジェクトフォルダで起動すればすぐ使える
・ファイル操作: コードの生成だけでなく、ファイルの作成・編集・削除もAIが実行
・Git操作: コミット・diff確認・ブランチ操作もAIに任せられる
・プロジェクト理解: フォルダ内のファイル構成を読み取り、文脈を踏まえたコード生成が可能

主要なAIコーディングツールとの違いを整理すると、以下の通りです。

Claude Codeが特に向いているのは、「ターミナル作業が中心の人」「既存のエディタを変えたくない人」「ファイル操作やGitまで一括でAIに任せたい人」です。逆に、GUIでの対話型UIを好む方はCursorの方が使いやすいかもしれません。

Claude Codeの始め方（ステップバイステップ）

1. 前提条件を確認する

Claude Codeを使うには、以下が必要です。

・Node.js 18以上: インストール済みでない場合は公式サイトからダウンロード
・Anthropicのアカウント: Claude Pro、Max、またはTeamプランのいずれかに加入していること
・対応OS: macOS、Linux（WindowsはWSL2経由で利用可能）

Linux環境の構築方法については、姉妹サイトリナックスマスター.JPで詳しく解説しています。

2. Claude Codeをインストールする

ターミナルを開いて、以下のコマンドを実行します。

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

インストールが完了したら、バージョンを確認しておきましょう。

claude --version

バージョン番号が表示されればインストール成功です。

3. 認証してプロジェクトで起動する

作業したいプロジェクトフォルダに移動して、claudeコマンドを実行します。

cd ~/my-project
claude

初回起動時にブラウザが開き、Anthropicアカウントでの認証を求められます。ログインすると認証が完了し、ターミナル上でAIとの対話が始まります。

起動すると、Claude Codeはプロジェクトフォルダ内のファイル構成を読み取ります。CLAUDE.md（プロジェクト固有の指示ファイル）を配置しておくと、AIがプロジェクトの文脈を理解した上で応答してくれます。

4. 最初の指示を出してみる

起動したら、日本語で指示を出してみましょう。以下のプロンプトをそのまま入力してみてください。

このプロジェクトのフォルダ構成を確認して、READMEファイルを作成してください。
プロジェクト名、主な機能、セットアップ手順を含めてください。

Claude Codeはフォルダ内のファイルを読み取り、内容を踏まえたREADMEを自動生成します。ファイルの作成前に「この内容で作成してよいか？」と確認してくれるので、意図と違う場合は修正指示を出せます。

実務での活用例（Before/After）

【活用例1】バグ修正の時間を大幅短縮

Before: エラーログを読み、該当ファイルを探し、原因を特定して修正。慣れていないコードベースだと1件のバグに2〜3時間かかることも。

After: エラーメッセージをClaude Codeに貼り付けて「このエラーの原因を調べて修正して」と指示。AIがファイルを横断的に調査し、修正案を提示。確認後に適用するだけ。

# Claude Codeへの指示例
以下のエラーが本番環境で発生しています。原因を特定して修正してください。

TypeError: Cannot read properties of undefined (reading 'map')
  at UserList (src/components/UserList.jsx:15:23)

Claude Codeは該当ファイルを開き、データが未定義の場合の処理が抜けていることを特定し、修正コードを提案してくれます。

【活用例2】テストコードの自動生成

Before: テストコードを手で書くのが面倒で、テストが不十分なまま本番リリース。後から不具合が見つかり手戻りが発生。

After: Claude Codeに「この関数のテストコードを書いて」と指示するだけで、正常系・異常系を含むテストファイルを自動生成。

# Claude Codeへの指示例
src/utils/validate.js のすべての関数に対して、
Jestのテストコードを作成してください。
正常系、異常系、境界値のテストケースを含めてください。

【活用例3】既存コードのリファクタリング

Before: 引き継いだコードが読みにくく、手を入れるのが怖い。構造を整理したいが、どこから手を付ければいいか分からない。

After: Claude Codeにプロジェクト全体を読ませた上で「この関数を小さな関数に分割して、コメントも追加して」と指示。AIがコードの意味を理解した上でリファクタリングを実行。

# Claude Codeへの指示例
src/api/handler.js の processOrder 関数が200行を超えていて読みにくいです。
以下の方針でリファクタリングしてください。

- 1関数あたり30行以内に分割
- 各関数にJSDocコメントを追加
- 既存のテストが通ることを確認

うまくいかない時の対処法

1. AIの応答が的外れな場合

プロジェクトの規模が大きい場合、AIが関係ないファイルを参照してしまうことがあります。対処法は2つです。

・対象ファイルを明示する: 「src/components/Header.jsx を修正して」のように、ファイルパスを具体的に指定する
・CLAUDE.mdを活用する: プロジェクトのルートにCLAUDE.mdを作成し、プロジェクトの構成や規約を記述しておく。Claude Codeは起動時にこのファイルを自動で読み込む

2. ファイルの変更が意図と違う場合

Claude Codeはファイルを変更する前に確認を求めてきます。もし意図と違う変更が提案された場合は、「いいえ」と答えて修正指示を追加してください。

変更を承認した後に元に戻したい場合は、Gitを使っていればgit diffで差分を確認し、git checkoutで戻せます。Claude Code自体にも「直前の変更を元に戻して」と指示できます。

3. Claude Codeの限界を知っておく

AIコーディングツール全般に言えることですが、以下の点には注意が必要です。

・100%正しいコードが出る保証はない: 特にビジネスロジックが複雑な処理は、必ず動作確認・テストを行ってください
・機密情報の取り扱い: Claude Codeはコードの内容をAnthropicのサーバーに送信します。社内の機密コードを扱う場合は、利用規約とセキュリティポリシーを確認してください
・大規模プロジェクトでのコンテキスト制限: ファイル数が非常に多いプロジェクトでは、AIが参照できる範囲に限りがあります。対象を絞った指示が効果的です

AIツールのセキュリティリスクについては、姉妹サイトセキュリティマスターズ.TOKYOで詳しく解説しています。

本記事のまとめ

Claude Codeは、ターミナル上でAIと対話しながらコーディングができるCLIツールです。エディタを選ばず、ファイル操作やGit操作まで一括でAIに任せられるため、ターミナル作業が多い方には特に相性の良いツールです。

まずは小さなプロジェクトで試してみるのがおすすめです。「このファイルを修正して」「テストを書いて」といった一言の指示から始めて、慣れてきたら複雑なタスクをAIに任せる範囲を広げていってください。