Claude Code特集2026年10月更新

Claude Codeの使い方ガイド|インストール・CLAUDE.md・権限モードから実践まで【2026年10月版】

公開日: 2026/04/04
更新日: 2026/10/16
Claude Codeの使い方ガイド|インストール・CLAUDE.md・権限モードから実践まで【2026年10月版】

この記事のポイント

Claude Codeの使い方を、インストール・初回ログイン・最初の5ステップ・CLAUDE.md・権限モード(既定はauto)・主要コマンドの順に2026年10月時点の公式情報で整理。料金の目安、業務コードを扱うときのデータ設定、トラブル対処もまとめています。

Claude Codeは、有料プラン(Pro以上)かAPIキーを用意してインストールし、プロジェクトのフォルダで claude と打てば、そのまま日本語で指示を出して使えます。始めるときに押さえることは3つで、「まず質問してコードを読ませる」「/init でCLAUDE.mdを作る」「権限モード(2026年10月時点の既定は auto)を自分の作業に合わせる」です。

この記事は、2026年10月時点の公式ドキュメントと最新版のCLI(v2.1.301)の内容をもとにまとめています。

この記事でわかること

  • Claude Codeのインストール手順(macOS / Windows / Linux)と初回ログインの注意点
  • 初めて使うときの5ステップと、最初に覚えるコマンド・キー操作
  • CLAUDE.mdの書き方・置き場所・長さの目安
  • 6つの権限モードの違いと、既定の auto を Manual に戻す方法
  • 料金プランとコストの目安、業務コードを扱うときのデータ設定
  • 実践ワークフロー、よくあるトラブルの直し方、Cursor・GitHub Copilotとの使い分け

こんな方向けの記事です

  • Claude Codeを初めて使う開発者・エンジニア志望の方
  • すでに使っているが、古い情報のまま設定していないか確かめたい方
  • チームや社内への導入を検討している方
  • 他のAIコーディングツールとの違いを知りたい方

Claude Codeとは?ターミナルで動くAIコーディングアシスタント

Claude Codeのターミナル画面イメージ。自然言語の指示でコード編集とコマンド実行を進める

Claude Codeは、Anthropicが提供するエージェント型のコーディングツールです。公式の説明は「コードベースを読み、ファイルを編集し、コマンドを実行し、開発ツールと連携する」というもので、ターミナル・IDE・デスクトップアプリ・ブラウザから使えます。

GitHub Copilotのような補完中心のツールは、書いている行の続きを提案するのが主な役割です。Claude Codeは「必要なファイルを自分で探す → 複数ファイルを変更する → テストやビルドを実行して確かめる」までを1つの指示で進めます。指示を出す側は、何を・どこまでやってほしいかを伝え、出てきた差分を確認する役に回ります。

どの画面から使っても中身のエンジンは同じで、CLAUDE.md・設定・MCPの接続は共通です。

使える場所

特徴

こんな人に

ターミナル(CLI)

すべての機能が使える基本形

ターミナル操作に抵抗がない人

VS Code 拡張(Cursorにも入る)

差分をエディタ内で確認、@ でファイル指定、プランの確認

普段VS Codeで書いている人

JetBrains プラグイン

IntelliJ・PyCharm・WebStorm など

JetBrains製IDEの利用者(CLIの別途インストールが必要)

デスクトップアプリ(Codeタブ)

差分を画面で確認、複数セッションの並行、定期タスク

ターミナルが苦手な人(有料プラン必須)

Web(claude.ai/code)

ローカル環境なしで動く。スマホアプリからも

長時間タスク、手元にないリポジトリ

その他

Slack、GitHub Actions / GitLab CI/CD、Chrome、Routines(クラウドで定期実行)

自動化・チーム運用

できること・強み・弱みを先に知りたい方は「Claude Codeとは?できること・料金・始め方をわかりやすく解説」、Claude全体の位置づけは「Claudeとは」を参照してください。

Claude Codeの料金プランと自分に合うプランの選び方

Claudeの公式ロゴ。料金プランはClaudeのPro・Maxなどの有料プランかAPIの従量課金から選ぶ

出典: Claude 公式サイト(料金ページ)

Claude CodeはFreeプランでは使えません。Pro以上のサブスクリプションか、Claude Console(API従量課金)のアカウントが必要です。Amazon Bedrock・Google Cloud・Microsoft Foundry経由で使う方法もあります。

2026年10月時点の料金は次のとおりです(米ドル・税別)。

プラン

月額

Claude Code

こんな方向け

Free

$0

使えない

チャットのみ

Pro

$20(年払いは月$17相当)

使える

まず試したい人、週に数回の開発

Max 5x

$100(月払いのみ)

使える(Proの5倍)

毎日の開発に組み込んでいる人

Max 20x

$200(月払いのみ)

使える(Proの20倍)

Claude Codeが開発の中心の人

Team Standard

$25/席(年払い$20)・最低2名

使える

管理機能が要る小〜中規模チーム

Team Premium

$125/席(年払い$100)

使える(Standardの5倍)

チームで重く使う開発者

Enterprise

$20/席(年払いのみ)+利用分をAPI料金で従量・最低20席

使える

SSO・監査ログ・契約条件が必要な企業

出典: Claude 料金ページ、Maxプランのヘルプ

利用枠は「5時間ごとの上限」と「週ごとの上限」の2本立てで、チャット版のClaude・デスクトップ・モバイル・Claude Codeで共有です。チャットで長いやり取りをした日は、Claude Codeで使える量もそのぶん減ります。

プラン選びの判断基準

