Claude Codeを使い始めたけれど、ファイル全体を読み込ませてしまってトークンを無駄に消費したり、AIが全然違う場所を修正してしまったりして困っていませんか？実は、ファイルの一部だけをピンポイントで指示するテクニックを覚えるだけで、これらの悩みは一気に解決します。今回は初心者の方に向けて、開発効率を劇的に高める基本操作を分かりやすく解説しますね。
- Claude Codeで特定の行や範囲を指定してファイルを読み込ませる基本の構文
- コンテキストの消費を抑えて動作の遅延や精度低下を防ぐための目安と対策
- VS CodeやCursorなどのエディタと連携して簡単に行指定を行うショートカット
- 無駄なファイル探索を減らしAIの認識精度を極限まで高める設定ファイルの活用法
基礎から学ぶclaude codeの行指定
そもそも行指定とは何か
Claude Codeは、プロジェクトのコードを自律的に読み込んで修正してくれる非常に便利なAIツールです。しかし、何も指示をしないとファイル全体を丸ごと読み込んでしまうため、AIの頭の中（コンテキストウィンドウ）がすぐに行っぱになってしまいます。特に数千行を超えるような大規模なソースコードや、複雑なロジックが詰まったモジュールをそのまま渡してしまうと、AIはどこを基準に修正すべきか迷子になってしまい、結果として全く関係のないバグを生み出す原因にもなりかねません。
ここで重要になるのが行指定という操作です。行指定とは、AIに対して「このファイルの〇行目から〇行目だけを見てね」とピンポイントで指示を出して、読み込ませる情報量を意図的に制限する仕組みのこと。これをマスターするだけで、AIが必要な部分だけに集中できるようになり、的外れな回答や意図しないファイルの書き換えを激減させることができます。無駄なトークンの消費（コスト）も抑えられるため、初心者の方こそ、最初に覚えておきたい必須のテクニックと言えますね。
さらに、行指定を行うことで、Claudeが一度に処理するコードの密度が上がります。全体を大雑把に把握させるよりも、特定の関数やクラスの定義部分だけを抜き出して見せる方が、内部の論理構造を正確にトレースしてくれる確率がグッと高まります。開発の現場では「早く正確に直す」ことが求められますから、このアプローチはまさに実務直結の基本スキルとなるわけです。
範囲を指定してファイルを読み込む方法
具体的な範囲の指定方法はとてもシンプルです。プロンプトを入力する画面（ターミナル上のClaudeインターフェースなど）で、ファイルパスの末尾に特定の記号と行番号を付け足すだけで動作します。複雑なコマンドライン引数をいくつも覚える必要はなく、いつものファイル指定にほんの数文字を付け加えるだけなので、すぐに日常のコーディングに取り入れることができますよ。
基本的な指定パターンの例
@src/index.ts#5-10（5行目から10行目までを指定）@src/utils.ts:38-55（38行目から55行目までを指定）
このように、シャープ（#）またはコロン（:）を使って範囲を区切るだけで、指定した行だけが会話のメモリ（コンテキスト）に直接読み込まれます。長大なソースコードから特定の関数だけをレビューしてほしいときや、エラーが出ている数行のロジックだけをサクッと修正してほしいときなどに、めちゃくちゃ重宝するのでぜひ試してみてください。例えば、「@src/components/Button.tsx#20-40 のスタイル定義がおかしいから修正案を出して」といった形で、自然な指示と組み合わせて使うのがコツですね。
また、単一の行だけを指定したい場合は、#5や:38のように開始番号だけを記述すれば、その周辺の文脈を考慮しつつ該当行をターゲットにしてくれます。複数の離れた場所を指定したいときは、コマンドを分けて順次読み込ませるか、プロンプト側で「〇行目と〇行目に関連するバグ」と言い添えることで、Claude Codeの理解力をさらに引き出すことが可能です。
便利なアットマーク記法の使い方
先ほどの例にも登場した「@（アットマーク）」から始める記述は、Claude Codeにファイルをファイルとして認識させ、コンテキストにバインドするための専用の仕組みです。これを「アットマーク記法」や「ファイルメンション」と呼びます。プロジェクトの階層が深くなってくると、手動で「src/features/authentication/components/LoginForm.tsx」なんて長いファイルパスをすべて打ち込むのは大変ですが、ターミナル上で便利な補助機能が用意されているので安心してください。
たとえば、@と入力した後にTabキーを押すと、現在のワークスペース内にあるファイルやフォルダの候補がズラリと表示されるパスの補完機能が働きます。ここから矢印キーや数文字のタイピングで目的のファイルをサクッと選択できるので、タイポ（打ち間違い）をする心配がほとんどありません。また、使っているターミナル環境（MacのターミナルやiTerm2、VS Codeの統合ターミナルなど）によっては、エディタ側のサイドバーからファイルを直接ターミナル画面へドラッグ＆ドロップ（Macの場合は環境によってShiftキーを押しながらなど）することでも、綺麗に絶対パスや相対パスが挿入されるので、非常にスムーズに作業が進められますよ。
このアットマーク記法は、単にパスを入力するだけでなく、Claude Codeに対して「このリソースを静的コンテキストとして固定する」という強力なサインになります。AIが自律的にプロジェクト内を探索して余計なファイルを読み漁るのを防げるため、対話の主導権を常に人間側が握り、意図した通りのスコープで議論を展開できるようになります。
パスを自動で補完するテクニック
パスの入力ミスで「ファイルが見つかりません（File not found）」とAIに言われてしまうのは、特にCLI操作に慣れていない初心者によくある落とし穴かなと思います。大文字・小文字の違いや、スラッシュの向き、階層の数え間違いなどで引っかかってしまうと、それだけで開発のリズムが崩れてしまいますよね。これを完全に防ぐためには、先ほど紹介したTabキーによる補完機能を体に染み込ませておくのが一番の近道です。
具体的なテクニックとしては、文字を1文字か2文字打つたびにTabキーを細かく叩く癖をつけておくことです。例えば、@sまで打ってTabを押せばsrc/になり、続けてcを打ってTabを押せばcomponents/が自動で入力される、といった具合ですね。このリズム感を掴むと、タイポを完全に防ぐことができるだけでなく、なにより開発のスピード感が格段にアップします。ちょっとしたコツですが、これだけで「パスが通らない」というストレスから100%解放されるはずです。
もしプロジェクトが肥大化していて、Tabキーを押しても候補が多すぎる場合は、ファジー検索（曖昧検索）のような感覚でファイル名の一部を先に入力してからTabを押してみるのも手です。Claude CodeのCLIはモダンな開発体験を重視して作られているため、ユーザーの入力意図をかなり賢く汲み取って候補を絞り込んでくれます。ツールに任せられる部分は徹底的に任せて、人間はコードのロジックをどう組み立てるかという創造的な思考に集中していきましょう。
効率的にコンテキストを制限するメリット
行指定をしてAIに渡す情報量を制限することには、実は目に見える大きなメリットがあります。Claude Codeとの会話が長くなればなるほど、裏側で蓄積されるトークン（会話履歴）の占有率が高まっていき、処理にかかる時間（レスポンスの遅延）や料金、そしてAIの賢さそのものに影響が出始めるからです。一般的なコンテキスト（メモリ）の占有率と、それに伴う動作の目安を以下の表に分かりやすくまとめてみました。
| メモリ占有率 | 発生する挙動の目安 | 推奨されるアクション |
|---|---|---|
| 0% 〜 50% | 極めて安全で安定した状態。レスポンスも最速で、AIの推論精度が最も高く発揮されます。 | 特になし（そのまま快適に作業を続けてOK） |
| 50% 〜 70% | 少しずつ過去の会話の読み込みに時間がかかり始め、レスポンスにわずかな予兆が出ます。 | /compact コマンドでの履歴要約をそろそろ検討する |
| 70% 〜 85% | 明確な危険信号。古い記憶が曖昧になり、指示の無視やコードの先祖返りが発生しやすくなります。 | /compact を即座に実行し、直近のエラーなどに焦点を絞る |
| 85% 〜 95% | AIのエラー発生率や的外れな回答が急激に高まる領域。処理コストも最大化します。 | 不要なコンテキストを即座に整理するか、セッションの再起動を推奨 |
| 95% 〜 100% | システムによる強制的な自動要約（スライディングウィンドウ）が作動。会話の連続性が失われます。 | 過去の前提知識が消えるリスクがあるため、重要なタスクは一旦中断 |
行指定を使ってピンポイントに情報を与えていれば、このメモリの限界（コンテキスト制限）が来るのを大幅に遅らせることができます。無駄なファイルを読み込ませないことは、AIの「ど忘れ」や「勘違い」を防ぐ強力な防御策になり、結果として開発のやり直しを防いで全体の利用コストを賢く抑えることにも直結しますよ。
自動インデックスの豆知識
プロジェクト内に .indexer/skills/codebase.md のようなスキルファイルを用意し、それをプロジェクトルートの CLAUDE.md から参照させておくと、AIが無計画にファイルを探し回る行動（投機的探索）を劇的に抑えることができます。シンボルや関数のリレーション経由でコードをたどって、必要な行だけを正確に開いてくれるようになるので、コンテキストの節約と自動編集の精度向上にめちゃくちゃ効果的です。
エディタと連携して操作を簡単にする方法
いちいち行番号を確認して、わざわざターミナルに数字を打ち込むのが面倒くさいという方は、いつも使っているVS CodeやCursorなどの開発環境（IDE）と連携させてしまいましょう。公式の拡張機能や周辺プラグインを導入することで、エディタ上で普段通りコードを眺めながら、選択した範囲の行指定データを自動でClaude Codeのターミナルに転送できるようになります。
| 連携環境・拡張機能 | ショートカットキー (Mac) | ショートカットキー (Win/Linux) | 自動挿入される構文例 |
|---|---|---|---|
| 公式 VS Code / Cursor 拡張機能 | Option + K | Alt + K | @path/to/file.ts#L76-82 |
| Claude CLI Companion (サードパーティ) | Cmd + L | Ctrl + L | @src/utils.ts:38-55 |
マウスでコードをびーっと選択してキーボードのショートカットキーをポンッと押すだけで、アクティブなターミナル側へ勝手に行指定を含んだプロンプトの原型が入力されます。これなら手入力の煩わしさや行番号の見間違いから完全に解放されますね。特に大規模なリファクタリングを行うときは、複数のファイルをエディタで次々に開きながら、このショートカットを使ってClaude Codeに必要なコンテキストを素早くトスしていくスタイルが圧倒的に効率的です。
応用で広がるclaude codeの行指定
基本をマスターしたら、次はさらに快適に使いこなすための応用テクニックを見ていきましょう。プロンプトの入力時に意図せず送信されてしまうイライラを解消する方法や、AIがコードを書き換えるときのバグを防ぐ高度なハック術まで、一歩踏み込んだ設定を紹介します。
プロンプト入力時の改行バインド設定
Claude Codeのデフォルト設定では、ターミナルで Enter キーを押すとその瞬間にプロンプトが送信されてしまいます。一般的なチャットUIの感覚で、複数行にわたる箇条書きの指示を書きたいときや、エラーのログ（スタックトレース）を改行を挟んで綺麗に貼り付けたいときに、文章の途中で勝手に送信されてしまって困った経験はありませんか？不完全な指示のままAIが考え始めてしまうのは、時間もトークンももったいないですよね。
この挙動は、使用しているターミナル環境に応じたキー操作を覚えるか、設定ファイルを少し弄ることで完璧にコントロール可能です。一般的な開発環境での操作方法を以下に整理しました。
- 標準的なターミナル（iTerm2、Warp、Windows Terminalなど）: そのまま Enter を押すのではなく、Shift + Enter または Ctrl + J を押すことで、即時送信されずにターミナル内で綺麗な改行を行うことができます。
- VS Codeなどの統合ターミナル: 一度ターミナル上で
/terminal-setupという組み込みコマンドを実行してみてください。使用しているシェル（zshやbash）に適したキーバインド設定が自動的に検出・書き込みされ、以降の改行動作が劇的にスムーズになります。 - tmuxを使用している環境: ターミナルマルチプレクサであるtmuxを挟んでいる場合、キー信号の伝達経路が特殊になるため、後述の通り
~/.tmux.confに明示的な設定を書き足す必要があります。
tmux環境での注意点
外部のターミナルエミュレータ自体が Shift + Enter の入力に対応していても、tmuxを経由するとその特殊なキー信号が通常のエンターキーとして上書きされてしまうことがあります。しっかりと信号を区別させて改行を機能させるために、以下のコードを ~/.tmux.conf に追加して、設定を反映（tmux source-file ~/.tmux.conf）させておきましょう。
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'もし「どうしても使い慣れたSlackやDiscordみたいに、Enter単体では改行、Shift+Enter（またはCmd+Enter）で送信にしたい！」という場合は、ホームディレクトリにある ~/.claude/keybindings.json を直接開き、設定ファイルの中で chat:newline と chat:submit のキーバインド割当（アクション）を丸ごと入れ替えるカスタマイズも可能です。自分のタイピング癖に合わせて、ストレスのない最適な環境を構築してみてくださいね。
Windows環境での前提条件
Windows環境のローカルでClaude Codeの行参照や高度な編集機能を正しく動作させるには、Git for Windows（Git Bash環境）か、あるいは WSL（Windows Subsystem for Linux）上のUbuntuなどの環境のセットアップがほぼ必須です。ネイティブのPowerShellや旧来のコマンドプロンプトのままだと、パスの解釈まわりで「cygpath: command not found」といった特有のエラーが出てしまい、せっかくの便利な行指定機能が正常に動かなくなる原因になります。開発環境の土台はしっかり整えておきましょう。
エラーを防ぐ行番号プレフィックスの活用
AIにコードの書き換え（Editツールの実行）をお願いするとき、指示した行番号と、AIが内部で認識している実際のコードの行数が数行レベルでズレてしまい、意図しない全く別の場所が破壊されたり、コードが重複して挿入されたりする「オフバイワンエラー（1行ズレのバグ）」が起きることがあります。ファイルが大きければ大きいほどこの現象は発生しやすくなります。これをプロンプト側の工夫（力技）で完璧に解決するテクニックが、[L:XXX] プレフィックスハックです。
やり方はとても簡単で、Claudeに読み込ませるか、あるいはカスタムプロンプトとして指示を与える際、以下のようにあらかじめすべての行の先頭に元の行番号を明記したテキスト構造を意識させます。そして、メインのプロンプトでこのように厳格なルールを言い渡します。
「提供されたコードの各行には、元のソースファイルにおける厳密な行番号を示す [L:XXX] プレフィックスが付与されています。あなたがコードを変更・置換、またはEditツールで編集を加える際は、この数値を絶対的な基準にして編集範囲を指定してください。なお、[L:—] と書かれた行は既に削除済みの扱いなので、カウントから完全に無視してください。」
この一工夫を取り入れるだけで、AIが行番号を見失って頭の中で誤カウントするバグが文字通り大幅に減少します。特にClaudeのベースとなっているClaude 3.5 Sonnetは、こういった構造化された制約に対する追従性がめちゃくちゃ高いため、プレフィックスを適用する前と比べて、驚くほどピンポイントで正確なソースコード修正をしてくれるようになりますよ。泥臭いアプローチに見えますが、自動化スクリプトなどと組み合わせると最強のディフェンスになります。
自動折り返しバグへの対策と修正方法
Claude Codeには、ファイルを読み込んで画面に出力する「Readツール」という標準機能が備わっています。これを使ってファイルを読み込むと、ターミナル上での視認性を確保するために、「1152→」といった矢印付きの行番号プレフィックスが画面上で自動的に付与されます。一見すると親切で非常に見やすい機能なのですが、ここに開発コミュニティでも度々議論になるちょっとした罠（システム固有のバグ）が潜んでいるのです。
AIがこの画面表示用に自動付与されたプレフィックスの文字幅を、「本来のソースコード自体の横幅（インデントや文字数）」の一部であると勘違いしてしまうことがあります。その結果、コードを書き換えて出力する際に、55文字〜60文字程度という不自然に短い位置で、勝手に改行（ハードラップ）をバチバチと入れてしまう自動折り返しバグが報告されているのです。これが発生すると、コードの見た目がガタガタになり、シンタックスエラーにはならずとも可読性が最悪になってしまいます。
実務でのスマートな回避策
この鬱陶しい現象をスマートに解決するには、Claude Codeがコードの書き換えを完了した直後に、自動でコード整形ツール（PrettierやESLint、C++ならClang-Formatなど）をバックグラウンドで強制的に呼び出す「PostToolUse」の自動フック（Hook）を設定しておくのが一番おすすめです。AIがどれだけ変な位置で不自然に改行を入れてしまっても、フックされた使い慣れたリンターやフォーマッタが、一瞬でプロジェクトの規約に沿った正しい折り返し幅とインデントに自動修復してくれるため、人間がいちいち手動でインデントを直し直す無駄な手間が完全に省けます。
ターミナルで使える行編集のショートカット
プロンプトを長々と入力している最中に、「あ、3行前に書いたコマンドの入力を間違えた」「この行の条件式を丸ごと消して、もう一度最初から書き直したい！」となることはよくありますよね。このようなとき、キーボードの左右の矢印キー（矢印連打）を何度もカチカチ叩いてカーソルを移動させるのは、お世辞にも効率的とは言えません。シェル（Terminal）標準の行編集ショートカットキーをいくつか指に馴染ませておきましょう。これだけでClaude Codeとの対話の快適さが全然変わってきますよ。
| 操作モード | やりたいこと | キー操作・コマンド |
|---|---|---|
| Emacsモード （多くの環境でデフォルトの状態） | 現在入力している行の先頭（スタート位置）に一瞬でジャンプ | Ctrl + A |
| 現在入力している行の末尾（ゴール位置）に一瞬でジャンプ | Ctrl + E | |
| 現在のカーソル位置から、その行の末尾までを一気にすべて消去（カット） | Ctrl + K | |
| 現在のカーソル位置から、その行の先頭までを一気にすべて消去 | Ctrl + U | |
| Vimモード （ターミナルをVi/Vim化している場合、NORMALモード時） | 今フォーカスが当たっている1行を丸ごと削除（カット） | dd |
| 今フォーカスが当たっている1行を丸ごとコピー（ヤンク） | yy または Y | |
| 現在の行のすぐ下に新しい空行を追加して、そのまま挿入入力（INSERT）状態にする | o |
特にMacをメインマシンとして使っている開発者の方であれば、ターミナルエミュレータ（iTerm2など）自体のキープロファイル設定を活用して、Cmd + Backspace を押した際に入力信号として Ctrl + U が送信されるようにシステム側で紐付けておくカスタマイズがめちゃくちゃおすすめです。タイピングミスをしてしまった長文のプロンプトを、矢印キーを戻すことなく一瞬で綺麗にリセットして最初から書き直せるようになるので、思考のスピードを落とさずにコーディングを続けられて脳内がかなりスッキリしますよ。
チーム開発で役立つ厳格なリンクの作り方
もし複数人のチームで共同開発を行っていて、Claude Codeが検出してくれたコードの致命的なバグや、リファクタリングの優れた修正案を、GitHubのプルリクエスト（PR）やSlack上で他のレビュー担当者に共有・ディスカッションしたいときは、誰が見ても一発でその場所が特定できる「厳格な行指定リンク」を作るルールをプロジェクト内で徹底しましょう。テキストベースで「〇〇ファイルの真ん中あたり」と伝えるよりも、URLを踏んだ瞬間に該当コードがハイライトされる方が圧倒的に親切です。具体的には以下の3つのポイントを強く意識します。
- コミットIDの固定化: URLに含めるコミットの識別子は、
mainやdevelopといった動的なブランチ名や、省略された短いハッシュではなく、必ず40文字の完全な「フルSHAコミットハッシュ」を使って恒久的なリンク（パーマリンク）を作成します。これにより、後から他のメンバーがコードを追加しても、指定した行の位置がズレるのを防げます。 - 行指定パラメーターの厳密化: 参照元となるファイルパスの末尾に対して、GitHubの仕様に準拠する形で
#L15（15行目を単一指定）や#L15-L20（15行目から20行目までの範囲指定）のように、正確なターゲット行番号を明記してURLを組み立てます。 - コンテキスト（文脈）の保持: 指摘したい該当行そのものだけでなく、その関数が属しているクラス名や前後の条件分岐など、ロジックの流れが伝わる「前後のコンテキスト（5行〜10行程度）」を少し含めた状態でコードブロックを引用するか、あるいはリンク先の画面で見えるように調整して共有します。
このルールを徹底してリンクをフォーマットすると、GitHubやGitLabなどのリモートリポジトリ管理プラットフォーム上で、チャットに貼り付けた瞬間に「クリック可能で綺麗に装飾された行指定コード片（Code Snippet）」として美しくレンダリングされます。レビューを行う他の開発メンバーが、ブラウザから直接該当する行とその周辺コードを即座に確認できるようになるため、非同期コミュニケーションにおける不毛なすれ違いや確認コストが極限まで削ぎ落とされ、開発全体のワークフローが驚くほど円滑になりますよ。
初心者向けclaude codeの行指定まとめ
ここまで、Claude Codeにおける様々な「行指定」の基本構文から、エディタとのスマートな連携方法、コンテキストを節約するための実践的な運用、そしてチーム開発に活かせる応用テクニックまでを網羅してご紹介してきましたが、いかがでしたでしょうか？
新しくAI駆動の開発ツールを導入すると、つい「全部お任せで丸投げ」してしまいたくなりますが、Claudeにファイルを読み込ませるときの@パス#行番号というピンポイントの指定は、不要なメモリの消費を抑え、AI本来のシャープな推論精度を引き出すための、最も基本的かつ強力なディフェンス策であり最大の攻撃手段です。また、改行のキーバインド調整やターミナル上での行編集ショートカットを少しずつ指に馴染ませていくことで、ただの便利なチャットAIではなく、右腕として機能する「対話型のエージェントツール」としての真価を100%引き出せるようになります。
少し難しく感じた部分もあるかもしれませんが、まずは今日から、Claude Codeにファイルを指定する際に「Tabキーでのパス補完」を使い、ファイル名の後ろに「行番号（例：#10-30）」をちょっと付け足してみることからスタートしてみてください。それだけで、これまで体験したことがないほどスマートかつ的確にAIとコードのやり取りができるようになるのを実感できるはずです。焦らず自分のペースで、安全で快適なAI共同開発ライフを一歩ずつ進めていきましょうね！
