Claude Codeの使い方|始め方とCLAUDE.mdの書き方・権限設定

  • Claude Code を使ってみたいけれど、インストールから何をすればいいか分からない
  • CLAUDE.md に何を書けばいいのか、どこに置けばいいのか分からない
  • 確認の画面が何度も出る。どこまで許可してよいのか不安

Claude Code は、ターミナルで動く Anthropic の AI のコーディング用ツールです。ファイルを読んで、コードを書き換え、コマンドを実行するところまで任せられます。僕はいま、毎日の開発のほとんどを Claude Code で進めていて、プロジェクトごとに CLAUDE.md を置いてルールを書いています。

この記事では、インストールと最初のログインから、CLAUDE.md の書き方、権限の許可ルール、プランモード、よく使うスラッシュコマンド、会話の文脈の扱い、サブエージェントまでを、僕の使い方を交えて説明します。最後に、秘密情報と取り返しのつかない操作についての注意点をまとめます。

この記事の前提(2026年11月18日に確認)
  • macOS 27.2、Claude Code 2.1.327
  • 機能・コマンド・オプションは、公式ドキュメント(code.claude.com/docs)で確認日に確かめたものです
  • Claude Code は更新が速く、名前や既定の動きがよく変わります。手元の版と違うときは、公式ドキュメントと /help の表示を優先してください
目次
  1. Claude Code とは
  2. Claude Code をインストールする
  3. 最初の起動とログイン
  4. CLAUDE.md でプロジェクトのルールを書く
  5. 権限の確認と許可のルール
  6. プランモードで先に計画を立てる
  7. よく使うスラッシュコマンド
  8. 会話の文脈(コンテキスト)を管理する
  9. サブエージェントに作業を分ける
  10. 使うときの注意点
  11. まとめ

Claude Code とは

ターミナルで AI に作業を任せるツール

ブラウザのチャットと違い、Claude Code は自分のパソコンのプロジェクトのフォルダの中で動きます。頼んだことに合わせて、自分でファイルを探して読み、編集し、テストなどのコマンドを実行します。ファイルの編集やコマンドの実行の前には、許可を求める画面が出ます(あとで説明する権限の設定で変えられます)。

ターミナルのほかに、VS Code の拡張機能(anthropic.claude-code、VS Code 1.94.0 以上)や JetBrains のプラグインからも使えます。ターミナルで起動した Claude Code を IDE とつなぐときは /ide を使います。VS Code の準備はMac に VS Code を入れて設定する記事にまとめています。

使うのに必要なもの

使うには、次のどれかのアカウントが必要です。無料プランは対象外と公式ドキュメントに書かれています。

  • Claude の有料プラン(Pro・Max・Ultra・Team・Enterprise)
  • Claude Console(API の従量課金)
  • Amazon Bedrock・Google Cloud・Microsoft Foundry などのクラウド経由

料金はプランや使い方で変わり、改定もあるので、この記事には金額を書きません。最新の金額は公式の料金ページ(claude.com/pricing)で確かめてください。

Claude Code をインストールする

Mac・Linux はインストーラーで入れる

公式が勧めているのは、ネイティブ版のインストーラーです。Node.js は要りません。対応するのは macOS 13 以上、Ubuntu 20.04 以上、Windows 10(1809)以上です。Mac と Linux(WSL を含む)では、ターミナルで次を実行します。

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

ターミナルの基本的な使い方はMac のターミナルの使い方の記事で紹介しています。

Homebrew・Windows で入れる

Homebrew を使っているなら、cask でも入れられます。

Bash
brew install --cask claude-code

Windows の PowerShell では、次のどちらかです。

Bash
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode

npm でも入れられますが、Node.js 22 以上が要り、sudo は使わないよう案内されています。

更新と調子が悪いときの診断

ネイティブ版は自動で更新されます。手動で更新するときと、入れ方や設定に問題がないか診断するときは、次のコマンドを使います。

Bash
claude --version
claude update
claude doctor
Homebrew・winget で入れた場合

Homebrew と winget で入れたものは、既定では自動で更新されません。brew upgrade などで、ときどき自分で更新してください。

