Claude Codeの使い方完全ガイド｜導入から実践まで手順で解説
私は自社のCMS（ほぼ一人で100規模のメディアを運用している）をAI駆動開発で組み上げた。その中心にいたのがClaude Codeだ。だから教科書的な紹介ではなく、実際に詰まった所と判断を書く。
この記事で分かること。インストールから最初の起動、基本コマンド、CLAUDE.mdやPlan Modeの設定、実際の開発フロー、費用と安全な権限設定、他ツールとの比較まで。順番にたどれば導入できる。
Claude Codeとは何かと何ができるのか
Claude Codeはターミナルで動く対話型のエージェント型コーディングツールだ。コードベースを読み込み、自然言語の指示でファイル編集、テスト実行、Git操作まで任せられる。
コード補完ツールとの違い
補完ツールは「今書いている行の続き」を提案する。Claude Codeは違う。「この機能を追加して」と言えば、関係するファイルを横断して読み、複数ファイルをまたいで編集し、テストまで走らせる。
ブラウザ版のClaudeとの差も大事だ。標準のWeb版は会話するだけだが、Claude Codeはローカルに保存されたファイルへアクセスして直接編集できる。ここが本質的な違い。
できることと使える場所
コード生成だけではない。開発計画の作成、ドキュメント整備、コードレビュー、ログ解析、自動化にも使われる。前述のITmediaの記事でもその幅広さが挙げられている。
動く場所はターミナルが基本。加えてデスクトップアプリやWeb（claude.ai/code）からも触れる。私は普段ターミナル常駐で、計画を練るときだけ別の手段を併用している。
覚えておきたいコンテキストウィンドウの考え方
コンテキストウィンドウとは、Claudeが一度に把握できる情報量の上限だと思えばいい。会話が長く、読み込んだファイルが増えるほど埋まっていく。
ここが埋まると、序盤の指示を忘れたような挙動になる。だから長時間の作業では、こまめに区切って会話をリセットする運用が効く。後半で具体的なコマンドを示す。
導入の準備と最初の起動
ここからは手を動かす。インストール手順の一例として、npmで@anthropic-ai/claude-codeをグローバルインストールし、claudeコマンドで起動する方法が公開されている。
所要時間・難易度・必要な前提
| 項目 | 目安 |
|---|---|
| 所要時間 | 初回はおよそ15〜30分 |
| 難易度 | ターミナルが使えれば中級手前 |
| 前提1 | Node.js（npmが動く環境） |
| 前提2 | Pro/Maxプラン、またはAnthropic Consoleアカウント |
前提でつまずく人が一番多いのが、課金経路の確認だ。次の料金の節で整理する。
インストールの手順
1. ターミナルを開く。確認の目安は、プロンプト（入力待ちの行）が出ていること。
2. npm install -g @anthropic-ai/claude-code を実行する。完了すると、エラーなく入力待ちに戻る。これが正しい状態。
3. claude と打って起動する。初回は認証画面に進めばOK。
うまくいかないときは、npmのグローバル権限エラーが定番。管理者権限の問題か、Node.jsのバージョンが古い可能性が高い。Node.jsを入れ直すのが結局いちばん速い。
はじめての起動と確認の目安
初回起動時はOAuth認証を行う。ここでClaude APIの使用料金を請求するアカウントを選ぶ方式が紹介されている。請求先を間違えないよう、ここは慎重に。
ブラウザが開いて認証が通り、ターミナルに戻って指示待ちの状態になれば成功だ。試しに「このフォルダに何があるか教えて」と日本語で打ってみる。ファイル一覧が返れば、ここまで正しくできている。
料金プランと費用の考え方
費用の入口は大きく2つ。ClaudeのPro/Maxプラン契約者は、Claude Codeを追加料金なしで使える。サブスクを使わずAPI経由で使いたいなら、Anthropic Consoleアカウントを使う方法がある。
| 経路 | 向いている人 |
|---|---|
| Pro/Maxプラン | すでにClaudeを契約済み。追加料金なしで始めたい |
| Anthropic Console（API） | サブスクを使わず、従量で管理したい |
正直に言うと、最初はPro/Maxの方が安心だ。API従量だと使い方を間違えたときの請求が読みにくい。慣れてから従量へ切り替える、で十分間に合う。
基本の使い方を手順で身につける
起動できたら、指示の出し方を体で覚える。Plan modeという計画機能や、各アクションを評価するAutoモードなど、運用を支える仕組みが用意されている。
指示の出し方と応答の承認
指示は普通の日本語でいい。「ログイン画面にパスワード表示の切り替えを追加して」のように、対象と動作を1つにしぼると精度が上がる。
Claudeはファイル編集やコマンド実行の前に、何をするかを示して承認を求めてくる。中身を読んで、問題なければ通す。ここを流し読みで全部承認すると事故る。最初は1つずつ目を通す癖をつけたい。
よく使うコマンドと権限モードの使い分け
設定系の操作として、Ctrl+Gで内容をテキストエディタで編集できる。長い指示はここで書いた方が楽だ。
権限モードの理解が安全運用の肝になる。Autoモードでは、実行前にクラシファイアモデルが各アクションを評価し、安全なものは自動で通し、問題があるものをブロックすると説明されている。
| 状況 | おすすめの姿勢 |
|---|---|
| 初導入・本番リポジトリ | 1つずつ承認を確認する |
| 使い捨ての検証環境 | Auto寄りにして速度を優先 |
| 削除・上書きを伴う操作 | 必ず内容を読んでから承認 |
検証の仕組みを与える進め方
Claude Codeを伸ばすコツは、検証手段を最初に渡すことだ。テストコマンドや起動確認の方法を伝えておくと、Claudeが自分で結果をチェックしながら直す。
私の体感では、ここが効果の分かれ目だった。「テストが通るまで直して」と一言添えるだけで、手戻りが目に見えて減る。
うまくいかないときの対処
よくある詰まりを挙げる。指示が大きすぎて的外れになる、会話が長すぎて序盤の前提を忘れる、承認待ちで止まっているのに気づかない、の3つが多い。
対処はシンプル。指示を小さく割る。会話が重くなったら一度区切る。そして承認のプロンプトが出ていないか画面を確認する。だいたいこれで戻る。
作業を効率化する設定と自動化
基本に慣れたら、設定で楽をする番だ。CLAUDE.mdで前提を記憶させ、Plan modeで先に計画を立てる。これだけで毎回の説明が消える。
CLAUDE.mdで記憶させる方法
CLAUDE.mdは、プロジェクトの前提をClaudeに毎回読ませるためのメモだ。使う言語、命名ルール、テストの走らせ方などを書いておく。
いきなり書くより、/initで自動生成させてから直すのが速い。何を書くかより、何を書かないかが大事だ。長くしすぎるとコンテキストを圧迫する。要点だけに削る。
Plan Modeで計画してから動かす
Plan modeは、まず計画を立ててから実行する使い方だ。いきなりコードを触らせず、手順を先に出させてレビューできる。
大きめの変更はこれを挟むと事故が減る。逆に「変数名を1つ直す」程度なら計画は不要。タスクの大きさで使い分ける。
Skillで繰り返しをなくす
同じ手順を何度もやるなら、Skillとして登録する。たとえば「PR用の説明文を決まった型で書く」といった定型作業だ。一度作れば呼び出すだけになる。
私はリリースノートの整形をSkill化して、毎回の手作業をほぼ消した。地味だが、積み重ねの効果は大きい。
HooksとMCPで外と繋ぐ
Hooksは、特定のイベントに合わせて処理を自動で走らせる仕組みだ。たとえば編集後に自動でフォーマッタをかける、といった使い方ができる。
MCPは外部のツールやデータと繋ぐ口だ。MCPサーバーを追加すると、Claude Codeが触れる範囲が広がる。導入は段階的に、必要なものから足すのがいい。
実際の開発での活用事例とワークフロー
ここが他の解説記事で薄くなりがちな部分だ。私が自社CMSを組んだ実体験から、現実の流れを書く。前提として、Claude Codeはコード生成だけでなく開発計画やレビューにも使えると公式系の記事でも整理されている。
小さな機能追加の流れ
1. Plan modeで「やること」を箇条書きにさせる。確認の目安は、触るファイルが列挙されていること。
2. 計画に納得したら実行へ。1ステップごとに承認を見る。
3. テストを走らせ、通るまで直させる。最後にdiffを自分の目で確認してコミット。これで小さな機能追加が一周する。
既存の大規模コードへの導入
レガシーな大規模コードでは、いきなり全体を触らせない。まず「この機能はどのファイルで動いているか調べて」と探索だけ頼む。
理解が合っているか確認してから、小さな単位で変更を任せる。大きいコードベースほど、CLAUDE.mdに構造の地図を書いておく価値が出る。
Git連携やチーム開発での共有
Claude CodeはGit操作も自然言語で指示できる。ブランチを切る、差分を要約する、コミットメッセージを書く、あたりは任せやすい。
チームで使うなら、CLAUDE.mdやSkillをリポジトリに入れてバージョン管理する。全員が同じ前提でClaudeを動かせる。これが地味に効く。誰か一人の頭の中だった暗黙知が、ファイルとして共有される。
安全に使うための注意点とコスト管理
慎重に進めたい人ほど読んでほしい節。権限の理解が甘いと事故り、トークン管理が甘いと請求が膨らむ。両方とも対策できる。
APIキーや機密情報の扱いと権限設定
APIキーやパスワードは、コードに直書きしない。環境変数や専用の管理に逃がす。Claudeに読ませるファイルに秘密情報を混ぜないのが基本だ。
権限は、削除や上書きを伴う操作ほど慎重に。Autoモードは安全なものを自動通過させるが、本番リポジトリでは1つずつ承認を見る運用を私は勧める。速さより事故回避だ。
トークン消費を抑える実践テクニック
消費を増やす最大の原因は、長い会話と無駄に大きいファイル読み込みだ。だから区切りが効く。
| やること | 効果 |
|---|---|
| タスクごとに会話を区切る | 古い文脈を引きずらない |
| CLAUDE.mdを短く保つ | 毎回の読み込みを軽くする |
| 対象ファイルを絞って渡す | 関係ない読み込みを減らす |
具体的な料金は使い方で大きく変わるため、ここで金額は断定しない。心配なら従量ではなくPro/Maxから入る、が一番読みやすい。
日本語での指示のコツ
日本語の指示でも十分通る。ただし曖昧な主語は苦手だ。「あれを直して」より「ログイン画面のこのボタンを直して」と対象を明示する。
私は、変数名やコミットメッセージを英語に統一したい場合、その方針をCLAUDE.mdに一行書いておく。毎回指示せずに済む。
苦手なタスクと使うべきでない場面
正直に言うと、向かない場面はある。仕様が固まっていない探索的な設計、責任の重い本番データの直接操作、検証手段が用意できないタスク。ここは人が主導すべきだ。
Claude Codeは「検証できる作業」で強い。逆に「正解が決められない作業」では、丸投げせず壁打ち相手として使うのが現実的だ。
他のAIコーディングツールとの比較
よく一緒に検討されるのがCursorやGitHub Copilotだ。性格が違うので、用途で選ぶのが正解になる。
CursorやGitHub Copilotとの違い
| ツール | 得意な立ち位置 |
|---|---|
| Claude Code | ターミナル中心。複数ファイルを横断する自律的なタスク |
| Cursor | エディタ一体型。書きながらAIに相談する流れ |
| GitHub Copilot | 補完中心。今書いている行の続きを素早く出す |
Claude Codeがターミナルで動くエージェント型である点は、複数の解説記事で共通して押さえられている。
向いている用途の見極め方
私の使い分けはこうだ。手元で素早く書きたいときはエディタ一体型。まとまった機能を計画から任せたいときはClaude Code。両方使う日も普通にある。
なお新機能の動きも速い。2026年3月23日からデスクトップ版にcomputer use機能が追加され、現時点ではPro/Maxプラン向け・macOS限定の研究プレビューと説明されている。提供条件は変わりうるので公式で確認したい。
よくある質問と次に読みたい学習リソース
最後に、検索でよく一緒に調べられる疑問へ短く答える。費用と始め方が一番多い。
費用や始め方のよくある疑問
よくある質問
公式ドキュメントとコミュニティへの導線
料金・提供形態・新機能の条件は更新が早い。「料金」「提供形態」「新機能の提供条件」は、執筆前にAnthropic公式で再確認するのが安全だと複数の記事でも注意されている。導入する前に一度は公式へ目を通してほしい。
私からの最初の一歩はこれだ。まずインストールして起動し、「このフォルダに何があるか教えて」と日本語で打つ。返ってきた時点で、もう半分は越えている。あとは小さなタスクから任せていけばいい。