既定のモデルは、2026年9月のv2.1.280以降、Pro・Max・Team・Enterpriseのいずれでも Opus 5.5 です。以前の「ProはSonnetしか使えない」という情報は古くなっています。プランの違いは、主に使える量で考えます。

Proプラン($20/月)で十分な方

  • 週に数回、バグ修正やリファクタリングを頼む程度
  • 個人プロジェクトが中心
  • まず試してみたい段階

Max 5xプラン($100/月)がおすすめの方

  • 毎日の開発でClaude Codeを使っている
  • 複数のプロジェクトを並行して進めている
  • Proで上限に何度も当たる

Max 20xプラン($200/月)が必要な方

  • 1日中Claude Codeを動かしている
  • 大きなコードベースの改修を頻繁に行う
  • 複数のセッションを並行で回す

上限に達したときは、/rate-limit-options から「リセットを待って自動で再開」「利用クレジット(API料金で続ける)を使う」「上位プランへ切り替える」を選べます。

API従量課金という選択肢

サブスクリプションの代わりに、Claude ConsoleでAPIキーを発行して従量課金で使うこともできます。2026年10月時点の単価(100万トークンあたり、入力/出力)は次のとおりです。

モデル

入力

出力

主な使いどころ

Claude Fable 5.1

$10

$50

最も難しい設計・調査(明示的に選んだときだけ)

Claude Opus 5.5

$4

$20

既定。設計から実装まで幅広く

Claude Sonnet 5.5

$2

$10

定型的な実装・量の多い作業

Claude Haiku 5.5

$0.10

$0.50

軽い調査・分類・補助作業

公式の費用ページでは、企業導入での平均は1人1日約$13、月$150〜250程度、90%のユーザーは1日$30未満とされています(出典: Claude Code 公式ドキュメント「Manage costs」)。使う量の波が大きい人や、claude -p でCIから動かす人はAPI従量課金が合う場合があります。

注意点として、環境変数 ANTHROPIC_API_KEY が設定されたまま起動し、確認画面で承認すると、サブスクではなくAPI料金で課金されます。サブスクで使うつもりなら、この変数を外してからログインしてください。

料金の詳細は「Claude Codeの料金」、Claude全体のプラン比較は「Claude料金を徹底比較|Pro・Max・Team・APIの違い」、Maxプランの判断は「Claude Maxプラン」で解説しています。

Claude Codeのインストール方法(OS別セットアップ)

Claude Code公式ドキュメントのセットアップページ。動作環境とOS別のインストール手順を案内している

出典: Claude Code 公式ドキュメント

インストールは、公式が推奨するネイティブインストーラーを使えばコマンド1行で終わります。終わったら新しいターミナルを開いて claude --version で確認します。

前提条件

  • アカウント: Pro / Max / Team / Enterprise、またはClaude Console
  • OS: macOS 13.0以上 / Windows 10(1809以上)・Windows Server 2019以上 / Ubuntu 20.04以上 / Debian 10以上 / Alpine Linux 3.19以上
  • ハードウェア: メモリ4GB以上、x64またはARM64
  • ネットワーク: インターネット接続が必須(オフラインでは動かない)

macOS / Linux / WSLの場合(推奨)

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

ネイティブインストールでは、バックグラウンドで自動更新されます。インストール中は進捗が表示されないので、終わるまで待ってください。

Windowsの場合

PowerShell

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

コマンドプロンプト(CMD)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

よくある失敗は、PowerShellとCMDのコマンドの取り違えです。The token '&&' is not a valid statement separator と出たらPowerShellでCMD用を実行しています。'irm' is not recognized と出たらその逆です。

Windowsでは、ネイティブとWSLのどちらでも動きます。以前は「Git for Windowsが必須」とされていましたが、現在は任意です。入っていればGit Bashを使い、無ければPowerShellで動きます。管理者権限も要りません。ただし、コマンドを隔離して動かすサンドボックス機能はWSL 2でのみ使えます。

Windowsの選び方

ネイティブ

WSL 2

準備の手間

少ない

WSLの導入が必要

Git for Windows

任意

不要(Linux側のGitを使う)

サンドボックス

使えない

使える

こんな人に

まず試したい、Windowsのツールで開発している

Linux前提のプロジェクト、安全面を重視する

パッケージマネージャー経由

Homebrew(macOS)

brew install --cask claude-code

WinGet(Windows)

winget install Anthropic.ClaudeCode

Linuxでは apt / dnf / apk の署名付きリポジトリも用意されています。パッケージマネージャー経由だと自動更新されないため、brew upgrade や winget upgrade Anthropic.ClaudeCode で更新します。新しいモデルは新しいCLIを必要とするため、更新を忘れると最新モデルを選べないことがあります。

npm(npm install -g @anthropic-ai/claude-code)は代替の手段として残っており、Node.js 22以上が必要です。権限やセキュリティの問題が起きるため、sudo npm install -g は使わないよう公式が注意しています。

VS Code拡張機能としてインストール

ターミナルに慣れていない方は、VS Code拡張機能から始める方法もあります。VS Code 1.94.0以上が必要で、Cursorにも入れられます。

  1. 拡張機能マーケットプレイスで「Claude Code」を検索
  2. Anthropic公式の拡張機能をインストール
  3. サイドバーのClaude Codeパネルを開き、有料プランのアカウントでログイン

コマンドラインから入れる場合は次のとおりです。

code --install-extension anthropic.claude-code

インストール後の初期設定

claude --version   # 例: 2.1.301 (Claude Code)
claude doctor      # セットアップを読み取り専用で診断
claude update      # 手動で更新

初回の claude 起動でブラウザが開き、ログインを求められます。一度ログインすれば保存され、アカウントを切り替えたいときはセッション内で /login を使います。

