- Claude Code を使ってみたいけれど、インストールから何をすればいいか分からない
- CLAUDE.md に何を書けばいいのか、どこに置けばいいのか分からない
- 確認の画面が何度も出る。どこまで許可してよいのか不安
Claude Code は、ターミナルで動く Anthropic の AI のコーディング用ツールです。ファイルを読んで、コードを書き換え、コマンドを実行するところまで任せられます。僕はいま、毎日の開発のほとんどを Claude Code で進めていて、プロジェクトごとに CLAUDE.md を置いてルールを書いています。
この記事では、インストールと最初のログインから、CLAUDE.md の書き方、権限の許可ルール、プランモード、よく使うスラッシュコマンド、会話の文脈の扱い、サブエージェントまでを、僕の使い方を交えて説明します。最後に、秘密情報と取り返しのつかない操作についての注意点をまとめます。
- macOS 27.2、Claude Code 2.1.327
- 機能・コマンド・オプションは、公式ドキュメント(code.claude.com/docs)で確認日に確かめたものです
- Claude Code は更新が速く、名前や既定の動きがよく変わります。手元の版と違うときは、公式ドキュメントと
/helpの表示を優先してください
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 を含む)では、ターミナルで次を実行します。
curl -fsSL https://claude.ai/install.sh | bashターミナルの基本的な使い方はMac のターミナルの使い方の記事で紹介しています。
Homebrew・Windows で入れる
Homebrew を使っているなら、cask でも入れられます。
brew install --cask claude-codeWindows の PowerShell では、次のどちらかです。
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCodenpm でも入れられますが、Node.js 22 以上が要り、sudo は使わないよう案内されています。
更新と調子が悪いときの診断
ネイティブ版は自動で更新されます。手動で更新するときと、入れ方や設定に問題がないか診断するときは、次のコマンドを使います。
claude --version
claude update
claude doctorHomebrew と winget で入れたものは、既定では自動で更新されません。brew upgrade などで、ときどき自分で更新してください。
最初の起動とログイン
プロジェクトのフォルダで claude を起動する
Claude Code は、起動したフォルダを作業の範囲として扱います。作業したいプロジェクトのフォルダへ移動してから起動します。
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 に作ってもらうのが早いです。プロジェクトのフォルダで起動して、次のように入力します。
/initClaude Code がファイルの構成やテストのコマンドを調べて、CLAUDE.md の雛形を書きます。すでに CLAUDE.md があるときは、直したほうがよい点を提案してくれます。あとから手で直したいときは /memory で開けます。
書いておくとよいこと(僕の CLAUDE.md の例)
僕がプロジェクトの CLAUDE.md に書いている内容をもとに、架空のプロジェクト(myapp)向けに書いた例です。
# 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つです。
- コマンド:テスト・lint・起動の方法。書いておくと、変更のあとに自分でテストを走らせてくれます
- やってはいけないこと:秘密情報をコードに書かない、ポートを外に開けない、など。最初から全部を書こうとせず、困ったことがあったらそのたびに1行ずつ足して育てていくとよいです
- 確認してほしいタイミング: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 を付けます。
claude --permission-mode plansettings.json に許可のルールを書く
毎回同じコマンドを許可しているなら、プロジェクトの .claude/settings.json にルールを書いておけます。たとえば次のように書けます。ルールは allow(確かめずに許可)・ask(毎回確かめる)・deny(禁止)の3種類です。
{
"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 を押すと、その計画を承認したことになります。承認せずにプランモードから抜けたいときは、先に Esc を押してください。
データベースの変更や、複数のファイルにまたがる変更のように、やり直しにくい作業に向いています。コードを書き始める前の計画の段階なら、「その方法だと既存のデータが消える」といった食い違いを、直すのが簡単なうちに見つけられます。
よく使うスラッシュコマンド
覚えておくと便利なコマンド
Claude Code の入力欄で / から始まるコマンドを入力すると、組み込みの機能を呼び出せます。使えるコマンドは /help で確かめられます。
| コマンド | やること |
|---|---|
/help | 使い方とコマンドの一覧を出す |
/init | CLAUDE.md の雛形を作る |
/memory | CLAUDE.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 は、ここまでの会話を要約して文脈を空けるコマンドです。後ろに、要約で残してほしいことを書けます。
/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 のファイルで置きます。コードレビューの担当の例です。
---
name: code-reviewer
description: 変更したコードを読み、バグ・セキュリティ・読みやすさの問題を指摘する。コードを書き換えたあとに使う。
tools: Read, Grep, Glob, Bash
model: inherit
---
あなたはコードレビューの担当です。git diff で変更を確かめ、次の順に指摘してください。
1. 動かなくなる・データが壊れるおそれ
2. 秘密情報の書き込み、権限の広げすぎ
3. 読みにくい名前や重複
指摘には、ファイル名と行、理由、直し方を書いてください。コードは書き換えないでください。先頭の --- で囲んだ部分のうち、必須なのは name と description だけです。tools を省くと、メインと同じツールをすべて使えます。レビューの担当のように書き換えてほしくないものは、使えるツールを絞っておきます。
サブエージェントを呼び出す
Claude Code は description を見て、どのサブエージェントに任せるかを決めます。確実に使ってほしいときは、名前を出して頼みます。
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 を育てるところから始めてみてください。
