Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

TaskOutput ツールが非推奨になりました。バックグラウンドタスクの出力ファイルパスに対して Read を使用することを推奨します。

原文（英語） ​

Deprecated TaskOutput tool in favor of using Read on the background task's output file path

概要 ​

バックグラウンドタスクの出力を取得するための TaskOutput ツールが非推奨（deprecated）になりました。代わりに、バックグラウンドタスクが出力するファイルのパスに対して Read ツールを直接使用することが推奨されます。この変更により、よりシンプルで一貫したファイル操作が可能になります。

基本的な使い方 ​

従来の方法（非推奨） ​

python
# TaskOutput ツールを使用（非推奨）
result = task_output(task_id="task-123")

推奨される新しい方法 ​

python
# バックグラウンドタスクの出力ファイルパスを Read で読む
result = read(file_path="/path/to/task/output/task-123.txt")

バックグラウンドタスクは出力をファイルに書き込むため、そのファイルパスを直接 Read ツールで読み込みます。

実践例 ​

バックグラウンドエージェントの出力確認 ​

エージェント SDK でバックグラウンドタスクを起動し、その出力を確認する：

python
# バックグラウンドタスクを起動
task = agent.spawn_background_task("長時間かかる処理を実行してください")

# タスクの出力ファイルパスを取得
output_path = task.output_file_path

# 処理完了後に Read ツールで結果を読み込む
result = read(file_path=output_path)
print(result)

CLAUDE.md での指示 ​

エージェントへの指示を記述する場合：

markdown
# バックグラウンドタスクの出力確認方法

バックグラウンドタスクの結果を確認するには：
1. タスクの出力ファイルパスを記録する
2. タスク完了後に Read ツールでそのパスを読み込む

例：
- 出力ファイル: `/tmp/claude-tasks/task-abc123/output.txt`
- 読み込み: Read("/tmp/claude-tasks/task-abc123/output.txt")

移行パターン ​

TaskOutput から Read への移行例：

python
# Before（非推奨）
def get_task_result(task_id):
    return task_output(task_id=task_id)

# After（推奨）
def get_task_result(output_file_path):
    return read(file_path=output_file_path)

注意点 ​

  • TaskOutput ツールはまだ動作しますが、将来のバージョンで削除される可能性があります
  • バックグラウンドタスクの出力ファイルパスは、タスク起動時に返されるか、タスクオブジェクトから取得できます
  • Read ツールを使用することで、部分的な読み込み（offset / limit パラメータ）や大きな出力の扱いが容易になります
  • 既存のコードで TaskOutput を使用している場合は、早めに Read ベースの実装に移行することを推奨します

関連情報 ​