Claude Codeとは何か
Claude Codeは、ターミナルから使えるAIコーディングアシスタントです。エディタの補完だけでなく、リポジトリ全体を読ませて理解させる、複数ファイルをまたいで修正する、テストやLintを実行する、Gitの差分を見ながら直す、といった開発フロー全体に入り込めるのが特徴です。
「1行ずつ補完してくれるAI」ではなく、開発タスクを会話で進めるCLIエージェントだと考えるとイメージしやすいでしょう。既存プロジェクトの保守、リファクタリング、バグ調査、テスト追加と特に相性が良いです。
インストールと初期セットアップ
2025年時点では、Claude CodeはAnthropicの提供するCLIとして利用します。細かな導入手順はOSや配布方法で変わることがありますが、基本の流れは共通です。
導入の基本手順
- Anthropicアカウントを用意する
- CLIをインストールする
- 認証を行う
- 作業したいGitリポジトリ直下で起動する
# 例：CLIのインストール（実際のコマンドは配布手順に従ってください）
claude --version
# 認証
claude login
# プロジェクトへ移動
cd my-app
# 対話開始
claudeまずは空のディレクトリではなく、package.json / pyproject.toml / go.mod などがあるプロジェクトルートで起動するのがコツです。Claudeが構成を把握しやすくなります。
最初に伝えるべきこと
起動したら、いきなり「直して」ではなく、最初に作業文脈を渡すと精度が上がります。
このリポジトリはNext.js + TypeScriptの社内ダッシュボードです。
認証はAuth.js、DBはPrisma、UIはshadcn/uiを使っています。
まず構成を把握し、主要なエントリポイントとデータ取得の流れを要約してください。
その後、変更前に確認すべき点を挙げてください。基本コマンドと使い方の流れ
Claude Codeの実用ポイントは、会話・ファイル操作・コマンド実行を一連の流れで扱えることです。CLIでは自然言語の指示が主役ですが、セッション管理や承認の考え方も押さえておくと使いやすくなります。
よく使う場面
- バグの再現手順を整理し、修正案を出させる
- 複数ファイルにまたがる変更を一括で進める
- テスト失敗の原因を追わせる
- Git差分を要約させ、コミットメッセージを作る
このバグを調査してください。
症状: 管理画面で保存後に一覧が更新されない
期待: 保存成功後に最新データが表示される
まず関連ファイルを特定し、原因候補を3つに絞ってください。
修正前に、再現に必要なコマンドも示してください。ポイントは、いきなり実装を命じず「調査→方針→実装→検証」の順で進めることです。これだけで不要な変更が減ります。
コードベース全体を理解させる方法
Claude Codeの強みは、単一ファイルではなくリポジトリ全体の関係を踏まえて考えられる点です。ただし、何も指示しないと探索範囲が広すぎるので、入口を与えるのが重要です。