更新の速さは、既定の latest と、約1週間遅れで大きな不具合のある版を飛ばす stable から選べます。業務で安定性を優先するなら、/config の Auto-update channel で stable に切り替えてください。

Claude Codeの基本的な使い方と初めての5ステップ

最初の1時間は、「読ませる → CLAUDE.mdを作る → 小さく変える → テストする → コミットする」の順に進めると、Claude Codeの動き方がつかめます。

ステップ1:プロジェクトフォルダで起動する

cd my-project
claude

起動すると対話モードに入ります。2026年10月時点の最新版では、権限モードの既定が autoです。ファイル編集やコマンド実行の多くは、別のモデル(分類器)が安全を確かめたうえで、確認なしに進みます。最初は1つずつ確かめたい場合は、Shift+Tab を押して画面下の表示を「Manual」か「plan」に切り替えてから始めてください。

ステップ2:プロジェクトの構造を理解させる

最初は変更させず、質問から入ります。

このプロジェクトは何をしていますか?主要なファイルと構造を教えてください
エントリーポイントはどこですか?テストはどのコマンドで動きますか?

Claude Codeは自分でファイルを探して読み、概要を返します。ここで返ってきた説明が実態とずれていれば、そのずれをCLAUDE.mdに書くと次回から精度が上がります。

ステップ3:CLAUDE.mdを作り、簡単なタスクを依頼する

/init を実行すると、プロジェクトを分析してCLAUDE.mdを自動生成します。中身を軽く確認したら、小さな変更から頼みます。

README.mdにローカル環境のセットアップ手順を追記してください
src/utils.ts の calculateTotal 関数に、配列が空のときのエラーハンドリングを追加してください

Manualモードで動かしている場合、ファイル変更の前に確認が出ます。差分を読んで、問題なければ「Yes」を選びます。

ステップ4:テストを実行する

src/utils.ts のテストを書いて実行してください。失敗したら原因を直して、全部通るまで続けてください

公式のベストプラクティスで最初に挙げられているのが、「確かめる手段を渡す」ことです。テスト・ビルド・スクリーンショットなどで結果を確かめさせると、「終わったように見えるが動かない」状態で止まりにくくなります。

ステップ5:コミットを作成する

コミットも自然な文で頼めます。

変更したファイルを確認して、内容がわかるコミットメッセージでコミットしてください
feature/empty-cart という名前でブランチを作って、そこにコミットしてください

古い記事に載っている claude commit のような専用コマンドを覚える必要はありません。変更前に /diff で差分を見ておくと安心です。

覚えておきたい必須コマンド一覧

コマンドは数が多いため、「最初に覚えるもの」と「慣れてから使うもの」に分けて覚えるのが近道です。全コマンドの一覧は「Claude Codeのスラッシュコマンド一覧」にまとめています。

起動・セッション管理

コマンド

機能

使いどころ

claude

対話モードで起動

通常の開発作業

claude "タスク内容"

最初の指示つきで起動

すぐ作業を始めたいとき

claude -p "クエリ"

1回だけ実行して終了(非対話)

スクリプト・CI・パイプ

claude -c

このフォルダの直近の会話を続ける

前の作業の続き

claude -r

過去の会話を選んで再開

中断した作業を戻す

claude --model opus

モデルを指定して起動

用途ごとに使い分けたいとき

claude --permission-mode plan

権限モードを指定して起動

調査だけしたいとき

claude doctor / claude update

診断 / 更新

動作がおかしいとき

パイプで渡すこともできます。

git diff main --name-only | claude -p "変更されたファイルにセキュリティ上の問題がないか確認して"

対話中のスラッシュコマンド(最初に覚える10個)

コマンド

機能

使いどころ

/init

CLAUDE.mdを自動生成(あれば改善案)

プロジェクトで最初に使う

/clear

会話をリセット

別の作業に移るとき

/compact [指示]

会話を要約して文脈を空ける

長い作業の途中

/context

文脈の使用量を表示

遅い・忘れると感じたとき

/usage

使用量・上限・セッションの費用

上限が気になるとき

/model

モデルを切り替え

Opus / Sonnet / Haiku / Fable の切り替え

/plan

プランモードに入る

大きな変更の前

/permissions

許可・確認・拒否のルール管理

確認を減らしたい/止めたいとき

/rewind

会話とコードを以前の時点に戻す

変更を取り消したいとき

/code-review

現在の差分やPRをレビュー(--fix で修正まで)

コミット・PRの前

慣れてきたら、/memory(CLAUDE.mdの編集と自動メモリの切り替え)、/effort(考える深さ)、/security-review、/mcp、/hooks、/skills、/plugin、/schedule(Routines)、/btw(会話に残さない脇の質問)を試してみてください。

古い記事に残りがちなものとして、/vim(/config の Editor mode に移動)、/pr-comments、/ultraplan は削除されています。行頭の # でメモリに書き足す操作も、現行の公式一覧には載っていないため、メモリの編集は /memory を使います。

ショートカットキー

キー

機能

Shift+Tab

権限モードの切り替え(auto → Manual → acceptEdits → plan …)

Esc

動作を止める(ここまでの作業は残る)

Esc を2回

入力があれば消去、空なら巻き戻しメニュー

Ctrl+C

中断・入力のクリア(空の状態で2回目は終了)

Ctrl+G

入力やプランを外部エディタで編集

Ctrl+O

ツール実行の中身を詳しく表示

Ctrl+R

入力履歴を検索

Ctrl+V(Windows・WSLは Alt+V)

画像を貼り付け

Ctrl+B

実行中のコマンドをバックグラウンドへ

! で始める

シェルコマンドを直接実行し、結果を会話に入れる

@

ファイルを指定して読ませる

