Claude Codeの使い方完全ガイド｜インストールから実践まで2年運用の開発者が解説

Claude Codeとは、Anthropicが提供するAIコーディングエージェントだ。ターミナルで動き、コードベース全体を自分で読み、ファイルを編集し、コマンドを実行して、結果を確認しながら作業を進める。

僕はこのClaude Codeで、SNS運用SaaS「ThreadPost」を1人で開発・運用している。コードを書く作業のほぼ100%をClaude Codeに任せて2年近く。SaaS本体だけでなく、月300本の記事を自動生成するパイプラインも、このブログのSEO改修も、全部Claude Codeで作った。外注ゼロ、開発チームは僕とAIだけだ。

この記事は、その実運用から「インストール→初回設定→基本操作→実践の型→失敗からの学び」までを1本にまとめた使い方ガイドだ。2026年8月時点の公式仕様を裏取りして書いている。

Claude Codeとは何か。ChatGPT・Copilotと何が違うのか

一言で言うと「プロジェクトフォルダごと渡せるAIエンジニア」だ。

ChatGPTのようなチャットAIとの決定的な違いは、エージェントであること。チャットAIは「聞いたら答える」だけで、コードのコピペ往復は人間の仕事だ。Claude Codeは違う。「このバグ直して」と言えば、自分で関係するファイルを探して読み、原因を特定し、修正を書き込み、テストを実行して、失敗したら自分で直す。このループを人間の手を借りずに回す。

主要ツールとの違いを整理するとこうなる。

しんたろー：
僕がCopilotやChatGPTからClaude Codeに完全移行した理由は単純で、「コードを書く時間」より「コードを運ぶ時間」の方が長かったからだ。エラーをコピーして、チャットに貼って、返ってきたコードを貼り戻して、また動かして……この往復が丸ごと消える。体感では、補完型AIが作業を2割速くする道具だとしたら、エージェントは作業を丸ごと預ける道具。カテゴリが違う。

対応環境も2026年現在はターミナルだけではない。Web版（claude.ai/code）、デスクトップアプリ、VS Code / JetBrains拡張、Slack連携、GitHub Actions（CI/CD）まで揃っていて、同じエージェントをどこからでも呼べる。僕は普段VS Code内のターミナルで使い、外出先ではWeb版から同じプロジェクトを触っている。

料金:どのプランで使えるか、実際いくらかかるのか

「Claude Codeは高い」というイメージで止まっている人が多いが、2026年8月現在、無料プランでも使える。プランの整理はこうだ。

選び方の目安は「週に何時間コードを書くか」だ。週2〜3時間ならFreeで足りるか試す。週10時間を超えるならPro。僕のように1日中AIに作業させるならMaxかAPI併用になる。

実測:僕の環境の月額コスト

抽象論より実数を出す。僕の環境（SaaS本体の開発＋記事自動生成システムの運用、AI呼び出しは開発と本番処理の両方）で、AI関連費用はピーク時に月16万円超まで膨らんだ。何も考えずに使うと確かにこうなる。

ただし、これは「コントロールできないコスト」ではない。原因を計測したら大半が「AIに読ませすぎ・考えさせすぎ」で、設定と運用の見直しだけで月5万円弱まで削減できた。主に効いたのは次の2つ。

• 設定ファイルの見直しでトークン消費の無駄を削る（手順はClaude Codeのトークン削減術8選に実測付きでまとめた）
• セッションを引き伸ばさず、タスク区切りでリセットする運用（後述の「5分ルール」。コンテキスト最適化の実測記事で入力コスト90%減の過程を公開している）

しんたろー：
コストで一つ言っておきたいのは、「AIの費用」は「人を雇う費用」と比べるものだということ。僕のSaaSは外注していたら月に数十万〜百万円規模の開発費がかかる内容を、AI費用月5万円で回している。月16万円だった時期ですら、実は破格だった。ただし計測せずに使うのだけはダメだ。僕は全AI呼び出しのコストをログに落として毎月見ている。見えないコストは必ず膨らむ。

