Claude Codeをタスク運用で回す方法:会話よりファイル管理が楽になる理由

Written by Ubuntu×AI実践ノート Ubuntu、Claude Code、AI作業環境の構築と実践を記録するブログ

この記事の流れ
  1. この記事でわかること
  2. 想定読者
  3. 会話依存の運用で起きること
  4. taskとlogで管理する考え方
  5. taskファイル:Claude Codeへの指示書
  6. logファイル:実施記録の保存先
  7. このやり方の利点
  8. 始めるのに必要なもの
  9. まとめ
  10. あわせて読みたい

Claude Codeを使い始めると、最初はチャットで「これをやって」と頼む形になります。それでも十分動きますが、しばらく続けると気になることが出てきます。会話をまたいで前後の文脈が途切れたり、何を依頼したか振り返りにくくなったりすることです。

この記事では、私がたどり着いた「taskとlogで運用する」という考え方を紹介します。


この記事でわかること

  • 会話依存のClaude Code運用が抱える課題
  • taskファイルとlogファイルを使った運用の考え方
  • task・logそれぞれに何を書くか

想定読者

  • Claude Codeを日常的に使っている方
  • 会話の引き継ぎや履歴管理に悩んでいる方
  • Claude Codeをより組織的に使いたい方

会話依存の運用で起きること

チャット形式でClaude Codeに依頼し続けると、こういった状況が起きやすくなります。

  • 同じ指示を毎回チャットで書き直している
  • 「前のチャットでやったこと」が別のチャットでは参照できない
  • 何を依頼して、何が終わったか追いにくい
  • AIが途中でコンテキストを失い、前後の作業が噛み合わなくなる

チャットは都度の質問には向いていますが、継続的な作業管理には向いていません。


taskとlogで管理する考え方

解決策は、「指示をファイルに書き出す」ことです。チャットではなくファイルを中継点にすることで、会話をまたいでも文脈が保たれます。

taskファイル:Claude Codeへの指示書

tasks/ フォルダに、Claude Codeへの指示をMarkdownファイルとして書いておきます。ファイル名は日付と連番と概要を組み合わせます。

tasks/260312-01-記事下書き作成.md

taskファイルには以下を書きます。

  • 対象のコンテンツID(記事IDなど)
  • 実施してほしい内容(箇条書き)
  • 完了条件
  • 触ってよいファイルと触ってはいけないファイル

Claude Codeにこのtaskファイルを読ませて作業を開始させます。「このtaskを実行して」と一言渡すだけで、後は指示書通りに進みます。

logファイル:実施記録の保存先

logs/ フォルダに、Claude Codeが作業した内容を記録していきます。

logs/260312-01-記事下書き作成.md

logファイルには以下を書きます。

  • 実施日時
  • 変更したファイル一覧
  • 実施内容のサマリー
  • 未解決事項や次のアクション

次の会話でClaude Codeに「先日のlogを見て状況を確認して」と渡せば、前の作業の文脈を引き継げます。


このやり方の利点

task/log運用に切り替えると、いくつかのことが楽になります。

  • 再現性が上がる:同じ作業を別のタイミングで実行できる
  • 振り返りがしやすい:何をやったか、logを見れば分かる
  • 人間の判断を明確にできる:taskの「停止条件」に書いておけば、AIが迷ったとき自分で止まる
  • チャットの長文依頼が不要になる:ファイルに書いてあるので、口頭で長々と説明しなくてよい

始めるのに必要なもの

特別なツールは不要です。

  1. リポジトリに tasks/ フォルダと logs/ フォルダを作る
  2. taskのテンプレートを1つ作っておく
  3. 最初の1つのtaskファイルを書いて、Claude Codeに渡してみる

最初のtaskは小さなものから始めるとスムーズです。「このファイルを整形して」くらいのシンプルな作業から試してみましょう。


まとめ

Claude Codeをtask/log運用にすると、会話の文脈に頼らずに継続的な作業ができるようになります。人間はtaskを書いて結果を確認する、という役割に絞れます。

最初の一歩は、tasks/ フォルダを作ってtaskファイルを1つ書くことです。そこからClaude Codeに渡してみてください。


あわせて読みたい