\ + Enter

改行(多くの端末では Shift+Enter も可)

コスト節約のコツ

公式は「最も重要な資源はコンテキストウィンドウ」としています。文脈が埋まるほど精度が落ち、消費量も増えます。

  • 作業が変わったら /clear: 関係のない会話を引きずらない
  • 長い作業は /compact: 「APIの変更点だけ残して」のように残す内容を指示できる
  • 具体的に頼む: 「コードを直して」より「src/api/handler.ts のタイムアウト時のエラー処理を直して」
  • 重い作業だけ上位モデル: 定型作業は /model でSonnetやHaikuに切り替える
  • CLAUDE.mdを短く保つ: 毎回読み込まれるため、長いほど毎回の消費が増える

さらに詳しい節約方法は「Claude Codeのコスト最適化」、使用量の可視化は「ccusageの使い方」を参照してください。

CLAUDE.mdでプロジェクトをカスタマイズする方法

Claude Code公式ドキュメントのメモリーページ。CLAUDE.mdでプロジェクトの指示を覚えさせる仕組みを説明している

出典: Claude Code 公式ドキュメント

CLAUDE.mdは、「このプロジェクトではこう作業してほしい」をClaude Codeに伝えるファイルで、毎回のセッションの最初に読み込まれます。ただし命令ではなく文脈として扱われます。「絶対にやらせたくない操作」は、CLAUDE.mdではなくフックや拒否ルールで止めます。

CLAUDE.mdの作り方

/init

Claude Codeがプロジェクトを分析し、CLAUDE.mdを自動生成します(既にあれば改善案を出します)。生成されたものは長くなりがちなので、そのまま使わずに削るのがコツです。公式は「各行について『消したらClaudeが間違えるか?』と問い、そうでなければ削る」としており、1ファイル200行未満を目安に挙げています。

なお、v2.1.277以降はCLAUDE.mdが無いフォルダでは AGENTS.md を読みます。Codex・Gemini CLI・Cursorから移る場合は、/import で既存の設定を取り込めます。

書くべき内容・書かなくてよい内容

書くべき内容

書かなくてよい内容

コードから推測できないビルド・テスト・リントのコマンド

コードを読めば分かること(ファイル構造の説明など)

既定と違うコーディング規約

一般的な言語の規約

テストの動かし方・順番

詳しいAPI仕様書(リンクで十分)

ブランチ名・コミット・PRの決まり

頻繁に変わる情報

設計上の判断とその理由

ファイルごとの解説

環境の癖・ハマりどころ

「きれいなコードを書く」のような当たり前のこと

CLAUDE.mdのテンプレート例(Webアプリ開発)

# プロジェクトガイド

## コマンド
- 開発サーバー: `npm run dev`
- テスト: `npm run test`(DBを使うテストは先に `docker compose up -d db`)
- リント: `npm run lint` / 型チェック: `npx tsc --noEmit`

## コーディング規約
- コンポーネントは function 宣言で書く(アロー関数にしない)
- テストは `__tests__/` に置く
- スタイルは Tailwind CSS のみ(独自CSSを足さない)

## Git
- コミットメッセージは Conventional Commits 形式
- main へ直接 push しない。PRは squash merge

## 注意
- `src/legacy/` は凍結中。修正が必要なら先に相談する
- 回答とコミットメッセージは日本語で書く

CLAUDE.mdの配置場所

配置場所

範囲

用途

./CLAUDE.md または ./.claude/CLAUDE.md

このプロジェクト(Gitでチーム共有)

プロジェクト共通のルール

./CLAUDE.local.md

このプロジェクトの自分だけ(.gitignoreへ)

個人の環境の違い

サブフォルダの CLAUDE.md

そのフォルダを触ったときに読み込み

モジュール固有のルール

~/.claude/CLAUDE.md

自分の全プロジェクト

個人の好み・共通ルール

組織の管理用パス(macOSは /Library/Application Support/ClaudeCode/CLAUDE.md など)

組織の全員

会社として守らせたいルール

上位フォルダのCLAUDE.mdは上書きではなく連結して読み込まれます。別のファイルは @docs/testing.md のように書いて取り込めます。

CLAUDE.mdとは別に、Claude Codeが自分でメモを残す「自動メモリ」もあり、既定でオンです。オン・オフは /memory で切り替えます。書き方の詳細は「CLAUDE.mdのベストプラクティス」で解説しています。

開発効率を上げる実践ワークフロー5選

Claude Codeの実践ワークフローのイメージ。調査・計画・実装・検証を順に進める開発の流れ

Claude Codeは、単発のコード生成よりも「調べる → 計画する → 実装する → 確かめる」の流れごと任せたときに効果が出ます。どのパターンも、公式のベストプラクティスにある「確かめる手段を渡す」「具体的に頼む」を日本語の指示にしたものです。

ワークフロー1:バグ修正の自動化

症状と「直った」の判断基準をセットで渡します。

ログイン後のユーザー一覧で次のエラーが出ます。原因を特定して修正してください。
修正後は再現するテストを追加し、npm run test が通ることを確認してください。

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

ログが長い場合は、tail -200 app.log | claude -p "エラーの原因を推定して" のようにパイプで渡せます。

ワークフロー2:PRレビュー&コミット作成

現在の変更を確認して、意味のまとまりごとにコミットを分けてください。
そのあとPRを作り、説明文に「変更点・確認方法・影響範囲」を書いてください。

PRを出す前に /code-review をかけると、自分では見落としやすい点が先に見つかります。GitHub上で自動レビューを回したい場合は「Claude Code × GitHub Actions」を参照してください。

ワークフロー3:リファクタリング(プランモードで計画してから)