最初の起動とログイン

プロジェクトのフォルダで claude を起動する

Claude Code は、起動したフォルダを作業の範囲として扱います。作業したいプロジェクトのフォルダへ移動してから起動します。

Bash
cd /path/to/myapp
claude

初めて起動したときは、ブラウザが開いてログインの画面になります。使うアカウントでログインして許可すれば、ターミナルに戻って会話を始められます。

ログインし直す・アカウントを切り替える

あとからアカウントを切り替えるときは、Claude Code の中で /login・/logout を使います。シェルから直接ログインするなら claude auth login です。

前の会話を続ける

Claude Code を閉じても、会話は残っています。同じフォルダで次のように起動すると、前の会話の続きから始められます。

コマンドやること
claude -c直前の会話を続ける
claude -r一覧から会話を選んで続ける
/resume起動したあとで、会話を選んで続ける

作業を途中で止めて、次の日に同じ話の続きをしたいときに便利です。

CLAUDE.md でプロジェクトのルールを書く

CLAUDE.md は、Claude Code が起動するたびに読む説明書です。テストのコマンドや、守ってほしいルールを書いておくと、毎回説明しなくて済みます。

置き場所と読み込まれる順番

置き場所効く範囲使いどころ
~/.claude/CLAUDE.md自分のすべてのプロジェクト返答の言語など、自分の好み
./CLAUDE.md か ./.claude/CLAUDE.mdそのプロジェクトテストのコマンド、プロジェクトのルール。Git に入れてチームで共有する
./CLAUDE.local.mdそのプロジェクトの自分だけ自分だけのメモ。.gitignore に入れる
.claude/rules/*.mdそのプロジェクトルールをテーマごとのファイルに分ける

起動したフォルダから上の階層へさかのぼって、見つかった CLAUDE.md をすべて読みます。サブフォルダにある CLAUDE.md は、そのフォルダの中のファイルを扱うときに読まれます。

僕は、全部のプロジェクトをまとめた親のフォルダに共通の CLAUDE.md を置き、プロジェクトの一覧と共通の技術(Python は uv、コンテナは Docker Compose など)を書いています。各プロジェクトのフォルダには、そのプロジェクトだけのルールを書いた CLAUDE.md を置いています。どのプロジェクトで起動しても、共通のルールと個別のルールの両方が読まれます。

/init で雛形を作る

最初の CLAUDE.md は、Claude Code に作ってもらうのが早いです。プロジェクトのフォルダで起動して、次のように入力します。

Claude Code の入力欄
/init

Claude Code がファイルの構成やテストのコマンドを調べて、CLAUDE.md の雛形を書きます。すでに CLAUDE.md があるときは、直したほうがよい点を提案してくれます。あとから手で直したいときは /memory で開けます。

書いておくとよいこと(僕の CLAUDE.md の例)

僕がプロジェクトの CLAUDE.md に書いている内容をもとに、架空のプロジェクト(myapp)向けに書いた例です。

Markdown
# myapp

Django の API と Next.js の画面からなる Web アプリ。

## コマンド

- テスト:`uv run pytest`
- lint:`uv run ruff check .`
- 開発サーバー:`docker compose up -d`

## ルール

- 返答は日本語で書く
- `.env` に秘密情報を置く。値をコードやコミットメッセージに書かない
- `compose.yaml` の `ports:` は `127.0.0.1:` に限る
- `git push`・本番への反映・データの削除などは、承認を得てから行う

## 詳しい手順

- デプロイ手順:@docs/deploy.md

書いているのは、大きく分けて次の3つです。

  1. コマンド:テスト・lint・起動の方法。書いておくと、変更のあとに自分でテストを走らせてくれます
  2. やってはいけないこと:秘密情報をコードに書かない、ポートを外に開けない、など。最初から全部を書こうとせず、困ったことがあったらそのたびに1行ずつ足して育てていくとよいです
  3. 確認してほしいタイミング:push や本番への反映、データの削除のように、やり直しにくい操作の前

ほかに、親のフォルダの共通の CLAUDE.md には「画面を変えたら、狭いスマホの幅と PC の幅の両方で確かめる」「データの出典を確かめ、推測で埋めない」のような、作業の進め方も書いています。

短く、具体的に書く

CLAUDE.md は毎回の会話で読み込まれ、そのぶん会話に使える量(文脈)を使います。公式ドキュメントでは、1ファイル200行以内を目安にしています。

  • 「きれいなコードを書く」のようなあいまいな書き方より、「関数名は snake_case」のように確かめられる書き方にする
  • 長い手順書は別のファイルにして、@docs/deploy.md のように @ で取り込む(入れ子は4段まで)
  • 守られなかったルールは、書き方を具体的にするか、次に説明する権限の設定で止める

権限の確認と許可のルール

Claude Code は、ファイルの編集やコマンドの実行の前に許可を求めます。どこまで自動で進めてよいかは、権限モードと許可のルールで決めます。

権限モードの種類

モード動き
default(画面の表示は Manual)編集やコマンドの前に毎回確かめる
acceptEditsファイルの編集は確かめずに進める
plan調べて計画を立てるだけで、ファイルは編集しない(次の章)
auto安全かどうかを判断しながら、確認を減らして進める
dontAsk許可のルールで許したものだけ実行し、それ以外は確かめずに断る
bypassPermissions確認をすべて飛ばす。--dangerously-skip-permissions と同じ

公式ドキュメントによると、v2.1.283 以降は、対話で起動したセッションは auto モードで始まります(auto に対応していないモデルもあります)。claude -p で一度だけ実行するときは default で始まります。

Shift+Tab でモードを切り替える

会話の途中では、Shift+Tab を押すたびにモードが切り替わります。起動するときに決めておくなら、--permission-mode を付けます。

Bash
claude --permission-mode plan

settings.json に許可のルールを書く

毎回同じコマンドを許可しているなら、プロジェクトの .claude/settings.json にルールを書いておけます。たとえば次のように書けます。ルールは allow(確かめずに許可)・ask(毎回確かめる)・deny(禁止)の3種類です。

JSON
{
  "permissions": {
    "allow": [
      "Bash(uv run pytest *)",
      "Bash(uv run ruff check *)",
      "Bash(git status)",
      "Bash(git diff *)"
    ],
    "ask": [
      "Bash(git commit *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)",
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

この例では、テスト・lint・git status・git diff は確かめずに実行し、コミットは毎回確かめ、git push と rm -rf、.env の読み取りは禁止しています。

  • Bash(uv run pytest *) の * は、後ろに続く引数を表します。* の前の空白は必要で、Bash(ls *) は lsof には当たりません。末尾の「空白+*」は引数のないコマンドにも当たるので、Bash(git push *) は引数のない git push も止めます
  • Bash(git push *) は git -C . push のような別の書き方までは止めません(公式ドキュメントにもこの例があります)。確認の画面を読む習慣は残しておきます
  • Read(./.env) のようにファイルの場所でも書けます(書き方は .gitignore と同じ)
  • ルールは deny → ask → allow の順に見て、最初に当たったものが効きます。allow に入れても、deny に当たれば禁止です

設定のファイルは何か所かにあり、強い順に「管理者の設定 > コマンドラインの指定 > .claude/settings.local.json(自分だけ) > .claude/settings.json(プロジェクト) > ~/.claude/settings.json(自分の全プロジェクト)」です。allow などのリストは上書きではなく足し合わされます。

/permissions でルールを見直す

いま効いているルールの一覧は /permissions で見られ、足したり消したりもできます。公式ドキュメントも、ルールを定期的に見直すよう勧めています。広すぎる許可がないかを、ときどき確かめるとよいです。

プランモードで先に計画を立てる

大きめの変更を頼むときは、いきなりコードを書かせずに、プランモードで計画を出してもらうと安心です。プランモードの間、Claude Code は調べて計画を書くだけで、承認するまでソースを編集しません。

プランモードに入る3つの方法

  • 会話の途中で Shift+Tab を押して、プランモードになるまで切り替える(公式ドキュメントでは、プランモードの間は plan mode on という表示が出ると説明されています)
  • /plan のあとに頼みたいことを書く(例:/plan ログイン画面にパスワードの再設定を足したい)
  • 起動するときに claude --permission-mode plan

計画を確かめて承認する

計画ができると、承認するかどうかの画面になります。内容でよければ承認し、直したい点があれば、そのまま追加の指示を書きます。

注意:計画の画面で Shift+Tab を押すと承認になる

承認の画面で Shift+Tab を押すと、その計画を承認したことになります。承認せずにプランモードから抜けたいときは、先に Esc を押してください。

データベースの変更や、複数のファイルにまたがる変更のように、やり直しにくい作業に向いています。コードを書き始める前の計画の段階なら、「その方法だと既存のデータが消える」といった食い違いを、直すのが簡単なうちに見つけられます。

よく使うスラッシュコマンド

覚えておくと便利なコマンド

Claude Code の入力欄で / から始まるコマンドを入力すると、組み込みの機能を呼び出せます。使えるコマンドは /help で確かめられます。

コマンドやること
/help使い方とコマンドの一覧を出す
/initCLAUDE.md の雛形を作る
/memoryCLAUDE.md を開いて編集する
/permissions許可のルール(allow・ask・deny)を見る・変える
/model使うモデルを切り替える
/context文脈(コンテキスト)の使用量を見る
/compactここまでの会話を要約して、文脈を空ける
/clear文脈を空にして新しい会話を始める
/resume前の会話を選んで続ける
/rewind会話やコードを前の時点に戻す
/usage使った量とプランの上限を見る
/config設定の画面を開く
/exit終了する

名前が変わったコマンドに注意

古い記事に出てくるコマンドの中には、名前が変わったものがあります。たとえば /cost は /usage、/review は /code-review の別名になりました。自分で作るコマンドも、いまは .claude/skills/<名前>/SKILL.md に書く「スキル」が勧められています(.claude/commands/ も引き続き動きます)。

会話の文脈(コンテキスト)を管理する

Claude Code が一度に覚えておける会話の量(文脈)には上限があります。長く作業を続けると、最初のほうの指示を忘れたり、動きが遅くなったりします。

/context で使用量を見る

/context を実行すると、いまの文脈の使用量が表示されます(公式の説明では、色分けした図で表示されます)。CLAUDE.md や読み込んだファイル、会話がどれだけ使っているかが分かります。

/compact で会話を要約する

/compact は、ここまでの会話を要約して文脈を空けるコマンドです。後ろに、要約で残してほしいことを書けます。

Claude Code の入力欄
/compact 決まった設計と、まだ直していないテストの一覧を残して

上限に近づくと、Claude Code は自動でも要約します(自動で要約するタイミングは /autocompact で変えられます)。区切りのよいところで自分から /compact すれば、上の例のように、要約で残してほしいことを指示できます。

/clear で話題を切り替える・/rewind で戻る

前の作業と関係のない作業を始めるときは、/compact より /clear で文脈を空にしたほうが、前の話に引きずられません。

Claude Code の変更が思っていたものと違ったときは、/rewind で会話とコードを前の時点に戻せます。入力欄が空のときに Esc を2回押しても、同じ巻き戻しのメニューが開きます。

サブエージェントに作業を分ける

サブエージェントは、メインの会話とは別の文脈で動く、専門の担当です。調べものやレビューのように、途中の経過は要らず結果だけほしい作業を任せると、メインの会話の文脈を使わずに済みます。

組み込みのサブエージェント

最初から、ファイルを探して調べる Explore、計画を立てる Plan、何でも頼める general-purpose が入っています。「このリポジトリで、ログインの処理がどこにあるか調べて」のように頼むと、Claude Code が必要に応じて使います。

自分でサブエージェントを作る

サブエージェントは、プロジェクトの .claude/agents/(自分の全プロジェクトなら ~/.claude/agents/)に Markdown のファイルで置きます。コードレビューの担当の例です。

Markdown
---
name: code-reviewer
description: 変更したコードを読み、バグ・セキュリティ・読みやすさの問題を指摘する。コードを書き換えたあとに使う。
tools: Read, Grep, Glob, Bash
model: inherit
---

あなたはコードレビューの担当です。git diff で変更を確かめ、次の順に指摘してください。

1. 動かなくなる・データが壊れるおそれ
2. 秘密情報の書き込み、権限の広げすぎ
3. 読みにくい名前や重複

指摘には、ファイル名と行、理由、直し方を書いてください。コードは書き換えないでください。

先頭の --- で囲んだ部分のうち、必須なのは name と description だけです。tools を省くと、メインと同じツールをすべて使えます。レビューの担当のように書き換えてほしくないものは、使えるツールを絞っておきます。

サブエージェントを呼び出す

Claude Code は description を見て、どのサブエージェントに任せるかを決めます。確実に使ってほしいときは、名前を出して頼みます。

Claude Code の入力欄
code-reviewer のサブエージェントで、いまの変更をレビューして

description に「コードを書き換えたあとに使う」のように使う場面を書いておくと、頼まなくても使ってくれることが増えます。

使うときの注意点

秘密情報を読ませない

Claude Code は、頼まれた作業のためにプロジェクトの中のファイルを読みます。.env のような秘密情報のファイルも、止めなければ読めてしまいます。読ませたくないファイルは、settings.json の deny に Read(./.env) のように書いておきます。

  • 以前の .claudeignore は効きません。Read の deny ルールを使います
  • コマンドの実行をサンドボックスで囲む機能(/sandbox)もあります。既定ではオフで、オンにしても ~/.ssh などはそのままだと読めるので、deny で塞ぐ必要があります
  • パスワードや API キーを会話に貼らない。CLAUDE.md にも値は書かず、「.env に置く」とだけ書く

取り返しのつかない操作は必ず確かめる

git push、rm -rf、データベースの削除、本番へのデプロイのように、やり直しにくい操作は、確認の画面を必ず読んでから許可します。

  • 許可する前に、実行されるコマンドの全文を読む。&& でつながった長いコマンドは、後ろのほうまで読む
  • やり直しにくい操作は deny か ask に入れ、CLAUDE.md にも「承認を得てから行う」と書いておく
  • bypassPermissions(--dangerously-skip-permissions)は、壊れても困らない使い捨ての環境だけで使う
  • 大きな作業の前にコミットしておくと、思っていたのと違う変更になっても Git で戻せる

僕の CLAUDE.md にも「push・本番への反映・データの削除などは、承認を得てから行う」と書いています。ただ、CLAUDE.md はあくまでお願いなので、必ず止めたいものは権限のルールで止めるのが確実です。公式ドキュメントも、確実に止めたいことは権限のルールで設定するよう勧めています。Git の取り消しの基本はGit の基本コマンドの記事も参考にしてください。

信頼できない内容をそのまま渡さない

Web ページや他人が書いたファイルの中に、AI への指示のような文が紛れ込んでいることがあります。知らないリポジトリや Web の内容を読ませるときは、勝手にコマンドを実行させないよう、確認の画面を残したまま使います。

まとめ

Claude Code を使い始めるときに押さえておきたいことをまとめます。

  • インストールは curl -fsSL https://claude.ai/install.sh | bash。プロジェクトのフォルダで claude を起動し、ブラウザでログインする
  • CLAUDE.md には、コマンド・やってはいけないこと・確認してほしいタイミングを短く書く。最初は /init で作る
  • よく使うコマンドは settings.json の allow に、やり直しにくい操作は deny に書く
  • 大きな変更はプランモードで計画を確かめてから進める
  • 長い作業は /context で使用量を見て、/compact や /clear で整理する
  • 秘密情報は Read の deny で読ませず、確認の画面は全文を読んでから許可する

Claude Code は、ルールを書けば書いただけ、自分のやり方に沿って動いてくれるようになります。まずは1つのプロジェクトで /init を実行して、CLAUDE.md を育てるところから始めてみてください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

普段は主にPython開発をしています。
最近はAI駆動開発にも関わっています。