Claude Codeの--tools Readで内蔵ツールを読み取りに絞る — READMEの1行を10分で確認

Claude Codeをこれからターミナルで試す人向けです。AIエージェントに渡す内蔵ツールをReadに絞り、練習用READMEのStatus: readyからreadyを答えてもらいます。
macOSまたはLinuxのターミナルと、Claude Codeを利用できるアカウントが必要です。インストールから最初の1回まで、手順をそのまま追えます。
今日のゴールは、練習用の1ファイルを読み、画面にreadyが出ること。 実際の仕事のファイルには触れません。

確認日: 2026-10-16。手元ではClaude Code 2.1.299で、匿名のREADMEを使ってコマンドを実行し、終了コード0とreadyを確認しました。環境や既存の設定によって表示や確認画面が異なることがあります。

まず、何をする機能なのか

Claude Codeは、ファイルを読んだり、必要に応じて編集やコマンド実行をしたりできるAIエージェントです。AIエージェントとは、質問に文章で答えるだけでなく、許された道具を使って作業を進める仕組みのこと。ツールは、その道具です。

今回使う--toolsは、Claude Codeが利用できる内蔵ツールの種類を、その起動時に指定するオプションです。Readだけを指定すると、内蔵の編集・コマンド実行ツールなどを渡さず、ファイルを読む機能だけを使わせる形にできます。これは公式CLIリファレンスにある動作です。

「まずはAIにファイルを読ませるところまで」を試したいとき、できる操作を絞った状態から始められます。ただし、この指定をパソコン全体の完全な読み取り専用設定だとは考えないでください。公式ドキュメントは、--toolsがMCPツールには影響しないと明記しています。MCPは、Claude Codeに外部の道具を追加する連携方式です。自分でMCPサーバーを追加している環境では、その道具は別に確認が必要です。

もう一つ、この設定はAIの回答の正しさを保証するものではありません。表示された値を自分でも確かめる、という姿勢は残しておきましょう。

10分で試す全体像

やることは四つだけです。

1. Claude Codeが使えるか確認する
2. 練習用フォルダとREADMEを作る
3. --tools Readで1回質問する
4. ファイルの中身と回答を照合する

ここではCLI（文字を入力して操作する方式）を使います。ターミナルは、その文字を打つ画面です。READMEはプロジェクトの説明を書いておくファイル。今回は実在の仕事や個人情報を入れず、Status: readyという練習用の1行だけにします。

1. Claude Codeを用意する

すでに使える人はclaude --versionの確認だけで大丈夫です。以下のインストールコマンド自体は手元では再実行していません（動作未確認）。公式Quickstartの記載を確認して掲載しています。まだインストールしていないmacOS・Linuxの人は、公式Quickstartに記載された次のコマンドをターミナルで実行してください。

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

インストール後は新しいターミナルを開き、次を入力します。

claude --version

2.1.299 (Claude Code)のようにバージョンが出れば、コマンドが見つかっています。数字は更新されるので、同じ数字でなくてもかまいません。

Claude Codeの利用には、公式Quickstartに記載された利用資格とサインインが必要です。初回起動時にサインイン画面が出たら、画面の案内に従ってください。アカウントの状態を確認したいときは次のコマンドが使えます。

claude auth status --text

サインイン済みなら、その状態が表示されます。サインインを済ませられない場合は、記事の先へ進んでもAIへの質問は完了しません。先に認証を終えてから戻ってきてください。Windowsでのインストール方法は公式Quickstartに別のコマンドが載っています。ここから先のシェル例はmacOS・Linux用です。

2. 個人情報のない練習用READMEを作る

プロジェクトとは、作業対象のファイルをまとめたフォルダのことです。今回は新しいフォルダを一つ作るので、既存の仕事のリポジトリ（コードを保存・管理する場所）を使う必要はありません。

次の3行をターミナルへ貼り付けます。

mkdir -p claude-read-practice
cd claude-read-practice
printf 'Status: ready\n' > README.md

printfは文字を書き出すコマンド、> README.mdはその内容をファイルへ保存する記号です。ここでは新しい練習フォルダ内だけを使います。すでに同名のフォルダやREADMEがある場合、最後の行はREADMEを上書きします。既存のものを残したいときは、フォルダ名を別の名前に変えてください。

ファイルができたか、まず自分の目で確かめます。

cat README.md

期待する表示はこれです。

Status: ready

この段階ではまだAIは使っていません。ここが違うなら、先にファイル作成を直します。問題を「ファイル側」と「AI側」に分けると、つまずいたときに探しやすくなります。

3. Readだけを渡して、1回質問する

同じclaude-read-practiceフォルダにいる状態で、次を実行します。