あわせて読みたい【2026年版】AI活用1人SaaS開発の完全ロードマップ｜5ステップで始める個人開発 →

インストール手順（2026年8月版）

公式推奨はネイティブインストーラ。ターミナルで1行実行するだけで入る。

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）:

irm https://claude.ai/install.ps1 | iex

Homebrew派なら `brew install --cask claude-code`、WinGetなら `winget install Anthropic.ClaudeCode` でも入る。ただし自動アップデートが効くのはネイティブインストーラ版だけなので、こだわりがなければ公式推奨に従うのが楽だ。Claude Codeは更新頻度が高く、手動アップデート運用は現実的に続かない。

入ったかどうかの確認:

claude --version

バージョン番号と `(Claude Code)` が出れば成功だ。

つまずきポイントを2つ。

• 古い記事に注意: 以前はnpmでのインストールが主流だったため、検索すると `npm install -g` の手順が大量に出てくる。今はネイティブインストーラが推奨だ
• Windowsで `&&` エラーが出る: PowerShellにCMD用コマンドを貼っている。プロンプトが `PS C:\` ならPowerShell用を使う

初回セットアップ:ログインと「どこまで任せるか」

プロジェクトのフォルダに移動して起動する。

cd あなたのプロジェクト
claude

初回はログインを求められるので、指示に従ってブラウザで認証する（Claudeアカウント。後で切り替えるときはセッション内で `/login`）。

ここからが重要だ。最初のセッションでは、Claude Codeがファイルを編集するたびに「実行していいか」を確認してくる。そして2回目以降、Pro / Max / TeamプランではAutoモードが標準になり、大半の編集やコマンドは確認なしで進む。モードは `Shift+Tab` でいつでも切り替えられる。

この「どこまで自動で任せるか」の設計が、Claude Code運用の一番大事な意思決定だ。

• 全部手動承認 → 遅すぎて補完型AIに負ける
• 全部自動 → いつか事故る

僕の線引きは「元に戻せる操作は自動、戻せない操作は確認」。コード編集やテスト実行はGitで戻せるから全部任せる。本番データベースの変更、削除系コマンド、外部に公開される操作（デプロイ、投稿）は確認を挟む。この設計の具体的な作り方は完全自動化が途中で止まる理由と承認ルールの設計に、認証情報まわりの防御はセキュリティ対策12選に分けてまとめた。

基本の使い方:最初の1時間でやること

いきなり大きな仕事を頼むと失敗する。僕が人に薦めるときの手順はこうだ。

Step 1: プロジェクトを説明させる（5分）

このプロジェクトは何をしている？フォルダ構成も説明して

Claude Codeが自分でファイルを読んで要約する。コンテキストの手動貼り付けは不要。まずここで「ちゃんと理解できるんだ」を体感する。

Step 2: 読み取り系の仕事を頼む（15分）

ユーザー認証はどこでどう実装されてる？

このエラーログの原因を調査して。修正はまだしないで

編集させる前に、調査・説明の精度を見る。ここで的外れなら指示が抽象的すぎるサインだ。

Step 3: 小さい修正を任せる（30分）

ログイン失敗時に画面が真っ白になるバグを直して。
再現手順: 間違ったパスワードを入れて送信すると発生する

ポイントは同僚のエンジニアに頼む粒度で書くこと。「バグ直して」ではなく「何がどうなると、どうなるバグか」。これだけで精度が目に見えて変わる。修正が終わったら:

変更内容を説明して。問題なければコミットして

Git操作まで自然言語で完結する。

最初に覚えるコマンドはこれだけでいい。

実践編:2年運用して定着した4つの型

ここからは公式ドキュメントに書いていない、実運用で残った習慣だけを書く。

型1: CLAUDE.mdには「事故りやすいポイント」だけを書く

プロジェクト直下に `CLAUDE.md` を置くと、Claude Codeは毎回それを読んでから作業する。ここに何でも書きたくなるが、コードを読めば分かることを書いても無駄になるだけだ。書くべきは「コードからは読み取れない、混同しやすい・事故りやすいポイント」だけ。

僕のCLAUDE.mdの実際の中身は、ほぼこの形式で並んでいる。

## ログテーブルの使い分け（混同注意）
行動ログは2系統ある。離脱分析では両方見ること。
- activity_logs: ページレベルの計測（登録ページのみ記録される）
- app_logs: ボタンクリック等の細粒度ログ

## DB操作の注意
- ページネーションのクエリは .order() を必ず付ける（無いと重複・欠落する）

「過去にAIが混同して事故った箇所」を追記し続けた結果がこれだ。CLAUDE.mdは仕様書ではなく事故報告書の再発防止リストとして育てると効く。

型2: コンテキストは貯めずに捨てる（5分ルール）

長い会話を続けるほど、Claude Codeは過去の文脈を引きずって精度が落ち、トークン消費も膨らむ。対策はシンプルで、タスクの区切りで `/clear` する。僕は「次のタスクの説明に5分かからないなら、リセットして説明し直す方が安い」を基準にしていて、これだけで入力コストを90%減らした状態を維持できている。

「せっかく文脈を理解させたのにもったいない」と感じるだろうが、逆だ。古い文脈は資産ではなく、精度を下げる負債になる。

型3: 拡張機能は「スキル」から入る

Claude Codeには拡張の仕組みが複数ある（スキル、フック、MCP、サブエージェント）。全部覚える必要はない。順番はこうだ。

1. スキル: 「このプロジェクトのデプロイ手順」のような定型作業を登録して `/デプロイ` のように呼べる。一番簡単で効果が大きい
2. MCP: 外部ツール（ブラウザ操作、DB、Slack等）をAIの手足として接続する
3. フック: 特定の操作の前後に自動処理を挟む（コミット前にlintを強制する等）

僕の実際の設定と使い分けはスキルとプラグイン11選で公開している。

型4: 調査は並列で走らせる

Claude Codeはサブエージェントを並列に走らせられる。「この5つのファイルをそれぞれ調査して」のような仕事は、1つずつやらせず並列化すると数倍速い。大規模なコードベースの調査、リファクタリング前の影響範囲洗い出しで特に効く。僕のSaaSで6つのAIエージェントにPRレビューをさせている構成はこの記事に書いた。

失敗から学んだこと:実際にやらかした3つ

成功談だけでは道具の輪郭は分からない。僕が実際に踏んだ地雷を3つ置いておく。

1. 何も考えず並列化して1回25ドル溶かした — マルチエージェント構成を試して、1回の実行で25ドル消えた。並列化は速いがコストも並列になる。実測と対策はこの記事。

2. AIのせいにして28日間ハマった — 直らないバグにClaude Codeへ八つ当たりし続けたら、原因はただの自分の設計ミスだった。AIは指示の曖昧さを増幅する。顛末はこちら。

3. AIの「セキュリティエラーです」を鵜呑みにしかけた — AIが騒ぐエラーの正体が、ただのログ表示崩れだったことがある。AIの報告は仮説であって事実ではない。生ログでの裏取りを習慣にしてから事故率が下がった。

しんたろー：
3つに共通するのは、失敗の原因がAIの性能ではなく「僕の運用設計」だったこと。Claude Codeは指示が良ければ驚くほど働くし、指示が悪ければ悪いなりに全力で走ってしまう。だから上達の方向は「プロンプトの魔法を探す」ことではなく、「事故っても戻れる仕組み」と「AIの報告を検証する習慣」を作ることだ。これはツールの使い方というより、AIという新しい同僚とのマネジメントの話だと思っている。

あわせて読みたい【2026年版】VRAM 8GBで動かすローカルLLM構築術10選｜1人SaaS開発者の実践記録 →

よくあるつまずきと対処

動きが途中で止まる・固まる — 大半はコンテキストの肥大が原因。`/clear` で仕切り直すのが最速。構造的な原因はこの記事で分解した。

トークン上限にすぐ当たる — 消費の大半は「読ませすぎ」。設定の見直しで大きく減る（削減術8選）。Freeプランで物足りなくなったらProへ。

指示と違うことをやり始める — 指示が抽象的すぎるサイン。タスクを番号付きの1〜3ステップに分解して渡す。

生成コードの品質が不安 — 「テストを書いて実行して」までをセットで頼む。Claude Codeは検証まで自分でできるのに、頼まないとやらないことがある。

よくある質問

Claude Codeは無料で使えますか？

使えます。2026年8月現在、Freeプラン（$0）でもClaude Codeが利用可能です。ただし週間の利用上限が小さいため、毎日の開発に使うには足りません。位置づけとしては「導入判断のためのお試し」で、実際に開発の道具として回すならPro（$17/月・年払い）が実用ラインです。上限に当たる頻度が週2回を超えたら、上げ時だと考えていいでしょう。

プログラミング初心者でも使えますか？

使えます。必要なのはターミナルの基本操作（フォルダ移動程度）だけで、あとは日本語で指示するだけです。むしろ「コードは書けないが作りたいものがある」人にこそ向いています。ただし、生成されたものが正しいかを検証する目は要求されるので、「何を作りたいか」を具体的に言語化する力と、動作確認を面倒がらない姿勢の方が、コードの知識より重要です。

ChatGPTやGitHub Copilotと併用すべきですか？それとも乗り換えですか？

役割が違うので併用は可能ですが、僕はコーディング作業についてはClaude Codeへ一本化しました。補完型（Copilot）は「自分がコードを書く人」の加速装置、エージェント型（Claude Code）は「作業を委任する人」の道具です。自分がどちらの働き方をしたいかで決まります。相談・壁打ちだけならChatGPTでも足りますが、その内容をコードに反映する往復コストまで含めると、エージェントに直接頼む方が速い場面がほとんどでした。

会社のコードで使っても大丈夫ですか？

技術的には権限モードと設定で「AIに許す操作」を細かく制御でき、Team/Enterpriseプランには監査ログ等の管理機能もあります。ただし、それ以前に所属組織のAI利用ポリシーの確認が先です。個人開発でも、APIキーなどの認証情報をAIの読める場所に平置きしない等の最低限の防御はしてください。具体的な設定はセキュリティ対策12選にまとめています。

どのくらいの開発規模まで任せられますか？

僕の実例で言うと、SNS運用SaaS（決済・AI生成・外部API連携を含む本番サービス）の開発と運用を、ほぼ全部Claude Code経由でやっています。Threads風SNSのクローンを7日で全実装した記録も公開しています。規模の上限はAIの能力よりも、人間側の「仕様を言語化する力」と「検証の仕組み」で決まるというのが2年使った実感です。

Windowsでも使えますか？

使えます。PowerShell / CMD用のインストーラが公式に用意されており、WSLにも対応しています。ネイティブWindowsで使う場合はGit for Windowsを入れておくと、Claude CodeがBashツールを使えるようになり快適です。

まとめ:最初の1タスクを渡すところから

長く書いたが、やることは3つだけだ。

1. インストーラを1行実行する（無料プランでOK）
2. プロジェクトフォルダで `claude` を起動してログインする
3. いま抱えている小さいバグを1つ、具体的な日本語で頼んでみる

そこで何が起きるかを見れば、この道具が自分の開発をどう変えるかは説明されるより早く分かる。

本格的に1人開発へ進むなら、AI活用1人SaaS開発の完全ロードマップが次の地図になる。ツール選定は1人SaaS開発の最強AIツール7選、日々の運用コスト管理はトークン削減術8選へ。

道具は揃っている。あとは最初の1タスクを渡すだけだ。