---
title: read - ファイル読み取り
description: ファイル内容の読み取り
---

ファイルの内容を読み取ります。テキストファイル、PDF、Office ドキュメント（Word / Excel / PPT）、画像（メタデータを返す）などに対応しています。

## 依存関係

追加の依存関係は不要で、デフォルトで利用可能です。

## パラメータ

| パラメータ | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `path` | string | はい | ファイルパス。相対パスはワークスペースディレクトリを基準とします |
| `offset` | integer | いいえ | 開始行番号（1始まり）。負の値は末尾から数え、`-50` なら最後の50行 |
| `limit` | integer | いいえ | 読み取る行数 |
| `pages` | string | いいえ | PDF のみ有効。`3`、`1-5`、`10-` のようなページ範囲。デフォルトは先頭20ページ、1回あたり最大20ページ |

## 出力形式

各行の先頭に行番号と縦線が付きます。Agent が位置を特定しやすく、`search_files` の出力とも揃えるためです：

```
1|from config import conf
2|
3|def main():
4|    print(conf())
```

<Note>
  行番号は表示用であり、ファイルの内容ではありません。`edit` で編集する際、`oldText` / `newText` に `1|` のような接頭辞を含めないでください。含めると拒否されます。
</Note>

1回の読み取りは 2000 行または 50KB が上限です。超過分は切り詰められ、末尾に `offset` で続きを読む方法が示されます。

## 認証情報の保護

API キーを保管する `~/.cow/.env` は本ツールでは読み取れません。`env_config` ツールをご利用ください。

## ユースケース

- 設定ファイルやログファイルの閲覧
- コードファイルの読み取りと分析
- PDF、Word、Excel からのテキスト抽出
- 画像・動画ファイルの情報確認
