Claude Codeの使い方を初心者向けに解説｜始め方から実務のコツまで

「Claude Codeを入れてみたけれど、何をどう頼めばいいのか分からない」「黒い画面（ターミナル）が不安で、なかなか触れない」という方は多いのではないでしょうか。

Claude Codeは、Anthropic社のAI「Claude」に、パソコンの中のファイルを読ませたり、書き換えさせたり、コマンドを実行させたりしながら、プログラムづくりや修正を任せる道具です。ふつうのチャットと違って、Claudeがフォルダの中身を自分で調べ、手順を考え、実際にファイルを直すところまで進めます。いまはターミナルだけでなく、デスクトップアプリの画面からも使えるので、黒い画面に慣れていない人でも始められます。

この記事では、始め方から、最初の指示の出し方、権限モード、CLAUDE.md、よく使うコマンド、失敗を減らすコツ、業務での使い方、社内で使うときの注意点までを順に説明します。内容は2026年10月時点の公式ドキュメントをもとにしています。Claude Codeは更新が速く、画面や名前が変わることがあるので、気になる点は公式ページもあわせて確認してください。

Claude Codeの始め方

用意するもの

Claude Codeを使うには、次の3つを用意します。

• Claudeの有料プラン：Pro・Max・Team・Enterpriseのいずれか。APIを使う人向けのClaude Consoleのアカウントや、Amazon Bedrock・Google Cloud・Microsoft Foundry経由でも使えます
• パソコン：公式の動作環境は、macOS 13.0以降、Windows 10（1809以降）またはWindows Server 2019以降、Ubuntu 20.04以降など。メモリは4GB以上が必要です
• 作業するフォルダ：Claudeに読ませたり直させたりするファイルが入ったフォルダ。最初は、中身をよく知っている小さなフォルダがおすすめです

Claude Codeでできることを一言でいうと、「フォルダの中身を理解したうえで、頼んだ作業をファイルの変更まで進めてくれる」ことです。プログラムを書く・直す・説明するのはもちろん、データの整理や、Webサイトの文言の修正、社内の小さなツールづくりなどにも使えます。

使う場所の選び方

Claude Codeは、ターミナル、デスクトップアプリ、VS Codeなどのエディタ、Webブラウザ（claude.ai/code）から使えます。どこから使っても中身は同じClaude Codeで、違うのは操作の方法と、作業が動く場所です。

非エンジニアの方は、まずデスクトップアプリから始めて、慣れてきたらターミナルも試す、という順番が無理なく進められます。

デスクトップアプリで始める

黒い画面を使わずに始める方法です。デスクトップアプリにはClaude Codeが含まれているので、別にインストールするものはありません。

1. アプリをダウンロードしてインストールする公式サイトからClaudeのデスクトップアプリをダウンロードします。Mac（IntelとApple Silicon共通）、Windows（x64）、Windows（ARM64）の版があり、Linux（UbuntuとDebian）はベータ版です。
2. Anthropicのアカウントでログインするアプリを起動し、有料プランを契約したアカウントでログインします。
3. 「Code」タブを開く画面上部の中央にある「Code」タブをクリックします。
4. 「Local」を選び、作業フォルダを選ぶ「Local」を選ぶと、手元のパソコンのファイルを使って作業します。「Select folder」をクリックして、作業するフォルダを選びます。
5. モデルを選ぶ送信ボタンの横の選択欄で、使うモデルを選びます。あとから同じ場所で変えられます。
6. やってほしいことを入力する入力欄に依頼を書いて送ります。最初は「このフォルダの中身を説明して」のような、ファイルを変えない依頼がおすすめです。

デスクトップアプリで慣れてきたら使いたい機能

デスクトップアプリの「Code」タブには、画面ならではの便利な機能がそろっています。公式ドキュメントで紹介されている主なものは次のとおりです。

