Claude Code の使い方完全ガイド｜基本操作・コマンド・ベストプラクティスまで
「Claude Code をインストールしたけれど、何から始めればいいかわからない」「もっと効率よく使いこなしたい」「コマンドやベストプラクティスをまとめて知りたい」——そんな悩みを一気に解消するため、本記事は Claude Code の使い方の決定版 として、基本操作からコマンドリファレンス、効果的なプロンプト術、CLAUDE.md による設定、CLI・パイプ活用、コスト最適化、トラブル対策までを一本にまとめました。
Claude Code は Anthropic が開発したターミナルベースの AI コーディングアシスタントです。自然言語で指示を出すだけでコードの生成・編集・デバッグ・Git 操作まで、開発に必要なあらゆる作業を自動で実行できます。しかし、その力を最大限に引き出すには「正しい使い方」と「実践のコツ」を知っておくことが重要です。
この記事を読み終えるころには、Claude Code を日常の開発ワークフローに自信を持って組み込み、チーム全体でも効率化できる状態になっているはずです。
BlueAI法人資料テンプレートをWeb向けに再構成
Claude Code とは——30 秒で理解する
Claude Code は、Anthropic の Claude モデルをターミナル上で直接利用できる エージェント型コーディングツール です。一般的な AI チャットボットとは違い、開発作業そのものを実行できるのが最大の特徴です。
ポイント
ファイルシステムに直接アクセスできる — プロジェクト内のファイルを読み書きし、実際にコードを変更するターミナルコマンドを実行できる — テスト実行、パッケージインストール、Git 操作などをそのまま行うプロジェクト全体を理解する — コードベース全体の構造を把握し、複数ファイルにまたがる変更も一括で処理する対話的に修正できる — 結果を確認しながら「ここを直して」と追加指示が出せるGUI 不要・どのエディタでも使える — ターミナルがあれば SSH 先のサーバーや Docker コンテナでも動作する つまり Claude Code は、ターミナルに常駐する「何でもできるペアプログラマー」です。IDE に依存しないため、Vim / Emacs / VSCode / JetBrains 系など、どのエディタを使っていても活用できます。
Claude Code の全体像や導入方法について詳しく知りたい方は、以下の記事も参考にしてください。
関連記事 — 入門 Claude Code とは？できること・特徴・始め方を完全ガイド Claude Codeとは、Anthropic公式のAIコーディングエージェント。コード生成・修正・Git・テストを横断でき、対象プランまたはAPIで利用できます。
インストールから初回起動まで
インストール
Claude Code は公式のネイティブインストーラーで導入できます。npm 版もサポートされていますが、その場合だけ Node.js を準備します。
macOS / Linux / WSL では次の公式コマンドを使います。
Copy curl -fsSL https://claude.ai/install.sh | bashインストール手順を OS 別に詳しく知りたい方は次の記事を参照してください。
関連記事 — 入門 Claude Codeのインストール方法｜Mac・Windows・Linux対応【2026年版】 Claude Codeの公式ネイティブインストーラーをOS別に解説。Mac・Windows・Linux・WSL2への導入、認証、更新、claude doctorによる確認までまとめました。
初回起動
ターミナルを開き、作業したいプロジェクトのルートディレクトリに移動して claude を実行します。
Copy cd ~/projects/my-app
claudeこれだけで対話セッションが始まります。プロンプトが表示され、自然言語で指示を入力できる状態になります。起動時のカレントディレクトリが作業ディレクトリとして認識される ため、必ずプロジェクトのルートで起動してください。
初回起動時には認証が求められます。Anthropic Console のアカウント、または Claude Pro / Max サブスクリプションでログインしましょう。
ポイント
起動直後に Claude Code は自動的にプロジェクトの構造を把握しようとします。フレームワークの種類、設定ファイル、ディレクトリ構成などを読み取った上で応答を始めるため、開始してすぐに的確な提案が得られます。
CLAUDE.md でプロジェクト固有のコンテキストを与える
プロジェクトのルートに CLAUDE.md を置くと、Claude Code はセッション開始時に自動的に読み込みます。/init コマンドでひな形を自動生成できます。
生成された CLAUDE.md をベースに、プロジェクト固有のルールやコーディング規約を書き加えるのが最も効率的です。詳細は本記事後半の「CLAUDE.md で Claude Code をカスタマイズする」で解説します。
基本的な使い方——5 ステップ
Claude Code の操作は非常にシンプルです。次の 5 ステップを押さえれば、すぐに日常の開発に取り入れられます。
ステップ 1. 起動する
プロジェクトルートで claude を実行するだけです。CLAUDE.md があれば自動で読み込まれ、プロジェクト固有のコンテキストが反映された状態で対話が始まります。
ステップ 2. プロジェクトを開く
Claude Code は起動時のカレントディレクトリをプロジェクトとして認識します。複数のフォルダにまたがって作業したい場合は --add-dir フラグで追加ディレクトリを指定できます。
Copy claude --add-dir ../shared-libステップ 3. 指示を出す
プロンプトに自然言語で指示を入力します。日本語でも英語でも問題ありません。
Copy ユーザー登録フォームのバリデーションを追加して。
メールアドレスの形式チェックとパスワードの最低 8 文字チェックを入れたい。Claude Code は指示を受け取ると、関連ファイルの特定 → コードの理解 → 変更計画の立案 → コードの生成・編集を自動的に実行します。変更が行われる前にはプレビュー（差分）が表示される ため、予期しない変更が適用される心配はありません。
ステップ 4. 結果を確認する
Claude Code が変更を提案すると、差分（diff）が表示されます。
ポイント
変更されたファイル — 意図したファイルが変更されているか変更内容 — 追加・削除・修正された行が期待通りか副作用 — 関係のないファイルが変更されていないか 変更を承認すると、実際にファイルに書き込まれます。承認前であれば変更はまだ適用されていないため、安心して内容を精査できます。動作確認も直接依頼できます。
ステップ 5. 修正を依頼する
結果に満足できない場合は、そのまま追加の指示を出します。Claude Code は前のやり取りのコンテキストを保持しているため、「さっきの変更」について自然に会話を続けられます。
Copy パスワードのバリデーションに大文字・小文字の混在チェックも追加してCopy バリデーションのロジックをカスタムフックに切り出して一度に完璧な指示を出す必要はありません。 「まず大まかに作って、細部を調整する」というアプローチが最も効率的です。
日常使いのコマンド・ショートカット一覧
Claude Code にはスラッシュコマンドとキーボードショートカットが多数用意されています。これらを使いこなすことで、操作効率が格段に上がります。
スラッシュコマンド
コマンド 機能 /initCLAUDE.md を自動生成する/compact会話履歴を要約してコンテキストを圧縮する /cost現在のセッションのトークン消費量とコストを表示する /clear会話履歴をクリアして新しいセッションを開始する /help使い方のヘルプを表示する /model使用するモデルを切り替える（Sonnet / Opus など） /permissionsパーミッション設定を確認・変更する /resume過去の会話を選択して再開する /continue直前の会話を再開する
特に重要なのが/compactと/usageです。/compactは長い会話の要点を保持したまま履歴を圧縮し、コンテキストウィンドウの空きを取り戻します。/usage（/costはエイリアス）で利用状況を確認できます。API利用時のセッション概算とサブスクリプションの請求表示は同じではない点に注意してください。
スラッシュコマンドの全リストと詳しい使い方は次の記事にまとめています。
関連記事 — 使い方 Claude Code のコマンド一覧｜スラッシュコマンドと便利な操作 Claude Codeで使えるスラッシュコマンドとキーボードショートカットを一覧で解説。/init、/context、/compact、/usageなどの使い方を紹介します。
キーボードショートカット
ショートカット 機能 Escape現在の生成を中断する Ctrl+C入力中のプロンプトをキャンセル（2 回で終了） Up / Down過去のプロンプト履歴をナビゲートする Tab入力の補完を行う
==生成の中断（Escape）は覚えておくと便利== です。意図と違う方向に進んでいると感じたらすぐに中断して、指示を修正できます。中断しても会話コンテキストは保持されるため、やり直しのコストは最小限です。
CLI フラグ一覧
claude コマンドには多くのフラグがあります。よく使うものは次の通りです。
フラグ 短縮形 説明 --print-p非対話モードで実行。結果を出力して終了 --model使用するモデルを指定（例: sonnet / opus / haiku） --output-format出力形式を指定（text / json / stream-json） --verbose詳細なログを出力 --max-turnsエージェントのターン数上限を設定 --continue-c直前の会話を再開 --resume-r過去の会話を選択して再開 --allowedTools使用を許可するツールを指定 --disallowedTools使用を禁止するツールを指定 --permission-modeパーミッションモードを指定（例: default / plan / dontAsk） --add-dir追加の作業ディレクトリを指定
非対話モード（-p フラグ）の活用
-p（--print）フラグを使うと、対話セッションを開始せずに単発のタスクを実行できます。シェルスクリプトや CI/CD への組み込みに最適です。
Copy claude -p "package.json の依存関係を確認して、セキュリティ上の問題がないかチェックして" 出力はテキスト形式がデフォルトですが、JSON 形式やストリーミング JSON 形式にも切り替えられます。
Copy
claude -p "このプロジェクトの構造を説明して" --output-format json
claude -p "テストを実行して結果を報告して" --output-format stream-jsonパイプとリダイレクトで他のツールと連携
Claude Code は Unix のパイプとリダイレクトを自然に活用できます。これにより、他のコマンドラインツールとシームレスに連携できます。
標準入力からデータを渡す
Copy
cat src/utils.ts | claude -p "このコードのバグを見つけて"
git diff main | claude -p "この差分をレビューして、問題があれば指摘して"
cat error.log | claude -p "このエラーログの原因を分析して" 結果をファイルに保存する
Copy
git diff main | claude -p "コードレビューを実施して" > review.md
claude -p "src/ ディレクトリのアーキテクチャドキュメントを生成して" > architecture.md他コマンドとの連携例
Copy
npm test 2>&1 | claude -p "失敗しているテストの原因と修正方法を教えて"
npx tsc --noEmit 2>&1 | claude -p "これらの型エラーを修正する方法を教えて"
npx eslint src/ 2>&1 | claude -p "これらの ESLint エラーの修正方針をまとめて" CSV の分析・変換
CSV ファイルの分析や加工も claude -p とパイプの組み合わせで一発実行できます。
Copy
cat sales_data.csv | claude -p "この CSV データを分析して、月別の売上推移をまとめて"
claude -p "data.csv を読み込んで JSON 形式に変換する Python スクリプトを作って。文字コードは Shift_JIS 対応にして" シェルスクリプトとの組み合わせ
複数ファイルへのバッチ処理や定期実行も簡単です。
Copy #!/bin/bash
for file in src/components/*.tsx; do
echo "Processing: $file "
claude -p "このファイルに JSDoc コメントを追加して: $(cat "$file " ) " \
--output-format json \
--max-turns 3
done GitHub Actions などの CI/CD と組み合わせれば、PR 自動レビューやドキュメント自動生成も実現できます。詳しくは次の記事を参照してください。
関連記事 — 連携 Claude Code と GitHub Actions の連携｜CI/CD で AI エージェントを活用する方法 Claude Code を GitHub Actions に組み込む方法を解説。PR自動レビュー、Issue→自動修正、テスト失敗の自動修正など実用ワークフロー付き。
効果的なプロンプト術
Claude Code の出力品質は プロンプトの質に大きく左右されます。ここでは、精度の高い回答を引き出すための実践的なコツを紹介します。
1. 具体的に書く
曖昧な指示は曖昧な結果を生みます。ファイル名・関数名・現在の動作・期待する動作の 4 つを明示するのが鉄則です。
Good
Copy React Router のアクションを使ったログインフォームを作って。
- メールアドレスとパスワードのフィールド
- バリデーション: メール形式チェック、パスワード 8 文字以上
- エラー時はフォーム上にエラーメッセージを表示
- 成功時は /dashboard にリダイレクト
- API エンドポイントは POST /api/v1/auth/signin具体的であればあるほど、Claude Code は正確な実装を生成します。「何を」「どこに」「どのように」を明確にすることが鍵です。
2. コンテキストを与える
Claude Code はプロジェクト全体を読めますが、あなたの意図までは読めません。背景情報を添えると、より適切な実装が得られます。
Copy このプロジェクトでは FormInput コンポーネント（@blueai/ui）を
標準のフォーム部品として使っている。
新しいフォームを作るときもこのコンポーネントを使って。
users テーブルにステータスカラムを追加したい。
既存ユーザーはすべて active にして、
退会済みユーザーは inactive で管理する想定。既存のパターンを示すことで、プロジェクト全体の一貫性を保った実装が得られます。
3. 段階的に指示する
大きなタスクを一度に依頼すると、Claude Code が途中で方向を見失ったり、コンテキストウィンドウを使い切ったりすることがあります。タスクを分割して段階的に進めるのがベストプラクティスです。
Copy まず app/lib/api.ts の fetchUsers 関数を調査して、
現在のエラーハンドリングの実装を教えて調査結果を確認してから、次のステップに進みます。
Copy では、fetchUsers にリトライロジックを追加して。
最大 3 回、指数バックオフで再試行する実装にして「まず調査 → 次に実装」のように順序を明示することで、Claude Code はステップごとに集中して作業できます。
4. 制約を明示する
「既存のコードスタイルに合わせて」「新しい依存を追加せずに」「型安全性を維持して」のような制約を伝えると、期待に沿った出力が得られやすくなります。特にやってほしくないことを明示するのが効果的です。
Copy utils/date.ts に formatRelativeTime 関数を追加して。
dayjs は使わず、Intl.RelativeTimeFormat を使うこと。
既存の formatDate 関数のスタイルに合わせて書いて5. フィードバックで磨き込む
一発で完璧を目指さず、対話を通じて理想に近づけましょう。
Copy ここは良い。
ただし、エラーメッセージはユーザー向けの日本語に変えて。
あと、handleSubmit の中で console.log は残さないでCLAUDE.md で Claude Code をカスタマイズする
プロジェクトごとに繰り返し伝えたいルールは、CLAUDE.md に書いておくのが最も効率的です。Claude Code はセッション開始時に必ず CLAUDE.md を読み込む ため、毎回同じ指示を入力する手間がなくなります。
CLAUDE.md がないと起きること
Bad
プロジェクトで使っていないライブラリのコードを提案される
命名規則やファイル配置のルールが無視される
既存のユーティリティ関数があるのに、同じ機能を一から実装される
効果的な CLAUDE.md の書き方
長すぎず、かつ必要十分な情報を含めるのがポイントです。
Copy # CLAUDE.md
## プロジェクト概要
- React + TypeScript の SaaS アプリケーション
- パッケージマネージャ: pnpm
- フレームワーク: React Router v7（SSR）
## ディレクトリ構成
- app/routes/ — ルーティング
- app/components/ — 共通コンポーネント
- app/lib/ — ユーティリティ
## コーディング規約
- コンポーネントは関数コンポーネントで書く
- CSS は Tailwind CSS を使用する
- テストは Vitest + Testing Library
- API クライアントの関数名は use + リソース名（例: useUsers, useInvoices）
- エラーハンドリングは try-catch ではなく Result 型で行う
## 開発コマンド
- pnpm dev — 開発サーバー起動
- pnpm test — テスト実行
- pnpm lint — リント実行ポイント
「開発コマンド」セクションは見落とされがちですが、Claude Code がビルド・テスト・lint を実行する際に正しいコマンドを使ってくれるようになる ため、必ず記載することを強く推奨します。
permissionsで読み取り対象を制限する
Claude Codeの公式な機密ファイル除外設定として.claudeignoreへ依存しないでください。読み取りを禁止するパスは.claude/settings.jsonのpermissions.denyへ設定します。
Copy {
"permissions" : {
"deny" : [
"Read(./.env)" ,
"Read(./.env.*)" ,
"Read(./**/*.pem)" ,
"Read(./**/*.key)" ,
"Read(./secrets/**)"
]
}
} Read denyは同じパスへのEdit・Writeも止めます。任意のサブプロセスによるアクセスまでOSレベルで止める必要がある場合はsandboxも併用します。
permissions の設定
.claude/settings.json で許可・拒否するコマンドを明示的に制御できます。
Copy {
"permissions" : {
"deny" : [
"Bash(rm -rf *)" ,
"Bash(git push --force)" ,
"Bash(curl*)" ,
"Bash(wget*)"
]
}
} 必要なコマンドだけを許可するホワイトリスト方式 が最も安全です。設定の全体像は次の記事で詳しく解説しています。
関連記事 — 使い方 Claude Code の設定ガイド｜CLAUDE.md・permissions・モデル切り替え 生産性が2倍変わる Claude Code の初期設定7選。CLAUDE.md の書き方、おすすめモデル、コスト上限の設定方法を実例付きで解説。
よく使うワークフロー例
ここでは、日常の開発で頻繁に使うワークフローを紹介します。
ファイル作成・編集
Copy app/components/user-profile.tsx にユーザープロフィールの
表示コンポーネントを作って。名前、メールアドレス、
アバター画像を表示する。Copy app/routes/dashboard.tsx のローダーに、
未読通知の件数を取得する処理を追加して。複数ファイルの一括変更
Claude Code の強みは「複数ファイルの一括変更」にあります。型定義を変えたら関連する全ファイルが自動的に更新されるため、修正漏れが起きません。
Copy User 型の定義に phoneNumber フィールドを追加して、
関連するすべてのファイル（型定義、フォーム、API、テスト）を
一括で更新して。Git 操作
Copy 今の変更をコミットして。コミットメッセージは変更内容から自動生成して。Copy feature/user-profile ブランチを作って、そこに切り替えて。Copy main ブランチとの差分を確認して、コンフリクトがあれば解消して。特に便利なのがコミットメッセージの自動生成です。Claude Code は変更内容を理解しているため、変更の本質を捉えた適切なメッセージを生成してくれます。
コード検索・リファクタリング
Copy このプロジェクトで fetch を直接呼んでいる箇所をすべて探してCopy utils/format.ts の関数を、日付関連とテキスト関連に
ファイルを分割して。既存のインポートも全部更新してリファクタリングでは、Claude Code が依存関係を追跡して関連ファイルまで一括で修正してくれるため、手動で行うよりも安全かつ高速です。
テスト作成・実行
Copy app/lib/validators.ts のユニットテストを作成して。
正常系と異常系の両方をカバーしてCopy テストを実行して、失敗しているものがあれば原因を特定して修正してテストが失敗した場合、Claude Code はエラーメッセージを分析して原因を特定し、修正案を提示します。「テスト実行 → 失敗確認 → 修正」のサイクルを自動で回せるのが大きな魅力です。
Git とのセーブポイント運用
Copy handleSubmit のバリデーションを修正したら、
変更内容を説明するコミットメッセージ付きでコミットして機能単位でこまめにコミットしておけば、Claude Code が意図しない変更を行っても git revert で簡単に巻き戻せます。「動く状態」をこまめにセーブポイントとして残す感覚で運用しましょう。
コスト最適化のコツ
Claude Code は API トークンに基づく従量課金（または Claude Pro / Max の月額制）で動きます。意識的にコントロールするだけで、コストを大きく抑えられます。
/cost で定期的に確認する/cost を実行すると、現在のセッションのトークン消費量と推定コストが表示されます。==作業の区切りごとに /cost を打つ習慣== をつけましょう。
/compact でコンテキストを圧縮する長い会話が続くと、コンテキストウィンドウの肥大化とともにトークン消費も増えます。次のタイミングで /compact を使うと効果的です。
ポイント
長い調査や議論を経て、これから実装に入るとき
「コンテキストウィンドウが 80% を超えました」という警告が表示されたとき
話題が大きく変わるとき（バグ修正 → 新機能の実装など）
Sonnet と Opus を使い分ける
/model でモデルを切り替えられます。すべてのタスクに最上位モデルを使う必要はありません。
種類 向いているタスク Sonnet 定型的なコード生成（CRUD、テスト追加）、軽いリファクタ、ドキュメント、コードレビュー Opus 複雑なアーキテクチャ設計、難しいバグの調査、大規模リファクタ、パフォーマンス最適化
日常作業は Sonnet、頭を使う作業は Opus という使い分けを意識するだけで、コストを大幅に抑えられます。
新しいセッションを始めるタイミング
完全に異なるタスクに切り替わるとき、Claude Code が以前の誤った方針を引きずっているとき、/compact でも十分な空きが確保できないときは /clear で会話をリセットするか、新しいターミナルセッションを開始しましょう。CLAUDE.md が再読み込みされるため、プロジェクトのルールは維持されます。
料金プランや上限設定の詳細は次の記事を参照してください。
関連記事 — 入門 Claude Codeの料金は？Pro・Max・APIを比較【2026年版】 Claude Codeの料金を2026年8月の公式情報で比較。Pro（月20ドル）、Max（月100・200ドル）、API従量課金の違い、無料利用の可否、トークン上限、超過料金を解説。
CI/CD・自動化ワークフローでの活用
claude -p を CI/CD パイプラインに組み込むと、コードレビューやドキュメント生成を自動化できます。
GitHub Actions で PR を自動レビュー
PR が作成・更新されるたびに AI レビューを走らせる例です。anthropics/claude-code-action を使う方法と、CLI を直接呼ぶ方法の 2 種類があります。
Copy name: AI Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}CLI を直接呼ぶ場合は、差分をパイプで渡して JSON 形式で結果を取得します。
Copy git diff origin/main...HEAD | claude -p \
"このプルリクエストの差分をレビューしてください。
セキュリティ上の問題、パフォーマンスの懸念、
コーディング規約違反があれば指摘してください。" \
--output-format json複数リポジトリへの横断バッチ
複数プロジェクトに対して同じチェックを横断的に走らせるシェルスクリプトの例です。
Copy #!/bin/bash
for repo in ~/projects/*/; do
echo "=== $(basename "$repo " ) ==="
cd "$repo "
claude -p "package.json の依存関係で、セキュリティアップデートが必要なものを列挙して" \
--max-turns 1
cd -
done 週次の品質レポート
cron や GitHub Actions のスケジュール機能と組み合わせれば、継続的な品質チェックを自動化できます。
Copy #!/bin/bash
DATE=$(date +%Y-%m-%d)
claude -p "src/ ディレクトリのコード品質を分析して、
改善すべき点をレポートにまとめてください。
特にコードの重複、複雑度の高い関数、
テストカバレッジの低い領域に注目してください。" \
--output-format text > "reports/quality-${DATE} .md" CI/CD への組み込みについて詳しく知りたい方は次の記事も参考にしてください。
関連記事 — 活用 Claude Code エージェント活用術｜自律的なAI開発のベストプラクティス Claude Code をエージェントとして活用するベストプラクティスを解説。自律モード、ヘッドレス実行、CI/CD 統合、GitHub Actions との連携方法を紹介します。
VSCode・他エディタとの組み合わせ
Claude Code はターミナルさえあれば動くため、エディタを選びません。==VSCode の統合ターミナル（Ctrl+`）から claude を起動するのが最も手軽== です。ファイルエクスプローラーでコードを確認しながら、ターミナルで Claude Code に指示を出すワークフローは、両方の強みを活かせます。
Vim / Neovim / Emacs / JetBrains 系の IDE でも同じ要領で使えます。Claude Code はファイルを直接書き換える形で動作するため、エディタは保存後に自動リロードするだけで変更を反映できます。
VSCode と Claude Code の連携を最大化したい方は次の記事もどうぞ。
関連記事 — 連携 Claude Code を VS Code で使う完全ガイド | 拡張機能・統合・ショートカット設定 (2026年版) Claude Code と VS Code の連携手順を3ステップで解説。拡張機能のインストール、ターミナル統合、Ctrl+G などショートカット、設定ファイルの書き方まで網羅。
Cursor との併用や使い分けについては次の記事で詳しく解説しています。
関連記事 — 連携 CursorとClaude Codeを比較｜料金・機能・併用方法【2026年版】 CursorとClaude Codeの料金・機能・作業画面・自動化・チーム管理を比較。どちらを選ぶか、同じリポジトリで安全に併用する方法を解説します。
セキュリティ運用のポイント
Claude Code はファイルシステムに直接アクセスできるため、セキュリティを意識した運用が必須です。
機密ファイルをpermissionsで拒否する
環境変数ファイルや認証情報は、いかなる場合でも Claude Code に読ませない設定にしておきましょう。
Copy {
"permissions" : {
"deny" : [
"Read(./.env)" ,
"Read(./.env.*)" ,
"Read(./**/*.pem)" ,
"Read(./**/*.key)" ,
"Read(./credentials.json)" ,
"Read(./secrets/**)"
]
}
} 危険なコマンドを deny list で塞ぐ
.claude/settings.json で、誤実行されるとダメージが大きいコマンドを拒否しておきます。
Copy {
"permissions" : {
"deny" : [
"Bash(rm -rf *)" ,
"Bash(git push --force)" ,
"Bash(curl*)" ,
"Bash(wget*)"
]
}
} 本番環境への直接操作は禁止する
ポイント
本番データベースへの直接アクセスを禁止する
デプロイコマンドの実行を権限で制限する
本番のAPIキーを開発端末へ置かず、機密パスはRead denyとsandboxで遮断する
Claude Code はあくまで開発支援ツール として位置づけ、本番環境への操作は CI/CD パイプライン経由に統一しましょう。詳細は次の記事を参照してください。
関連記事 — 活用 Claude Codeのセキュリティ設定｜権限・sandbox・法人運用【2026年版】 Claude Codeを安全に使うためのpermissions、sandbox、機密ファイル拒否、ネットワーク制御、managed settings、データ保持、監査を公式仕様で解説。
チームでの活用
Claude Code はチームで使うと一段と効果を発揮します。
ポイント
CLAUDE.md を Git にコミットする — チーム全員が同じルールのもとで Claude Code を利用できるSkills をリポジトリ管理する — .claude/skills/ 配下の Markdown を共有して、ワークフローを標準化コーディング規約を CLAUDE.md に明記する — ESLint / Prettier だけではカバーできない「プロジェクト固有の慣習」を Claude Code に守らせるPR チェックリストに含める — 「CLAUDE.md の更新が必要か？」を毎 PR で確認する文化を作る Skills の作り方は次の記事で詳しく解説しています。
関連記事 — 活用 Claude Code Skills の使い方｜カスタムスラッシュコマンドで作業を自動化 Claude Code Skills の作成方法と活用事例を解説。カスタムスラッシュコマンドの定義、プロジェクト固有のワークフロー自動化、チームでの共有方法を紹介します。
トラブルシューティング
Claude Code を使い始めた方がつまずきやすいポイントと、その解決策をまとめます。
パーミッションの承認を毎回求められて面倒
Claude Code がファイルの書き込みやコマンドの実行を行う際にはパーミッションの承認が求められます。これはセキュリティ上の重要な仕組みです。
ポイント
信頼できるプロジェクトでは、セッション中の同種操作を自動承認する設定を使う
/permissions コマンドでパーミッション設定を確認・変更する.claude/settings.json にプロジェクト単位の許可ルールを定義する ただし、本番環境に影響するコマンドや機密情報を含むファイル変更については毎回確認する習慣を持つ ことを強く推奨します。
トークン消費が増えすぎる
大きなファイルを何度も読む、長い会話セッション、曖昧な指示の繰り返しが原因です。
ポイント
/compact で定期的にコンテキストを圧縮する/cost でモニタリングする大きなタスクを小さな単位に分割する
最初から具体的な指示を出してやり直しを減らす
必要に応じて /clear で新しいセッションを開始する
API 従量課金の場合、Anthropic Console で 1 日のコスト上限を設定しておくと安心です。Claude Max プランは月額定額のためトークン消費量を気にする必要はありません。
ファイル変更を取り消したい
ポイント
Git を活用する — 変更前に必ずコミットしておけば、git diff で確認し git checkout で戻せる差分をよく読む — Claude Code が提案した時点で注意深く確認する段階的に進める — 大きな変更は一度に行わず、小さなステップに分けて確認しながら進める 作業開始前に Git でクリーンな状態にしておく ことを強く推奨します。コミットしていない変更がある状態で Claude Code に作業を依頼すると、元の変更と Claude Code の変更が混在して取り消しが困難になります。
Copy
git add -A && git commit -m "WIP: 現在の作業を一時保存"
claudeコンテキストウィンドウの限界に達した
長時間のセッションや大規模プロジェクトでは、応答品質が低下したり以前の会話を忘れたりすることがあります。
ポイント
/compact でコンテキストを圧縮するタスクが完了したら /clear で新しいセッションを開始する
CLAUDE.md に重要なルールを書いておけば再開時にも自動で読み込まれる一つのセッションで複数の無関係なタスクを処理しない
期待通りの結果が得られない
ポイント
指示を具体的にする — 「いい感じに」ではなく具体的な仕様を伝える既存コードを参照させる — 「この関数と同じパターンで」と既存のコードを指し示す段階的に進める — 一度に全部作らせず、パーツごとに作って確認するフィードバックを具体的に与える — 「ここは良い、ここは違う」と明確に伝える Claude Code は対話型のツールです。一発で完璧な結果を求めるより、対話を通じて段階的に理想に近づける アプローチが最も効果的です。
コンテナや SSH 先で使えない
Claude Code は GUI を必要としません。公式ネイティブ版、または Node.js を用意した npm 版でインストールできれば、Docker コンテナや SSH 先のサーバーでも問題なく動作します。VSCode の統合ターミナルから使うのも快適です。
よくある失敗パターンと回避法
最後に、Claude Code を使う際に陥りやすい失敗パターンを整理します。
Bad
一度に大きすぎるタスクを依頼する — コンテキストを使い切って品質が低下出力を確認せずに次の指示を出す — 誤りが積み重なって手戻りが大きくなるCLAUDE.md を更新しないコンテキスト肥大化を放置する — 30 分以上の連続作業では /compact を必須化すべてを Opus で実行する — 単純なタスクには Sonnet で十分Git のセーブポイントを作らない — どの変更が原因か特定しにくくなる Good
ファイル単位・関数単位に分割して段階的に進める
各ステップの出力を git diff で確認してから次に進む
技術スタックや規約の変更時に CLAUDE.md も合わせて更新する
30 分ごと、または話題が変わるタイミングで /compact
タスクの複雑さでモデルを切り替える
機能単位でこまめにコミットして「動く状態」を残す
関連プロンプトテンプレート
すぐに使えるプロンプトテンプレートも用意しています。
CSV データクリーニング Excel レポート生成 バグ修正・デバッグ Git PR 作成
おすすめスキル
Claude Code の使い方をさらに広げるスキル集です。
Snifferly Awesome Vibe Coding Guide Learn Faster Kit Vibe Log CLI
まとめ
本記事では、Claude Code の使い方を「基本操作 → コマンド → プロンプト術 → 設定 → ワークフロー → コスト最適化 → トラブル対策」という流れで一気通貫に解説しました。ポイントを振り返ります。
ポイント
起動はシンプル — プロジェクトのルートで claude を実行するだけ指示は具体的に — 「何を」「どこに」「どのように」を明確に伝えるCLAUDE.md を活用する — プロジェクト固有のルールを記述して効率化対話的に進める — 一発で完璧を目指さず、フィードバックを重ねるコマンドを使いこなす — /compact /cost /model を日常に組み込むCLI とパイプを活用する — claude -p で他ツールやスクリプトと連携Git と組み合わせる — 変更前のコミットで安全に作業するモデルを使い分ける — 日常は Sonnet、難所は Opus でコスト最適化チームで共有する — CLAUDE.md と .claude/skills/ を Git で管理 Claude Code は 使えば使うほど使い方が上手くなるツール です。最初は小さなタスクから始めて、徐々に複雑な作業を任せていきましょう。
より体系的に学びたい方は、以下のレッスンで実践的な操作方法を学べます。
レッスン Claude Code とは — 60分 Claude Code とは｜AI駆動開発でできること全体像 Claude Code とは何か、何ができるのかを 60 分で俯瞰。AI 駆動開発の全体像、従来のコード生成 AI との違い、職種別の使いどころまでを地図化し、最初の一歩を明確にします。
レッスン はじめての指示 — 30分 Claude Code 初指示｜最初に覚えるプロンプト 5 型 Claude Code への最初の指示文の書き方を 30 分で習得。あいまいさを消す 5 つの基本プロンプトパターン、Bad / Good 対比、確認すべき初期出力の見方まで。動く相棒に育てる最初の一歩。
株式会社BlueAI||法人向けAI導入・内製化支援