大きな変更は、いきなり実装させずにプランモードで計画を作らせます。

/plan src/services/ 以下のAPI呼び出しを、fetchの直書きから共通のラッパー関数に統一したい。
影響するファイル、手順、テストの方針を計画してください。まだ変更しないでください。

計画は Ctrl+G でエディタを開いて直せます。納得してから承認すると実装に移ります。公式は、1文で差分を説明できる程度の小さな修正なら計画は省いてよいとしています。

ワークフロー4:テストの一括生成

src/utils/ の関数ごとにユニットテストを書いてください。
既存の __tests__/format.test.ts の書き方に合わせ、空配列・null・境界値のケースも入れてください。

既存のテストを手本として指定すると、書き方のぶれが減ります。

ワークフロー5:コードベースの探索&ドキュメント化

このプロジェクトの認証の流れを追って、関わるファイルとデータの流れを説明してください。
調査はサブエージェントに任せ、結果だけ要約してください。

調べ物をサブエージェントに任せると、メインの会話の文脈を余計な内容で埋めずに済みます。

上手に使うコツ(公式ベストプラクティスより)

やりがちな頼み方

公式がすすめる頼み方

「テストを追加して」

「foo.py のテストを書いて。ログアウト中のユーザーのケースを入れて。モックは使わない」

「ログインのバグを直して」

「セッションが切れるとログインに失敗すると報告がある。src/auth/ のトークン更新を確認し、再現テストを書いてから直して」

「このコードを改善して」

「既存の HotDogWidget.php と同じ作りで、カレンダーのウィジェットを実装して」

  • 同じ問題で2回以上修正を頼んでも直らないときは、/clear して頼み方を書き直す
  • 何でも1つのセッションに詰め込まず、作業ごとにセッションを分ける
  • 「完了しました」をそのまま信じず、テストや画面で確かめる

具体的な活用場面は「Claude Codeの活用事例」にもまとめています。

VS Code・JetBrainsとの連携設定

Claude Code公式ドキュメントのVS Code連携ページ。拡張機能の導入と設定方法を案内している

出典: Claude Code 公式ドキュメント

ターミナル単独でもすべての機能が使えますが、普段のエディタやデスクトップアプリと組み合わせると、差分の確認がしやすくなります。

VS Code連携

VS Code拡張機能では、次のことができます。

  • サイドバーのパネルでClaude Codeと対話
  • 変更をインライン差分で確認して承認
  • @ でファイルや選択範囲を指定
  • プランモードで出た計画を確認・編集
  • 過去の会話を一覧から再開

APIキーの入力は不要で、有料プランのアカウントでログインして使います。拡張機能とCLIでCLAUDE.mdや設定は共通です。

JetBrains連携

IntelliJ IDEA、PyCharm、WebStormなどJetBrains製のIDEでもプラグインが使えます。プラグインとは別に、CLIのインストールが必要です。

  1. ネイティブインストーラーなどでCLIをインストールする
  2. プラグインマーケットプレイスで「Claude Code」を検索してインストール
  3. IDEを再起動し、ツールウィンドウから起動

デスクトップアプリ

ターミナルもIDEも使わずに、Claudeのデスクトップアプリの「Code」タブから使えます。CLIのインストールは不要ですが、有料プランが必要です。

  • 対応OS: macOS / Windows(x64・ARM64)/ Ubuntu・Debian(ベータ)
  • 差分を画面で確認できる、複数のセッションを並べて進められる、定期タスクを設定できる
  • ターミナルで始めた作業は /desktop でデスクトップアプリへ引き継げる(macOSとx64版Windowsのみ)

ブラウザで使う場合は claude.ai/code を開きます。手元にないリポジトリでの作業や、PCを閉じても続けたい長時間タスクに向いています。プログラミング経験が少ない方の始め方は「非エンジニア向けClaude Codeの使い方」を参照してください。

中級者向け:Hooks・Skills・MCP・サブエージェント活用

基本操作に慣れたら、拡張機能で「毎回同じ説明をする」「毎回手で確かめる」作業を減らせます。役割の違いは次のとおりです。

機能

ひと言で

置き場所・操作

使い分けの目安

Hooks

決まったタイミングで必ず実行するシェル

/hooks、settings.json

必ず守らせたいこと(リント、書き込み禁止)

Skills

必要なときだけ読み込む手順書

.claude/skills/<名前>/SKILL.md

時々使う手順(デプロイ、レビュー観点)

MCP

外部サービスとの接続

claude mcp add / /mcp

Notion・Figma・Jiraなどのデータを使う

サブエージェント

別の文脈で動く専門役