claude --tools Read -p 'Read README.md and answer only the value after Status:'

コマンドの読み方を、一つずつ確認しましょう。

• claude: Claude Codeを起動します。
• --tools Read: この起動で使える内蔵ツールをReadに絞ります。今回の主役です。
• -p: 質問を1回実行して終了するための指定です。ここでは対話画面を開かず、最初の成功を短く確認する手段としてだけ使います。
• 英文の質問: READMEを読んで、Status:の後ろの値だけ答えてほしい、という意味です。

うまくいくと、画面に次のように出ます。

ready

僕の隔離した練習フォルダでは、Claude Code 2.1.299でこのコマンドが終了コード0となり、readyが返りました。モデルの文章は毎回完全に同じとは限りません。ready以外の説明が付いたときも、READMEの値を正しく読んでいるかを確認してください。値を読み間違えたなら成功扱いにせず、フォルダとプロンプトを見直しましょう。

4. 「動いた」を自分で確かめる

readyが出たら、もう一度次を実行します。

cat README.md

ファイルがStatus: readyのままで、AIの回答がreadyと一致していれば、今日の初回成功です。少し地味ですが、「渡した道具を絞る」「対象ファイルを読む」「結果を人間が照合する」という一連の流れを、個人データなしで体験できました。

なお、catでも1行は読めます。そう、1行を見るだけならAIを使う必要はありません。この記事の目的は、AIにたくさん仕事を任せることではなく、まず実行範囲を意識しながらエージェントを一度動かすことです。この小さな練習で十分な人は、ここで止めてかまいません。

よくあるつまずき

1. claude: command not foundと出る

インストール後に古いターミナルを使い続けているか、インストール先がPATH（コマンドを探す場所の一覧）に入っていない可能性があります。新しいターミナルを開いてclaude --versionをもう一度試してください。直らなければ、公式のインストール・トラブルシュートを確認します。--toolsの問題ではないので、先に起動確認だけを片付けましょう。

2. サインイン画面や利用条件の案内が出る

初回は認証が必要です。公式Quickstartの手順でサインインし、claude auth status --textで状態を確認してください。この記事は利用資格の取得や契約を代行するものではありません。認証が終わるまでは、AIの回答が出ないのが自然です。

3. README.mdが見つからない、別の答えになる

pwdで今いるフォルダを確認し、cat README.mdで中身を見直します。pwdは現在地を表示するコマンドです。先ほどのcd claude-read-practiceを実行せず、別フォルダでClaude Codeを起動すると、対象のREADMEが違うかもしれません。まずファイルの中身を固定してから、同じ質問を試します。

4. ready以外の長い回答が出る

AIの返答は完全に固定ではありません。Status:の値が答えに含まれるかを見てください。値自体が違う場合は、READMEの中身と質問の引用符を確認します。コマンドをコピーするとき、'が全角の引用符に置き換わっていないかもチェックすると見つけやすいです。

5. 「Readだけなら何も変更されない」は本当？

そこは言い切れません。--toolsが制限するのはClaude Codeの内蔵ツールです。公式CLIリファレンスではMCPツールには影響しないとされています。MCPを追加している人は、その接続先と利用可能な操作を別に確認してください。また、モデル回答が正しいかどうかも別問題です。大事なフォルダでは、権限設定や実際の差分を自分で確認する必要があります。

6. インストールはできたがコマンドの意味が不安

最初はみんな、画面のどこに何を入力するかで止まりがちです。claude --versionとcat README.mdを先に単独で試してみてください。その二つが動けば、「Claude Codeがある」「読む対象がある」が分かります。最後に--tools Readを足すと、原因を一度に抱えずに済みます。

この方法が向く人・向かない人

最初から編集を任せる前に、AIがどの道具を使える状態なのかを意識したい人には向きます。ダミーのファイルで一度成功させてから、本当に読ませたいファイルへ進むと、途中で迷いにくいです。

一方で、単にREADMEの1行を確認したいだけならcat README.mdで十分です。また、MCPや別の拡張をたくさん設定している環境で「絶対に書き込みを起こさない」と保証したい用途には、--tools Readだけでは足りません。これは公式に明記された範囲の違いです。必要な安全条件を決めてから、環境全体の設定を確認してください。

参考リンク

• Claude Code CLI reference（--tools、-p、auth status）
• Claude Code Quickstart（インストール、初回サインイン）
• Claude Code インストール・ログイントラブルシュート

公式ページ確認日: 2026-10-16。本文の実行例はmacOSの隔離フォルダで確認しました。Windowsのコマンド例はこの記事では動作未確認です。

生成AI活用エンジニア&3児のパパ。AI×開発の実践知を毎日発信しています。続きはXで。