• 並行して複数の作業：サイドバーから新しいセッションを開き、別々の作業を同時に進められる。それぞれをGitの別の作業場所（worktree）で動かすこともできる
• 脇道の質問：作業中の会話の流れを乱さずに、ちょっとした質問をする「サイドチャット」が使える
• 画面の配置：チャット・差分・ターミナル・ファイル・ブラウザの各画面を、好きな配置に並べられる。Ctrl+`でターミナルを開ける
• アプリの表示確認：開発用のサーバーを動かすと、アプリの中のブラウザ画面に表示され、Claudeも画面を見ながら確認できる
• 定期実行：決まった時間に作業を自動で動かす「定期タスク」を設定できる
• クラウドへの引き継ぎ：時間がかかりそうな作業を、途中からクラウドに移して、アプリを閉じても続けられる

はじめから全部を使う必要はありません。まずは1つの作業を最後まで進めることに慣れてから、必要に応じて試してみてください。

Chat・Cowork・Codeの違い

デスクトップアプリには3つのタブがあります。Claude Codeとして使うのは「Code」タブです。

Local・Cloud・SSH・WSLの違い

「Code」タブでは、作業をどこで動かすかを選べます。

• Local：自分のパソコンで動かす。手元のファイルをそのまま使う
• Cloud：クラウドで動かす。アプリを閉じても作業が続く。GitHubのリポジトリを使う
• SSH：自社のサーバーなど、別のマシンにつないで動かす
• WSL（Windowsのみ）：Windowsの中のLinux環境（WSL 2）で動かす

最初は「Local」で十分です。クラウドの作業は、Pro・Max・Teamと、Enterpriseの対象の席で使えます。

ターミナルで始める

ターミナルで使う場合は、Claude Codeを別にインストールします。

1. インストールのコマンドを実行するMac・Linux・WSLではcurl -fsSL https://claude.ai/install.sh | bash、WindowsのPowerShellではirm https://claude.ai/install.ps1 | iexを貼り付けて実行します。WindowsのコマンドプロンプトではCMD用のコマンドが別に用意されています。インストール中は進み具合が表示されないので、終わるまで待ちます。
2. 新しいターミナルを開いて確認するターミナルを開き直し、claude --versionと入力します。バージョン番号のあとに「(Claude Code)」と表示されれば成功です。
3. 作業フォルダに移動して起動するcdで作業フォルダに移動し、claudeと入力します。
4. ブラウザでログインする初回はログインを求められるので、表示に従ってブラウザでログインします。一度ログインすれば、次からは不要です。
5. 最初の質問をする入力欄の上に、バージョン・使っているモデル・作業フォルダが表示されます。「what does this project do?」や「このプロジェクトは何をするもの？」と入力してみましょう。

ログインに使えるアカウントは、次のとおりです。

あとからアカウントを切り替えたいときは、Claude Codeの中で/loginと入力します。

HomebrewやWinGetで入れることもできます。ただし公式ドキュメントによると、公式のインストーラーで入れた場合は裏で自動的に更新されるのに対して、HomebrewやWinGetで入れた場合は自動更新されないため、自分で定期的に更新する必要があります。

ターミナルに慣れていない人向けの基本操作

ターミナルでClaude Codeを使うときに最低限必要なのは、「作業フォルダに移動する」操作だけです。次の操作を覚えておけば、まずは困りません。

公式ドキュメントには、ターミナルを使ったことがない人向けのガイド（terminal guide）も用意されていて、ターミナルの開き方やコマンドの貼り付け方から説明されています。

VS Codeで始める

普段VS Codeでファイルを編集している人は、拡張機能から使うのが便利です。公式ドキュメントでは、VS Codeで使う場合はこの拡張機能が推奨されています。

1. 拡張機能を入れるVS Code（1.94.0以降）で拡張機能の画面を開き（MacはCmd+Shift+X、WindowsはCtrl+Shift+X）、「Claude Code」を検索してインストールします。
2. Claude Codeを開くファイルを開いた状態で、エディタの右上に出るアイコンをクリックします。画面右下の「✻ Claude Code」からも開けます。
3. ログインする初回はログインの画面が出るので、「Sign in」を押してブラウザでログインします。APIキーは不要です。
4. 依頼する入力欄に依頼を書きます。エディタで選択している部分はClaudeに自動で伝わります。

Manualモードでは、Claudeがファイルを変えようとすると、変更前と変更後を左右に並べた画面が表示され、受け入れるか断るかを選べます。変更ごとに「Accept this change」「Reject this change」で1つずつ判断することもできます。

Web版で始める

手元のパソコンに何も入れずに使いたい場合は、ブラウザでclaude.ai/codeを開きます。Web版では、作業はAnthropicが管理するクラウドの仮想マシンで動きます。

• 使うにはGitHubのリポジトリが必要です。Claudeがリポジトリを取得して作業し、変更をブランチとして送ります
• パソコンを閉じても作業が続き、あとからスマホのClaudeアプリなどで結果を確認できます
• 手元のパソコンの設定やファイルは使えません。手元の環境が必要な作業は、ローカルで使う方が向いています

Web版のクラウドの作業は、Pro・Max・Teamと、Enterpriseの対象の席で使えます。

Windowsで使うときの注意

Windowsでターミナルから使う場合は、Git for Windowsを入れておくことが勧められています。入っていない場合は、Claude CodeはPowerShellを使ってコマンドを実行します。WSLで使う場合は、Git for Windowsは必要ありません。

また、Windowsには「PowerShell」と「コマンドプロンプト（CMD）」という2種類の画面があり、インストールのコマンドが違います。行の先頭にPS C:\と表示されていればPowerShell、C:\だけならCMDです。

アップデートの方法

Claude Codeは更新の頻度が高く、新しいモデルや機能は新しいバージョンでないと使えないことがあります。更新の方法は、入れ方によって違います。

うまく動かないときは、ターミナルでclaude doctorを実行すると、インストールの状態や設定ファイルの問題を確認できます。Claude Codeを起動した後に/doctorと入力すると、問題を診断し、確認したうえで直す提案までしてくれます。

最初の指示を出してみる

Claude Codeを起動したら、いきなり大きな作業を頼むのではなく、まずは「調べる」「説明してもらう」ところから始めます。Claudeがどう考え、どう動くのかが分かってから、少しずつ任せる範囲を広げていきましょう。

まずはフォルダの中身を説明してもらう

最初の依頼は、ファイルを変えない質問がおすすめです。公式のクイックスタートでも、次のような質問が例に挙がっています。

• このプロジェクトは何をするもの？
• このプロジェクトはどんな技術を使っている？
• 処理の入口（最初に動くファイル）はどこ？
• フォルダの構成を説明して

Claude Codeは、必要なファイルを自分で開いて読みます。どのファイルを見ればいいかを自分で指示する必要はありません。日本語で質問すれば、日本語で答えが返ってきます。

Claude Code自体の使い方を質問することもできます。「Claude Codeで何ができる？」「Claude Codeでスキルを作るには？」のように聞けば、使い方を教えてくれます。

小さな修正を頼む

中身が分かったら、小さな修正を頼んでみます。たとえば「READMEの誤字を直して」「この関数に説明のコメントを追加して」といった、結果をすぐ確かめられる作業です。

Claude Codeは、直すべきファイルを探して、変更の内容を示します。変更してよいか確認を求められたら、内容を見て問題なければ「Yes」を選びます。確認を求められるかどうかは、後で説明する「権限モード」によって変わります。

変更内容を確認する

Claudeが何を変えたかを確かめる方法は、使う場所によって少し違います。

• デスクトップアプリ：ファイルが変更されると「+12 -1」のような表示（追加した行数と削除した行数）が出ます。クリックすると差分（変更前と変更後の違い）の画面が開き、ファイルごとに確認できます。特定の行にコメントを書くと、Claudeがそれを読んで直してくれます
• 手動で承認するモードの場合：変更が反映される前に差分が表示され、「Accept（受け入れる）」「Reject（断る）」を選べます。断った場合は、Claudeがどう進めるかを聞いてきます
• ターミナル：変更の内容が画面に表示されます。作業中のコマンド/diffを使うと、Claudeがここまでに加えた変更をまとめて確認できます

デスクトップアプリでは、入力欄に/code-reviewと入力すると、Claudeに変更内容を見直してもらうこともできます。

ファイルや画像を渡す

特定のファイルについて質問したいときは、入力欄に@ファイル名と書くと、そのファイルを会話に取り込めます。画面のスクリーンショットやデザインの画像は、貼り付けるか、ドラッグ＆ドロップで渡せます。デスクトップアプリでは、添付ボタンから画像やPDFを渡すこともできます。

「この画面のここがずれている」と言葉で説明するより、スクリーンショットを貼って「この画像の赤枠の部分を直して」と頼んだ方が、早く正確に伝わります。

最初の30分で試すこと

何から試せばいいか迷う場合は、練習用のフォルダを使って、次の順で触ってみてください。Claude Codeの基本的な動きを一通り体験できます。

1. 練習用のフォルダを作る新しいフォルダを作り、手元にある簡単なファイル（メモのテキストファイルや、小さなCSVなど）のコピーを入れます。
2. 中身を説明してもらう「このフォルダにあるファイルを説明して」と頼み、Claudeがファイルを開いて読む様子を見ます。
3. 新しいファイルを作ってもらう「このCSVの内容を、見出しつきの表にしたHTMLファイルを作って」のように頼み、ファイルができる様子と、確認の画面を体験します。
4. 直してもらう「表の見出しの色を青にして」のように修正を頼み、差分の画面で変更点を確かめます。
5. 元に戻してみる/rewind（デスクトップアプリでは同じコマンドを入力欄に入力）で、修正前の状態に戻してみます。
6. CLAUDE.mdを作ってみる/initでCLAUDE.mdを作り、「説明は日本語で、です・ます調で」と書き足して、次の依頼で反映されるかを確かめます。

この6つを試すと、「読む・作る・直す・戻す・ルールを伝える」という基本の流れがつかめます。実際の仕事のフォルダで使うのは、そのあとで十分です。

Gitと一緒に使う

Git（ファイルの変更の履歴を記録する仕組み）を使っているフォルダなら、Gitの操作も日本語で頼めます。公式のクイックスタートでは、次のような依頼が例に挙がっています。

• どのファイルを変更した？
• 分かりやすいメッセージをつけて、変更をコミット（記録）して
• feature/quickstart という名前の新しいブランチを作って
• 最近の5件のコミットを見せて
• マージのときの競合を解決するのを手伝って

Gitを使っていれば、Claudeの変更がうまくいかなかったときに、記録した時点まで確実に戻せます。社内のツールやWebサイトのファイルをClaude Codeで扱うなら、Gitの導入も一緒に検討すると安心です。Gitの使い方そのものを、Claudeに聞きながら覚えることもできます。

依頼文の基本の型

慣れないうちは、次の4つを意識して依頼文を書くと、伝わりやすくなります。

1. 目的何のための作業か。例：「来月から消費税の扱いが変わるので」
2. 対象どのファイル・どの部分か。例：「@見積書作成.py の金額の計算部分」
3. やってほしいこと何をどう変えるか。例：「税率を設定ファイルから読み込むように変えて」
4. 完成の条件どうなれば終わりか。例：「既存のテストがすべて通り、税率を変えたときのテストも追加されていること」

複雑な作業は、公式のクイックスタートでも勧められているように、「1. 〇〇する　2. △△する　3. □□する」と手順に分けて書くと、Claudeが順番に進めやすくなります。

作業の途中で止める・方向を変える

Claudeが思っていたのと違う方向に進み始めたら、途中で止められます。

• ターミナル：Escキーで止まります。それまでの会話は残っているので、「そうではなく、〇〇の方法で」と伝えて続けられます
• デスクトップアプリ：停止ボタンですぐに止まります。止めずに、入力欄に修正の指示を書いてEnterキーを押すと、作業を続けながら方向を変えられます

終わるまで待ってからやり直すより、ずれに気づいた時点ですぐ伝えた方が、結果的に早く仕上がります。

答えをそのまま信じない

Claudeの説明はとても自然な文章なので、つい正しいと思い込みがちです。しかし、ファイルの読み違いや、思い込みで説明してしまうこともあります。特に最初のうちは、説明の中で挙がったファイル名や設定を実際に開いて、本当にそうなっているかを確かめる習慣をつけましょう。

「その説明の根拠になったファイルと行を示して」と頼むと、どこを読んでそう判断したのかを示してくれます。根拠を見ながら確かめれば、間違いにも気づきやすくなります。

権限モードを使い分ける

権限モードとは

権限モードは、Claudeがどの操作を、確認なしで進めてよいかを決める設定です。ファイルの編集、コマンドの実行、ネットワークへのアクセスといった操作のたびに確認を求めるのか、ある程度は任せるのかを選べます。

確認が多いほど安全ですが、10回目の確認あたりから中身を見ずに承認してしまいがち、と公式のベストプラクティスでも指摘されています。作業の内容と慣れに合わせて、モードを使い分けることが大切です。

4つの基本モード

ふだん使うのは、次の4つのモードです。

• Auto（自動）：別のAI（分類器）が裏で操作を確認し、危なそうな操作だけ止めて、それ以外は確認なしで進める。Claude Code v2.1.283以降では、ターミナルとVS Codeで起動したときの最初のモードになっている
• Manual（手動）：ファイルを読むことはできるが、ファイルの編集やコマンドの実行の前には毎回確認を求める。lsやgit statusのような読むだけのコマンドは確認なしで動く
• Accept edits（編集を自動で許可）：作業フォルダの中のファイルの編集と、フォルダの作成やファイルのコピーなど一部のコマンドは確認なしで進める。それ以外のコマンドは確認を求める
• Plan（計画）：ファイルを変更せず、調べて計画だけを出す。計画を承認すると作業に進む

公式ドキュメントによると、Autoモードの分類器は、頼まれた範囲を超える操作、よく分からない外部のシステムへの操作、読み込んだ文章に書かれた不審な指示に従った操作などを止めます。

切り替え方

ターミナルでは、Shift+Tabを押すたびにモードが切り替わります。Autoから始めた場合、Manual→Accept edits→Planの順に切り替わり、もう一度押すとAutoに戻ります。今のモードは入力欄の下に「⏸ manual mode on」「⏵⏵ accept edits on」「⏸ plan mode on」「⏵⏵ auto mode on」のように表示されます。

起動するときにclaude --permission-mode planのように指定することもできます。デスクトップアプリでは、送信ボタンの横のモード選択欄で切り替えます。VS Codeでは、入力欄の下のモード表示をクリックして切り替えます。

初心者はどれを選ぶか

迷ったときは、次のように考えると決めやすくなります。

• 大事なファイルを扱う、まだ慣れていない：Manual。1つずつ中身を見て承認する
• 何をどう変えるのか、先に知りたい：Plan。計画を読んで納得してから進める
• 変更点は後でまとめて確認すればよい：Accept edits
• 慣れてきて、決まった範囲の作業を任せたい：Auto。ただし、Gitなどで元に戻せる状態にしておく

Manualでコマンドの実行を確認されたときは、その1回だけ許可するか、以後は同じ操作を許可するかを選べます。よく使う安全なコマンドは、/permissionsで「許可するもの」として登録しておくと、確認の回数を減らせます。

Planモードの使い方

Planモードは、初心者にとって特に役に立つモードです。Claudeはファイルを読んで調べたり、質問に答えたりしますが、ファイルの変更はしません。計画を出したところで止まるので、何をどう変えるのかを確かめてから進められます。

• 入り方：ターミナルではShift+Tabを押して「⏸ plan mode on」にするか、/planと入力する。/plan 請求書の金額がずれる不具合を直したいのように、依頼を続けて書くとそのまま計画づくりが始まる。起動時にclaude --permission-mode planと指定してもよい
• 計画を直す：計画に足りない点があれば、そのまま会話で伝える。ターミナルではCtrl+Gで計画をテキストエディタで開き、直接書き直すこともできる
• 作業に進む：計画を承認するか、Shift+Tabでモードを切り替えると、計画をもとに作業が始まる

「計画を読んでもよく分からない」という場合は、「この計画を、プログラミングを知らない人にも分かるように説明して」と頼むと、かみくだいて説明してくれます。

最初のモードを固定する

毎回同じモードで始めたい場合は、設定ファイルで最初のモードを決めておけます。たとえば、自分のパソコンで起動するすべてのセッションをManualで始めたいなら、~/.claude/settings.jsonに次のように書きます（Manualの設定上の名前はdefaultです）。

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

次に起動すると、入力欄の下に「⏸ manual mode on」と表示されます。デスクトップアプリも同じ設定ファイルを読み、新しいローカルのセッションに反映されます。会社で一律に決めたい場合は、管理者が組織全体の設定（managed settings）で最初のモードを決めたり、Autoモードを使えないようにしたりすることもできます。

どのモードでも自動では許可されない操作

公式ドキュメントによると、どのモードでも自動では許可されない操作があります。たとえば、システムにとって重要な場所を対象にした削除のコマンド（rmなど）や、ユーザーへの質問が必要な操作です。また、自分で「確認する」「禁止する」と決めたルールは、Autoモードでも守られます。

Autoモードで操作が止められたときは、/permissionsの画面から、最近止められた操作を確認できます。ManualやAccept editsのモードでコマンドの確認が出たときに「Yes, and switch to auto mode」を選ぶと、そのコマンドを許可してAutoモードに切り替えることもできます。

CLAUDE.md・よく使うコマンド

CLAUDE.mdで毎回のルールを伝える

CLAUDE.mdは、Claude Codeが会話を始めるたびに最初に読むメモです。「テストはこのコマンドで動かす」「このフォルダは触らない」「文章はです・ます調で書く」のように、毎回伝えたいことを書いておくと、いちいち説明しなくても守ってもらえます。

作業フォルダで/initと入力すると、フォルダの中身をもとにCLAUDE.mdのひな形を作ってくれます。それをもとに、自分で書き足したり削ったりして育てていくのが基本の使い方です。書いた内容が読み込まれているかは、/contextで確認できます。

CLAUDE.mdは、置く場所によって効く範囲が変わります。

CLAUDE.mdに書くこと・書かないこと

公式のベストプラクティスでは、CLAUDE.mdは短く、人が読んで分かる形に保つよう勧められています。長すぎると大事なルールが埋もれて、守られなくなるからです。1行ごとに「この行を消したら、Claudeは間違えるだろうか？」と考え、そうでなければ消す、という基準が紹介されています。

何度伝えても守られないルールがある場合は、ファイルが長すぎてルールが埋もれている可能性があります。どうしても守ってほしい1行だけに「IMPORTANT」のような強調をつける方法も紹介されていますが、強調する行が多すぎると、どれも目立たなくなります。

中小企業の社内ツールなら、たとえば次のような短いCLAUDE.mdで十分です（説明のための架空の例です）。

# このフォルダについて
- 受注データを集計して、月次の一覧表（Excel）を作る社内ツール

# 作業のルール
- 説明と報告は日本語で、です・ます調で書く
- 「元データ」フォルダの中のファイルは読むだけにして、変更・削除しない
- 集計の結果は「出力」フォルダに保存する
- 変更したら、python3 test_集計.py を実行して、すべて通ることを確かめる

# 注意
- 金額は税込で扱う。税抜の列は使わない
- 取引先コードは先頭の0を消さない（文字列として扱う）

いったん書いたら、Claudeの動きを見ながら見直していきます。同じ指摘を何度もしているなら、それはCLAUDE.mdに書くべき内容です。逆に、書かなくてもClaudeが正しくできていることは消して構いません。

Claudeが自分でとるメモ（自動メモリ）

CLAUDE.mdが「人が書くルール」なのに対して、自動メモリは「Claudeが自分で書くメモ」です。作業の中で分かったことや、あなたから受けた指摘などを、Claudeが次の会話のために書き残します。手元で使う場合は、初期設定でオンになっています。

自動メモリのオン・オフや、書かれた内容の確認は/memoryで行えます。覚えてほしくない内容が残っていたら、ここで確認して整理しましょう。

また、CLAUDE.mdの中に@ファイルのパスと書くと、別のファイルの内容を読み込ませることもできます。長い説明は別のファイルに分けておくと、CLAUDE.mdを短く保てます。

くり返しの手順は「スキル」にまとめる

毎回同じ手順を説明しているなら、スキルにまとめておくと便利です。スキルは、手順やチェックリストを書いたSKILL.mdというファイルで、.claude/skills/スキル名/SKILL.mdに置くと、/スキル名で呼び出せるようになります。関係のある作業のときは、Claudeが自分で使うこともあります。

CLAUDE.mdとの違いは、読み込まれるタイミングです。CLAUDE.mdは毎回読み込まれますが、スキルは使うときだけ読み込まれます。そのため、長い手順書をスキルにしても、ふだんの会話の容量をほとんど使いません。公式ドキュメントでも、CLAUDE.mdの一部が「事実」ではなく「手順」になってきたら、スキルに移すことが勧められています。

Claude Codeには、最初から入っているスキルもあります。たとえば/code-reviewは変更内容の不具合を確認し、/doctorは設定の問題を診断します。

CLAUDE.mdがうまく効かないとき

CLAUDE.mdに書いたのに守られない、という場合は、次の点を確認します。

• 読み込まれているか：/contextで、CLAUDE.mdが読み込まれているかを確かめる
• 長すぎないか：ルールが多すぎると埋もれる。言わなくてもできていることは消す
• 書き方があいまいでないか：CLAUDE.mdに書いてあることをClaudeが質問してくる場合は、書き方が分かりにくい可能性がある
• 古い内容や矛盾がないか：/doctor prompt-auditで、CLAUDE.mdやスキルに古い指示や矛盾する指示がないかを確認できる

公式ドキュメントでは、CLAUDE.mdを「コードと同じように扱う」よう勧めています。うまくいかないときに見直し、定期的に削り、変更したらClaudeの動きが本当に変わったかを確かめる、という扱い方です。プロジェクトのCLAUDE.mdをGitで共有すれば、チームのみんなで育てていけます。

起動するときのコマンド

ターミナルでClaude Codeを起動するときのコマンドは、次の5つを覚えておけば十分です。

• claude：対話の画面を開く
• claude "依頼"：最初の依頼を入れた状態で対話の画面を開く（例：claude "ビルドのエラーを直して"）
• claude -p "依頼"：1回だけ答えを出して終わる。スクリプトに組み込むときに使う
• claude -c：そのフォルダで最後に使っていた会話の続きから始める
• claude -r：過去の会話を選んで再開する

作業中に使うコマンド

Claude Codeを起動した後は、入力欄に「/」から始まるコマンドを入力して操作します。「/」だけ入力すると、使えるコマンドの一覧が表示されます。

覚えておくと便利な操作

• /：使えるコマンドとスキルの一覧を出す
• Tab：コマンドの入力を補完する
• ↑：前に入力した内容を呼び出す
• Shift+Tab：権限モードを切り替える
• Esc：作業を止める
• Escを2回（入力欄が空のとき）：やり直しのメニューを開く
• Ctrl+G：Planモードで作った計画を、テキストエディタで開いて直接書き直す（ターミナル）
• Ctrl+Dを2回：Claude Codeを終了する

コマンドは追加や変更が多いので、最新の一覧は/helpか公式のコマンド一覧で確認してください。

うまく使うコツ

公式のベストプラクティスの多くは、ひとつの前提から来ています。それは、会話が長くなるほど、Claudeの精度が落ちるということです。Claudeが一度に覚えておける量（コンテキスト）には限りがあり、読んだファイルや実行したコマンドの結果もすべてそこに入ります。いっぱいに近づくと、最初の指示を忘れたり、間違いが増えたりします。以下のコツは、この点を意識すると理解しやすくなります。

調べる→計画する→作る→保存する、の順で頼む

いきなり作業させると、見当違いの問題を解いてしまうことがあります。公式のベストプラクティスでは、次の4段階で進めることが勧められています。

1. 調べるPlanモードにして、関係するファイルを読ませます。この段階ではファイルは変更されません。例：「受注データの読み込みと集計の部分を読んで、どう動いているか理解して」
2. 計画する何をどう変えるのか、計画を出してもらいます。例：「取引先ごとの集計を追加したい。どのファイルをどう変える必要がある？計画を作って」。ターミナルではCtrl+Gで計画をエディタで開いて、直接書き直すこともできます。
3. 作る計画を承認するか、Shift+TabでPlanモードを抜けて、作業させます。例：「計画どおりに実装して。テストを書いて実行し、失敗したら直して」
4. 保存するGitを使っている場合は、変更の内容が分かるメッセージをつけて記録してもらいます。例：「分かりやすいメッセージをつけてコミットして」

ただし、計画にも手間がかかります。公式ドキュメントでは、変更の内容を1文で説明できるような小さな修正なら、計画は省いてよいとされています。誤字の修正や、変数の名前の変更などは、そのまま頼めば十分です。計画が役に立つのは、進め方に迷うとき、複数のファイルにまたがる変更、よく知らないプログラムを変えるときです。

具体的に頼む

Claudeは意図をある程度くみ取ってくれますが、心を読めるわけではありません。どのファイルで、何を、どうなれば完成かを書くほど、やり直しが減ります。

一方で、「このファイルで改善できるところは？」のようなあいまいな質問が役に立つ場面もあります。自分では思いつかない点を挙げてもらえるので、調べものの段階では気軽に聞いてみてください。

完成を確かめる方法を渡す

公式のベストプラクティスで最初に挙げられているのが、Claudeが自分で結果を確かめられる手段を渡すことです。Claudeは「できたように見えた」ところで作業を止めます。確かめる手段がないと、間違いに気づくのはあなたの役目になります。

確かめる手段には、テスト、ビルド（プログラムを組み立てる処理）が通るか、期待する結果との比較、見本の画面のスクリーンショットなどがあります。「〇〇のテストを実行して、通るまで直して」と頼めば、Claudeは作業→確認→修正を繰り返します。

さらに、「できました」という報告だけで済ませず、実行したコマンドとその結果、テストの出力、スクリーンショットなどの証拠を見せてもらうことも勧められています。証拠を見る方が、自分で確かめ直すより早く済みます。

完成の条件を最後まで守らせる

確かめる手段を、どのくらい強く守らせるかも選べます。公式のベストプラクティスでは、次のような段階が紹介されています。

• 1回の依頼の中で：「テストを実行して、通るまで直して」と依頼文に書く。どんな作業でもすぐ使える
• 会話全体を通して：/goalで完成の条件を設定すると、別の評価役が毎回の作業のあとに条件を確かめ、満たすまでClaudeが作業を続ける
• 仕組みとして：フック（決まったタイミングで自動で動く仕組み）で、確認のスクリプトが通るまで作業を終われないようにする

最初は1つめの「依頼文に書く」方法で十分です。人が見ていない間も作業を正しく終わらせたくなったら、/goalやフックを検討しましょう。

関係のない作業の間は会話をリセットする

1つの作業が終わって、関係のない別の作業に移るときは、/clearで会話をリセットします。前の作業の内容が残ったままだと、Claudeの注意がそれたり、精度が落ちたりします。

同じ作業を続けたいけれど会話が長くなった場合は、/compactで要約して容量を空けます。/compact 集計の変更点を中心にのように、残してほしい内容を指定することもできます。会話の流れに残す必要のない、ちょっとした質問には/btwが便利です。答えは会話の履歴に入らないので、容量を使いません。

2回直しても違うときは、やり直す

同じ問題で2回以上修正を頼んでもうまくいかない場合、会話の中に失敗した方法がたまっている状態です。公式ドキュメントでは、/clearで会話をリセットし、それまでに分かったことを盛り込んだ依頼文で最初からやり直すよう勧めています。修正を重ねた長い会話より、よく考えた依頼文で始めた新しい会話の方が、ほとんどの場合うまくいくとされています。

チェックポイントで元に戻す

Claude Codeは、依頼を送るたびに、その時点のファイルの状態を自動で記録しています（チェックポイント）。入力欄が空のときにEscを2回押すか、/rewindと入力すると、やり直しのメニューが開きます。

• 会話とファイルの両方を、その時点に戻す
• 会話だけを戻す（ファイルは今のまま）
• ファイルだけを戻す（会話は今のまま）
• そこから先、またはそこまでの会話を要約して、容量を空ける

チェックポイントは会話と一緒に保存されるので、ターミナルを閉じて後で再開しても使えます。ただし、Claudeがコマンドで変更した分（ファイルの削除や移動など）は記録されません。公式ドキュメントでも「Gitの代わりではない」と書かれているので、大事な作業はGitで記録しながら進めましょう。

調べものはサブエージェントに任せる

Claudeがたくさんのファイルを読んで調べると、そのぶん会話の容量が使われます。「サブエージェントを使って、〇〇の仕組みを調べて」と頼むと、別の会話の中で調べて、結果の要約だけを返してくれます。メインの会話の容量を、実際の作業のために残しておけます。

大きな機能をつくるときは、先にClaudeにインタビューしてもらう方法も紹介されています。「〇〇を作りたい。細かい点まで質問して、終わったら仕様をSPEC.mdにまとめて」と頼むと、自分では考えていなかった点まで質問してくれます。仕様ができたら、新しい会話でその仕様をもとに作業させます。

先輩に聞くように質問する

Claude Codeは、作業を任せるだけでなく、プログラムについて質問する相手としても使えます。公式のベストプラクティスでは、「経験のあるエンジニアに聞くような質問を、そのままClaudeにすればよい」と紹介されています。

• ログはどこに、どうやって記録されている？
• 新しい画面を追加するには、どのファイルを触ればいい？
• この関数は、どんな例外的なケースに対応している？
• なぜここでは、この書き方をしている？

特別な書き方は必要ありません。社内に詳しい人がいない場合でも、まず自分で調べられる手段として役に立ちます。

ターミナルから1回だけ頼む

ターミナルでは、対話の画面を開かずに、1回だけ依頼して結果を受け取ることもできます。claude -p "このプロジェクトが何をするものか説明して"のように使います。エラーのログを渡して原因を聞く、cat error.log | claude -p "このエラーを説明して"のような使い方も公式に紹介されています。

この使い方は、決まった作業をスクリプトに組み込むときの土台になります。ただし、確認の画面が出ない形で動くため、どの操作を許可するかを事前に決めておく必要があります。慣れるまでは、対話の画面で使う方が安全です。

モデルと思考の深さを選ぶ

Claude Codeでは、/modelで使うモデルを切り替えられます。Anthropicのアカウントで使う場合、主な選択肢は次のとおりです。

モデルとは別に、/effortで「思考の深さ（effort）」も調整できます。公式ドキュメントでは、低くすると簡単な作業が速く安く済み、高くすると難しい作業でより深く考える、と説明されています。上のクラスのモデルや深い思考は、そのぶん使用量も多く消費するので、作業の難しさに合わせて選びましょう。

別の会話に見直してもらう

Claudeは、自分が書いたものを見直すとき、どうしても自分の考えに引っ張られがちです。公式のベストプラクティスでは、書く役と見直す役を別の会話に分ける方法が紹介されています。

1. 会話Aで作る「申込データの集計機能を作って」と頼みます。
2. 会話Bで見直す新しい会話で「@集計.py の実装を見直して。例外的なデータ、計算の誤り、既存の書き方との違いを確認して」と頼みます。
3. 会話Aで直す会話Bの指摘を会話Aに渡して、「この指摘に対応して」と頼みます。

同じことを、サブエージェントに見直しを頼む形でもできます。ただし、「問題を探して」と頼まれた見直し役は、問題がなくても何かしら指摘しがちだと公式ドキュメントでも注意されています。正しさや要件に関わる指摘だけを挙げるよう頼み、それ以外は参考程度に扱いましょう。

テストでも同じ考え方が使えます。公式ドキュメントでは、1つの会話でテストを書かせ、別の会話でそのテストを通すプログラムを書かせる方法も紹介されています。テストを書く役とプログラムを書く役が分かれるので、テストが「今のプログラムに合わせただけのもの」になりにくくなります。何を確かめるテストなのかは、人が読んで納得できるかを見ておきましょう。

会話に名前をつけて、続きから再開する

作業が1日で終わらないときは、/renameで会話に分かりやすい名前をつけておくと便利です。次の日はclaude -c（claude --continue）で最後の会話の続きから、claude -r（claude --resume）で一覧から選んで再開できます。同じ説明を繰り返す必要がありません。

業務での使い方の例

Claude Codeは、エンジニアだけの道具ではありません。ここでは、中小企業の業務で使いやすい例を紹介します。どれも一般的な使い方の例で、実際に使うときは、扱うデータや社内のルールに合わせて調整してください。

業務用の作業フォルダの整え方

業務でClaude Codeを使うときは、作業フォルダの整え方で、使いやすさと安全さが大きく変わります。次のような形にしておくと、Claudeにも人にも分かりやすくなります。

• 仕事ごとにフォルダを分ける：「申込集計」「サイト修正」のように、1つの仕事に1つのフォルダ。関係のないファイルを混ぜない
• 元データと出力を分ける：「元データ」「出力」のようにフォルダを分け、元データは読むだけ、とCLAUDE.mdに書いておく
• 見本を置く：完成形の見本（前回の集計表や、デザインの画像）を置いておくと、毎回説明しなくて済む
• 不要な機密情報を置かない：個人情報やパスワードが入ったファイルは、作業に必要なければフォルダに入れない
• Gitで記録する：変更の履歴が残り、いつでも前の状態に戻せる

フォルダの中身が整理されているほど、Claudeが余計なファイルを読まずに済み、会話の容量も節約できます。

社内の小さなツールを作る

たとえば「毎月、申込フォームから書き出したCSVを開いて、担当者ごとに件数を数えて表にしている」という作業があるとします。Claude Codeに「このCSVを読み込んで、担当者別・月別の件数を集計し、Excelファイルに出力するプログラムを作って」と頼めば、集計の仕組みを作ってくれます。

ポイントは、最初に見本のデータと、完成形のイメージを渡すことです。「元データ.csvを読んで、出力の見本.xlsxと同じ形の表を作って。集計した件数が元データの行数と一致することを確かめて」のように頼むと、Claude自身が結果を確かめながら進めてくれます。

Excel・CSVのデータを整える

複数の部署から集めたデータは、列の名前がばらばら、日付の書き方が違う、同じ取引先が別の名前で登録されている、といったことがよくあります。Claude Codeに整理の仕組みを作ってもらうと、毎回の手作業を減らせます。

• 列の名前や順番をそろえて、1つのファイルにまとめる
• 日付や電話番号の書き方を統一する
• 重複していそうなデータを洗い出して、一覧にする（消すかどうかは人が判断する）
• 集計した結果を、決まった形のExcelで出力する

元のファイルは必ずコピーを取ってから使い、「元のファイルは変更せず、結果は別のファイルに保存して」と伝えておきましょう。

Webサイトの文言や表示を直す

自社のホームページのファイルを手元に持っている場合は、文言の修正や、表示の崩れの修正も頼めます。「会社概要のページの住所を新しいものに変えて」「スマホで見たときにメニューが重なるので直して」のように頼み、変更後の画面を自分の目で確認します。

デスクトップアプリでは、開発用のサーバーを動かすと、アプリの中のブラウザの画面でサイトを表示でき、Claudeもその画面を見ながら確認と修正を繰り返せます。公開中のサイトをいきなり直すのではなく、手元で確認してから反映する流れにしましょう。

引き継いだプログラムの中身を説明してもらう

前任者が作ったプログラムや、外部の会社に作ってもらったシステムの中身が分からない、という悩みにも使えます。公式のベストプラクティスでも、新しいプログラムに慣れるための使い方として紹介されています。

• このプログラムは全体として何をしている？
• 毎月の請求書のデータはどこで作られている？
• この設定を変えると、どこに影響がある？
• このエラーが出たとき、どこを見ればいい？

説明してもらった内容をもとに、「このプログラムの使い方と、困ったときの確認手順を、社内向けの資料にまとめて」と頼めば、引き継ぎ用の資料づくりにも役立ちます。

テストや説明書を整える

社内のツールを長く使い続けるには、動作を確かめるテストや、使い方の説明書が欠かせません。どちらも後回しにされがちですが、Claude Codeに頼めば手間をかけずに整えられます。公式のクイックスタートでも、次のような依頼が例に挙がっています。

• 計算の関数について、テストを書いて
• READMEにインストールの手順を追記して
• 私の変更を見直して、改善点を提案して

テストがあると、次にClaudeにプログラムを直してもらうときも、「テストがすべて通ること」を完成の条件として渡せます。説明書があると、担当者が替わったときの引き継ぎも楽になります。

決まった作業を定期実行に乗せる

毎日・毎週同じ作業をしているなら、決まった時間に自動で動かすこともできます。公式ドキュメントでは、3つの方法が紹介されています。

手元のファイルを使う作業ならデスクトップの定期タスク、パソコンを閉じていても動かしたいならクラウドのRoutines、作業中に一時的に繰り返したいなら/loop、という使い分けです。デスクトップの定期タスクは、アプリが開いていてパソコンが起きている間だけ動く点に注意してください。

例：月次の集計ツールを作るときの流れ

総務の担当者が、毎月手作業で行っている申込データの集計を、Claude Codeで仕組みにする場合を例に、流れを追ってみます（説明のための例です）。

1. 作業用のフォルダを用意する「申込集計」というフォルダを作り、先月分のCSVのコピーと、いつも作っている集計表の見本を入れます。個人情報の列は、必要なければ消しておきます。
2. 中身を説明してもらうClaude Codeをこのフォルダで起動し、「このCSVと見本のExcelを見て、どんな集計をすればよいか説明して」と頼みます。Claudeの理解がずれていれば、ここで直します。
3. 計画を立ててもらうPlanモードにして、「CSVを読み込んで見本と同じ表を作るプログラムを作りたい。計画を出して」と頼みます。使う言語や出力の形を確認し、問題なければ承認します。
4. 作って、確かめてもらう「計画どおりに作って。担当者別の件数の合計が、CSVの行数と一致することを確かめて」と頼みます。Claudeがプログラムを作り、実行して結果を確かめます。
5. 人が結果を確かめるできあがった表を、これまで手作業で作った先月分の表と見比べ、数字が合っているかを確認します。
6. ルールを書き残す「元データのフォルダは変更しない」「金額は税込で扱う」など、途中で伝えたルールをCLAUDE.mdにまとめてもらいます。翌月からは、CSVを置き換えて実行するだけで済みます。

人が行うのは、データを用意すること、Claudeの理解と計画を確かめること、最後の数字を確かめることです。作業そのものはClaudeに任せ、判断と確認は人が持つ、という分け方にすると安心して使えます。

うまくいかないときの立て直し方

業務で使っていると、思ったような結果にならない場面も出てきます。よくある状況と、立て直し方の目安をまとめました。

どの場合も、「うまくいかなかった理由」を考えて、依頼文やCLAUDE.mdに反映していくと、次第にやり直しが減っていきます。

社内で使うときの注意点

Claude Codeは、実際にファイルを書き換えたりコマンドを実行したりする道具です。個人で試すぶんには気軽に使えますが、会社の仕事で使う前に、いくつかのルールを決めておきましょう。

任せる前に確認したいこと

新しい作業をClaude Codeに任せる前に、次の点を確認しておくと、トラブルを防げます。

• 間違っていたときに、すぐ気づける作業か（結果を確かめる方法があるか）
• 間違っていたときに、すぐ元に戻せる作業か（Gitやコピーがあるか）
• 作業フォルダに、渡してはいけない情報が入っていないか
• 社外への送信や、本番への反映など、取り消せない操作が含まれていないか

すべて問題なければ、気軽に任せて構いません。取り消せない操作が含まれる場合は、そこだけは人が行うように分けておきましょう。

扱ってよいデータを決める

Claudeのデータの扱いは、プランによって適用される規約が違います。公式ドキュメントによると、Free・Pro・Maxは個人向けの規約（Consumer Terms）、Team・Enterprise・APIは法人向けの規約（Commercial Terms）が適用されます。個人向けのプランでは、データを学習に使わせるかどうかを、プライバシーの設定でいつでも変えられます。

会社として、どのプランで、どんなデータをClaude Codeに読ませてよいかを決めておきましょう。顧客の個人情報や、未公開の数字など、渡してはいけない情報もあわせて決めておくと、使う人による判断のばらつきを防げます。

変更は必ず人が確認する

公式のセキュリティのページには、提案されたコードやコマンドを、承認する前に安全かどうか確認するのは利用者の責任だと明記されています。Autoモードの安全確認があっても、最終的な確認は人が行う前提です。

特に、社外に公開するもの（Webサイトなど）や、お金や顧客の情報に関わる処理は、必ず担当者が中身を確認してから反映するルールにしておきましょう。

社員の個人契約で業務データを扱わない

社員が個人でProを契約して、会社のプログラムやデータを扱う形は、情報の管理が難しくなります。誰がどのデータを読ませたのか、退職したときにどうするのか、といった管理ができないためです。業務で使う場合は、TeamやEnterpriseなど、会社で管理できるプランを使いましょう。

読み込ませる情報にも注意する

Webページや外部から届いたファイルの中に、AIをだますための指示が書かれていることがあります（プロンプトインジェクション）。公式ドキュメントでは、信頼できない内容を扱うときの注意として、提案されたコマンドを承認前に確認する、信頼できない内容をそのままClaudeに流し込まない、重要なファイルへの変更を確認する、外部のサービスとやりとりする作業は仮想マシンで動かす、といった点が挙げられています。

また、初めて開くフォルダでClaude Codeを起動すると、そのフォルダを信頼してよいかを確認する画面が出ます。他人から受け取ったプログラムのフォルダでは、中身が分からないうちに安易に信頼しないようにしましょう。

外部のツールとつなぐときの注意

Claude Codeは、MCP（AIとほかのツールをつなぐための共通の仕組み）を使って、Notion・Figma・データベースなどの外部のツールとつなげられます。便利な反面、つないだ先のデータをClaudeが読んだり書いたりできるようになります。

公式ドキュメントでは、自分で作ったMCPサーバーか、信頼できる提供元のものを使うよう勧められています。AnthropicはClaudeのコネクタの一覧に載せる前に審査をしていますが、セキュリティの監査まではしていないとも書かれています。社内で使う場合は、つないでよいツールの範囲も決めておきましょう。

使用量と費用を管理する

Claude Codeの使用量は、Claudeのチャットなどと同じ利用枠から使われます。今の使用状況とプランの上限は/usageで確認できます。上限に達したときは、使用量クレジットを追加購入するか、TeamやEnterpriseのメンバーであれば管理者に依頼することもできます（/usage-credits）。

APIのアカウント（Claude Console）で使う場合は、使った分だけの従量課金になります。初回のログイン時に、Console側に「Claude Code」というワークスペースが自動で作られ、費用をまとめて確認できるようになっています。会社で使うときは、誰がどのくらい使っているかを定期的に確認し、予算の上限を決めておくと安心です。

小さく試してから広げる

いきなり全社で使い始めるより、次のような順番で進めると失敗が少なくなります。

1. 試す人と作業を決めるくり返しの多い作業を持っている1〜2人と、対象の作業を1つか2つに絞ります。
2. コピーしたデータで試す本番のデータではなく、コピーや、個人情報を消したデータで使い勝手を確かめます。
3. ルールを決める使ってよいプラン、渡してよいデータ、使ってよい権限モード、確認の手順を決めます。
4. 使い方をそろえるうまくいった依頼文や、CLAUDE.mdの書き方を共有します。
5. 効果を確かめて広げる作業時間がどう変わったか、確認の手間はどうだったかを振り返り、効果が見えた作業から広げます。

社内ルールの文例

決めたルールは、短い文書にして社内で共有しておくと、使う人による差が出にくくなります。たとえば次のような形です（説明のための架空の例です。自社の状況に合わせて書き換えてください）。

Claude Code 利用ルール（総務部）

1. 会社で契約したTeamプランのアカウントで使う。個人契約のアカウントで業務のファイルを扱わない
2. 顧客の個人情報、パスワード、APIキーが入ったファイルは、作業フォルダに置かない
3. 権限モードは、原則としてManualまたはPlanで使う。Autoを使う作業は、事前に担当者の了承を得る
4. Webサイトや本番のシステムに反映する前に、作業した本人以外の1人が変更内容を確認する
5. 作業の前に、Gitで記録するか、フォルダのコピーを取る
6. 外部のツール（MCP・コネクタ）をつなぐときは、事前に担当者に相談する
7. 困ったとき、おかしな動きをしたときは、すぐに担当者へ連絡する

ルールは最初から完璧である必要はありません。小さく使い始めて、困った点が出てきたら足していく形で十分です。

よくある質問

まとめ

Claude Codeは、使い方のコツをつかむほど任せられる範囲が広がる道具です。まずは練習用のフォルダで質問や小さな修正を繰り返し、Claudeの進め方に慣れるところから始めてみてください。

社内への導入や、権限・ルールの決め方、社員の方向けの使い方の研修などで迷ったときは、INTERCREATE JAPANのClaude Code導入支援もご利用いただけます。