.claude/agents/*.md

調査・レビューを任せ、本筋の文脈を守る

プラグイン

Hooks・Skills・MCP・サブエージェントをまとめて導入

/plugin

チームで同じ環境をそろえる

Hooksによるファイル編集後の自動処理

Hooksは、ファイル編集の前後などに決まったシェルコマンドを必ず実行する仕組みです。CLAUDE.mdは守られないことがありますが、Hooksは毎回実行されます。

  • ファイル編集のあとに eslint や prettier を実行する
  • migrations/ フォルダへの書き込みを止める
  • 作業の終わりにテストを走らせ、失敗したら続けさせる

設定方法は「Claude Code Hooksの使い方」で解説しています。

Skillsによる再利用可能なワークフロー

Skillsは、特定の作業の手順や知識をまとめたファイルで、必要なときだけ読み込まれます。/スキル名 で呼び出すこともできます。デプロイのように副作用がある手順は、自動で呼ばれないよう disable-model-invocation: true を付けておきます。

詳しくは「Claude Code Skillsの使い方」、Hooksとの使い分けは「SkillsとHooksの違い」を参照してください。

MCP(Model Context Protocol)による外部サービス連携

MCPを使うと、Claude Codeを外部サービスにつなげられます。

claude mcp add --transport http notion https://mcp.notion.com/mcp

Notion、Figma、Jira・Linear、Slack、GitHubなどが代表例です。公式は「gh や aws のようなCLIがあるサービスは、CLIを使わせたほうが文脈を節約できる」としています。接続方法は「Claude CodeのMCP連携」で解説しています。

サブエージェントへの並列タスク委任

サブエージェントは、メインとは別の文脈で調査やレビューを担当します。「この機能に関わるファイルを全部調べて要約して」のような作業を任せると、メインの会話に大量のファイル内容が残りません。作り方は「Claude Codeのサブエージェント」を参照してください。

並行作業・定期実行・どこからでも操作

  • 並行作業: Git worktree、デスクトップアプリの複数セッション、/background・/fork で同時に進める。複数のエージェントで分担させるAgent Teamsは実験的機能で既定オフ(「Claude Code Agent Teams」)
  • 定期実行: /schedule で作るRoutinesは、クラウドで動くためPCを閉じていても実行される(「Claude Code Routinesの使い方」)
  • 音声モード: /voice で、話した内容を指示として入力できる
  • Remote Control: /remote-control で、PCで動いているセッションをスマホから操作できる

コミュニティで共有されているスキルや設定は「awesome-claude-code」で紹介しています。

セキュリティ設定と注意点

Claude Codeのセキュリティ設定のイメージ。権限モードとアクセス制御で操作を管理する

Claude Codeはファイルを編集し、コマンドを実行できるため、権限の設定とデータの扱いを最初に決めておく必要があります。特に2026年10月時点の最新版では、権限モードの既定が auto になっている点に注意してください。

権限モデル(パーミッション)

権限モードは6つあり、Shift+Tab、/permissions、起動時の --permission-mode で切り替えます。

モード

確認なしで実行されるもの

向いている場面

default(表示名 Manual)

読み取りのみ

慣れるまで・機密性の高い作業

acceptEdits

読み取り、ファイル編集、mkdir・mv・cp などのよくある操作

差分を見ながら何度も直す作業

plan

読み取り(変更は計画の承認後)

変更前の調査・計画

auto

ほぼすべて(別のモデルが裏で安全を確認)

長い作業、確認の多さを減らしたいとき

dontAsk

事前に許可したツールのみ(他は拒否)

CI・スクリプト

bypassPermissions

すべて

ネットにつながらないコンテナ・VMのみ

v2.1.283以降、ターミナルとVS Codeの対話セッションでは全プランで auto が既定です(Team・Enterpriseでは管理者が無効化できます)。公式は「auto は確認を減らすが安全を保証しない。機密性の高い操作でレビューの代わりにしない」と注意しています。どのモードでも、rm -rf ~ のような重要なパスの削除は自動では承認されず、拒否ルールは bypassPermissions でも有効です。

毎回の確認に戻したい場合は、ユーザー設定 ~/.claude/settings.json に次のように書きます。プロジェクトの .claude/settings.json に "auto" や "bypassPermissions" を書いても効かない仕様なので、置き場所を間違えないでください。

{
  "permissions": {
    "defaultMode": "default"
  }
}

おすすめの使い分け: 慣れるまでは Manual か plan で動きを見て、Gitで管理されたプロジェクトに慣れてきたら auto を使う、という順番が安全です。確認を減らしたいときは、/permissions でよく使う安全なコマンドを許可リストに入れるか、/sandbox(macOS・Linux・WSL 2)でコマンドを隔離して動かします。auto の仕組みは「Claude Code auto モードとは」で解説しています。

個人利用時のセキュリティチェックリスト

  • .env や認証情報は、/permissions の拒否ルール(例: Read(./.env))で読ませない
  • --dangerously-skip-permissions は、ネットにつながらないコンテナ・VM以外では使わない
  • 作業前にGitでコミットしておく(/rewind はBash経由の変更を戻せない)
  • 信頼できないリポジトリは、最初にプランモードで中身を確認する
  • Issue・Webページ・依存パッケージなど、外から来た文章に書かれた指示に注意する
  • 個人プランでは、claude.aiのプライバシー設定で「モデル改善への利用」を確認する

外から来た文章による乗っ取り(プロンプトインジェクション)は、auto モードでも防ぎきれない例が報告されています。詳しくは「auto モードとプロンプトインジェクション」、AIエージェントによる削除事故の例は「AIエージェントのデータ削除事故」を参照してください。

チーム・企業利用時の追加チェックリスト

  • 業務コードを扱うなら、学習に使われない商用規約のTeam・Enterprise・APIを選ぶ
  • SSOで認証をまとめ、管理者設定で使える権限モード(auto の可否など)を決める
  • 組織用のCLAUDE.mdと管理設定で、全員に守らせるルールを配る
  • devcontainerなどで分離した環境を用意する
  • OpenTelemetryで利用状況を把握する

社内で導入する際の手順は「Claude Codeのチーム導入」で解説しています。なお、Claude Codeで作った試作やツールを社内の実データや既存システムにつないで業務で使う段階では、権限・テスト・運用の担当を決め直す必要があります。進め方は「AIで作ったアプリを開発会社へ引き継ぐには」にまとめています。

データの扱い(学習利用と保存期間)

契約

学習への利用

Anthropic側の保存期間

Free / Pro / Max(個人)

「モデル改善に使う」設定がオンなら対象

許可時は5年、不許可時は30日

Team / Enterprise / API

商用規約により使わない

標準30日(EnterpriseはZDRを個別審査で有効化)

手元のPCには、セッションの記録が ~/.claude/projects/ に暗号化されずに30日保存されます(cleanupPeriodDays で変更可)。/feedback や /bug で送った記録は5年保存されます。出典: Claude Code 公式ドキュメント「Data usage」

知っておくべきリスク

  • 巻き戻せない変更がある。/rewind で戻せるのはClaude Codeのファイル編集だけ。Bashコマンド、データベース、外部APIへの操作は戻らない
  • CLAUDE.mdに強制力はない。「〇〇しない」と書いても守られないことがある。必ず止めたい操作はフックや拒否ルールで
  • auto の判断は保証ではない。分類器が通した操作でも、意図と違う結果になることがある

権限設定をさらに詳しく知りたい方は「Claude Codeのセキュリティガイド」、生成AI全般のリスクは「生成AIのセキュリティリスクと対策」を参照してください。公式の解説はClaude Code公式セキュリティドキュメントにあります。

トラブルシューティング(よくある問題と解決法)

困ったときは、まず claude doctor(起動前)か /doctor(セッション内)で診断します。設定・インストール・CLAUDE.mdの問題をまとめて確認できます。

インストール・認証関連

症状

対処

command not found: claude / 'claude' is not recognized

新しいターミナルを開く。それでも出るならPATHに ~/.local/bin を追加

syntax error near unexpected token '<' / 403

インストールスクリプトではなくHTMLが返っている。ネットワーク・プロキシを確認し、HomebrewやWinGetなど別の手段で入れる

PowerShellとCMDでエラー

コマンドの取り違え。使っているシェル用のコマンドを実行する

npmで権限エラー

sudo を使わず、ネイティブインストーラーに切り替える

更新したのに古い版が動く

インストールが二重になっているか、古いエイリアスが残っている

思わぬAPI課金が発生した

ANTHROPIC_API_KEY を外し、/logout → claude update → ターミナル再起動 → 再ログイン

動作・パフォーマンス関連

Q. 上限(レート制限)に達した

→ /usage で残りを確認し、/rate-limit-options で「リセット後に自動で再開」「利用クレジットで続ける」「上位プランへ切り替える」から選びます。チャット版と枠を共有している点も確認してください。

Q. 長い作業の途中で前の指示を「忘れる」

→ 文脈がいっぱいに近づいています。/context で使用量を確かめ、/compact で要約するか、/clear で新しく始めます。大きな作業は分けて頼むと安定します。

Q. ファイルの変更が意図と違う

→ Esc を2回押すか /rewind で、その指示の前の状態に戻せます。Bashコマンド経由の変更は戻らないため、その場合は git diff で確認して git restore <ファイル名> で戻します。

Q. auto モードが選べない

→ 古いモデル(Sonnet 4.5・Opus 4.5・Haiku 4.5)は非対応です。組織の管理者が無効にしていないか、プロジェクトの設定ファイルに書いていないかも確認してください。

設定関連

Q. CLAUDE.mdの内容が反映されない

→ 置き場所(./CLAUDE.md か ./.claude/CLAUDE.md)を確認し、/context で読み込まれているかを見ます。読み込まれているのに守られない場合は、長すぎて埋もれている可能性があります。/doctor で削減案を確認してください。

出力の質が落ちたと感じたときの見方は「Claude Codeの品質低下の事後報告」も参考になります。

他のAIコーディングツールとの使い分け

Claude Codeは「任せて進めてもらう」作業に強く、「書きながら補完してもらう」作業は補完型のツールのほうが合います。目的に応じて組み合わせるのが現実的です。

比較ポイント

Claude Code

Cursor

GitHub Copilot

Devin

操作の場所

ターミナル / IDE拡張 / デスクトップ / Web

専用エディタ(VS Codeベース)

エディタ拡張・GitHub

Web画面 / Slack

進め方

指示から調査・編集・実行・確認まで自律的に

エディタ内での編集とエージェント

補完が中心(エージェント機能もあり)

タスクをまとめて任せる

得意な作業

複数ファイルの変更、Git操作、CI連携

書きながらの編集

1行〜関数単位の補完

切り出しやすい独立タスク

カスタマイズ

CLAUDE.md・Hooks・Skills・MCP

ルールファイル・MCP

指示ファイル

Playbook

料金や機能は各ツールで頻繁に変わるため、契約前に公式サイトで確認してください。

こんな場面ではClaude Codeが向いている

  • ターミナル中心の開発: CLIの流れの中でそのまま使える
  • 複数ファイルにまたがる変更: 調査から修正・テストまでまとめて進められる
  • Git操作の自動化: コミットの分割、PR作成、コンフリクトの解消まで頼める
  • CI/CDでの自動実行: claude -p やGitHub Actionsで組み込める
  • チームで手順をそろえたい: CLAUDE.md・Skills・Hooksをリポジトリで共有できる

こんな場面では他のツールが向いている

  • 入力中の補完が主な用途 → GitHub Copilotのような補完型
  • エディタの画面の中で完結したい → Cursor
  • 独立したタスクを丸ごと預けたい → Devinのような委任型
  • まず無料で試したい → 無料枠のあるツール(Claude CodeはFreeプランでは使えない)

詳しい比較は「AIコーディングツールおすすめ比較」「Cursor vs Claude Code 比較」「Claude Code vs GitHub Copilot」を参照してください。

こんな方におすすめ / おすすめしない方

Claude Codeをおすすめできる方

  • ターミナル操作に抵抗がない開発者: いつもの作業の流れに組み込みやすい
  • 複数のリポジトリを抱えている開発者: プロジェクトごとにCLAUDE.mdで振る舞いを変えられる
  • レビュー・リファクタリング・テスト追加が多い方: 時間のかかる定型作業を任せられる
  • CI/CDの自動化を進めたい方: 自動レビューやテスト生成を組み込める
  • 今のエディタを変えたくない方: VS Code・JetBrains・ターミナルのどこからでも使える

おすすめしない方

  • 無料で使い続けたい方: Freeプランでは使えず、最低でもPro($20/月)が必要
  • 差分を読む時間を取れない方: auto で速く進められても、結果を確かめる工程は省けない
  • 入力中の補完を最優先にしたい方: 補完は主な役割ではない
  • 個人プランで会社のコードを扱おうとしている方: 学習設定を確認するか、Team・Enterprise・APIを選ぶ必要がある

よくある質問(FAQ)

Q1. Claude Codeは無料で使えますか?

Freeプランでは使えません。一部のアカウントには、/passes から知人を1週間の無料体験に招待できる仕組みが表示されることがありますが、表示されるかどうかはアカウントによって違います。確実に使うにはPro以上を契約するか、Claude ConsoleでAPIクレジットを購入します。

Q2. Claude CodeとClaude(チャット版)は何が違いますか?

チャット版はやり取りした文章の中で答えを返すのに対し、Claude Codeは手元のファイルを直接読んで編集し、コマンドも実行します。同じアカウント・同じモデルを使い、利用枠も共有しています。設計の相談はチャット、実装と確認はClaude Code、という使い分けもできます。

Q3. どのOSで使えますか?

macOS 13以上、Windows 10(1809以上)、Ubuntu 20.04以上・Debian 10以上・Alpine Linux 3.19以上に対応しています。Windowsでは、まず試すならネイティブ、サンドボックスを使いたいならWSL 2を選びます。チップはx64とARM64のどちらでも動きます。

Q4. 日本語で指示できますか?

できます。公式の例は英語ですが、日本語で指示しても日本語で返ってきます。コミットメッセージやPRの説明文も日本語にしたい場合は、CLAUDE.mdに「回答とコミットメッセージは日本語で書く」と1行入れておくと安定します。公式ドキュメントにも日本語版があります。

Q5. プライベートなコードが外部に送信されますか?

作業に必要なファイルの内容は、処理のためにAnthropicのサーバーへ送られます。学習に使われるかどうかは契約によって違い、個人プランでは設定次第、Team・Enterprise・APIでは使われません。業務での利用は、社内の情報管理の決まりと照らして契約を選んでください。詳しくはAnthropic Trust Centerで確認できます。

Q6. レート制限に達したらどうなりますか?

5時間ごと、または週ごとの上限に達すると、リセットまで止まります。上限の具体的なトークン数は公開されていません。v2.1.234以降は、リセット後に自動で作業を再開する設定ができます。続けたい場合は利用クレジット(API料金)で延長することもできます。

Q7. VS CodeやCursorと組み合わせて使えますか?

使えます。VS Code拡張機能はCursorにも入れられ、ターミナル版と同じ会話や設定を共有します。エディタで差分を見ながら、重い作業はターミナルのセッションで並行して進める、という使い方もできます。

Q8. Claude Code以外にもAIコーディングツールの選択肢はありますか?

Cursor、GitHub Copilot、OpenAI Codex、Gemini CLI、Devin、Windsurfなどがあります。他のツールから移る場合は、/import で設定を取り込めるほか、AGENTS.md をそのまま読ませることもできます。比較は「AIコーディングツールおすすめ比較」を参照してください。

Q9. オフラインや社内ネットワークだけで使えますか?

オフラインでは使えません。モデルはクラウドで動くため、インターネット接続が必要です。社内のクラウド環境で完結させたい場合は、Amazon Bedrock・Google Cloud・Microsoft Foundry経由で使う方法があります。プロキシ環境では、インストールスクリプトが取得できるかを先に確認してください。

Q10. 会話の履歴はどこに残りますか?

手元のPCの ~/.claude/projects/ に、プロジェクトごとに保存されます。claude -c や /resume で再開できるのはこの記録があるためです。保存期間は既定で30日で、設定の cleanupPeriodDays で変えられます。暗号化されていないため、共有PCでは扱いに注意してください。

まとめ

Claude Codeを使い始める流れは、次の5つです。

  1. 準備: Pro以上の有料プランかAPIキーを用意する(Freeでは使えない)
  2. インストール: ネイティブインストーラーで入れ、新しいターミナルで claude --version を確認する
  3. 最初の操作: 質問で読ませる → /init → 小さな変更 → テスト → コミット
  4. 権限モード: 既定は auto。慣れるまでは Manual か plan で動きを確かめ、作業前にはGitでコミットしておく
  5. 使い込む: CLAUDE.mdは200行未満に保ち、作業ごとに /clear。慣れたらHooks・Skills・MCPで手間を減らす

モデル名・料金・既定の設定は数か月単位で変わります。古い記事の手順で動かないときは、claude update で最新版にしたうえで公式ドキュメントを確認してください。最初に読むなら公式Quickstart、体系的に学ぶならAnthropicの無料講座Claude Academyの「Claude Code 101」がおすすめです。

このツールを自社のシステムや業務にどう組み込むか、ご提案します

この記事の著者

AI革命

AI革命

編集部

AI革命株式会社の編集部です。最新のAI技術動向から実践的な導入事例まで、企業のデジタル変革に役立つ情報をお届けしています。豊富な経験と専門知識を活かし、読者の皆様にとって価値のあるコンテンツを制作しています。

AI・システム開発は、開始価格を公開しています

既存システムの改修 100万円〜・PoC 300万円〜(税別)。相談内容を送っていただくと、2営業日以内に担当者からご返信します