---
title: "コーディングエージェントを夜間実行：サンドボックス・Git・コスト上限 | BroadRouter"
description: "コーディングエージェントを無人で動かすための実践的な構成。サンドボックス、Git のチェックポイント、タスクファイル、ステップ上限、朝のレビュー、定額プランセッションでの夜間実行を解説します。"
url: https://broadrouter.com/ja/blog/overnight-coding-agent-runs/
lang: ja
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。 [英語の原文を読む](https://broadrouter.com/blog/overnight-coding-agent-runs/) (2026-11-16 更新).

# コーディングエージェントを夜間に無人で安全に動かす方法

BroadNet Inference チーム · 約 5 分で読めます · 公開日 2026-11-14 · 更新日 2026-11-16

エージェントはリポジトリだけをマウントしたコンテナか VM で、専用の Git ブランチ上で動かし、ステップが完了するたびにコミットさせます。書面のタスクファイル、ステップ上限、終了時刻を与え、朝にブランチをレビューします。BroadNet の Full Moon（月 $60）のような定額プランセッションなら、最悪の場合の請求額が固定されます。

## 要点

-   まずサンドボックス：リポジトリだけをマウントし、本番の認証情報を置かないコンテナか VM。
-   エージェントごとに 1 つのブランチか Git worktree を使い、ステップごとにコミットすれば、すべての変更をレビューでき、元に戻せます。
-   完了の定義が明確なタスクファイルは、1 行のプロンプトに勝ります。
-   ステップ上限、終了時刻、繰り返しの検出で、行き詰まった実行を朝までに止めます。
-   プランセッションにはトークンのメーターがないので、一晩のエージェント作業はトークン数にかかわらずプラン料金で済みます。

**このページの内容**

1.  1\. 無人のエージェントをどうサンドボックス化しますか？
2.  2\. エージェントごとにブランチを分けるのはなぜですか？
3.  3\. タスクファイルには何を書きますか？
4.  4\. 行き詰まったエージェントを止める仕組みは？
5.  5\. 夜間はプランセッションとトークン課金のどちらが安いですか？
6.  6\. 朝、実行結果をどうレビューしますか？
7.  最初の夜、安全に試すには？

コーディングエージェントは、長くて明確で退屈な作業が得意です。50 のモジュールにテストを追加する、すべての呼び出し箇所を新しい API に移行する、1,000 件の lint 警告を直す。こうした作業は、あなたが見守る必要はありません。必要なのは、安全に動かせる場所、明確なタスク、行き詰まりを防ぐ仕組み、そしてコーヒーを飲みながら結果をレビューする方法です。

この記事は、その準備のためのチェックリストです。

## 1\. 無人のエージェントをどうサンドボックス化しますか？

無人のエージェントは、誰も承認しないシェルコマンドを実行します。いずれは、あなたなら実行しなかったこと、つまり間違ったディレクトリの削除、パッケージのインストール、リモートへの push を実行すると想定してください。閉じ込めましょう。

-   **コンテナか VM** を使い、ノートパソコンのメインのユーザーアカウントでは動かさないでください。Docker の[セキュリティドキュメント](https://docs.docker.com/engine/security/)に制御方法がまとまっています。少なくとも非 root ユーザーで実行し、不要な capabilities は外してください。
-   \*\*リポジトリだけをマウントする。\*\*ホームディレクトリ、SSH キー、クラウドの認証情報、トークンだらけの `~/.config` は渡しません。
-   \*\*本番の秘密情報は置かない。\*\*テスト用のデータベースとダミーの API キーを使います。エージェントが実際のサービスを必要とするなら、権限を絞った失効可能なキーを渡します。
-   \*\*ネットワークを制限する。\*\*エージェントに必要なのはモデルの API と、場合によってはパッケージレジストリです。それ以外が必要になることはまれです。
-   \*\*push 権限は与えない。\*\*ローカルでのコミットだけを許可し、push はレビュー後にあなたが行います。

モデルの API キーは、エージェントが必ず持つ唯一の認証情報です。この用途専用のキーを作り、プロバイダーが対応していればサンドボックスの外向き IP に限定してください。BroadNet のキーは最大 32 件の [IP 許可リスト](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)に対応しているので、キーが漏れてもほかの場所からは使えません。

## 2\. エージェントごとにブランチを分けるのはなぜですか？

専用のブランチで作業させ、`main` では絶対に作業させないでください。複数のエージェントを動かすなら、[git worktree](https://git-scm.com/docs/git-worktree) でそれぞれに作業ディレクトリを与えます。

```bash
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
```

各 worktree は同じリポジトリの別々のチェックアウトなので、エージェント同士がファイルを上書きし合うことはなく、各ブランチには 1 つのエージェントが行ったことが正確に表れます。

そして、**ステップが完了するたびにコミット**させます。Aider は既定でこれを行います。ほかのエージェントでは指示に書き込むか、テストが通るたびにコミットが行われるようループをラップしてください。小さなコミットの履歴があれば、「午前 3 時にエージェントが何かを壊した」が「コミット 14 で壊れた。1〜13 は残す」に変わります。

## 3\. タスクファイルには何を書きますか？

対話的には通用する 1 行のプロンプトも、夜間には失敗します。エージェントが最初の質問をしたときに、答える人がいないからです。タスクファイルを書いてください。

```markdown
# Task: add unit tests to src/billing/

## Goal
Every public function in src/billing/ has at least one unit test.

## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit

## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.

## Notes
Append decisions and skipped items to NOTES.md as you go.
```

重要なのは「Done when」（完了条件）の部分です。エージェントが終わったと分かる手段になり、あなたが確認する手段にもなります。ノートファイルは、実行が再起動したりコンテキストが圧縮されたりしたときの記憶としても役立ちます。[長時間動くエージェントのコンテキスト管理](https://broadrouter.com/ja/blog/long-running-agent-context-management/)を参照してください。

## 4\. 行き詰まったエージェントを止める仕組みは？

無人ということは、エージェントが行き詰まっても朝まで誰も気づかないということです。仕組みは 4 つあります。

1.  \*\*ステップ上限。\*\*タスクごとのモデル呼び出し回数に固定の上限を設けます。
2.  \*\*終了時刻。\*\*状態にかかわらず、たとえば 07:00 などの時刻で止めます。
3.  \*\*繰り返しの検出。\*\*同じツール呼び出しが同じ結果を 3 回返したとき、または一定のステップ数にわたってファイルが変わらないときに止めます。
4.  \*\*ツールごとのタイムアウト。\*\*ハングしたテストスイートで一晩を無駄にしないためです。

仕組みが作動したら、エージェントは理由をノートファイルに書き、きれいに終了するべきです。ステップ上限とリトライ上限が費用にとってなぜ重要かは、コーディングエージェントのコストガイドの[タスクごとにステップ数を制限する](https://broadrouter.com/ja/blog/cut-coding-agent-llm-costs/)で説明しています。

Aider はこの方式で簡単に動かせます。[スクリプト実行のドキュメント](https://aider.chat/docs/scripting.html)には、1 つの指示を実行して終了する `--message` オプションと、確認を自動で承諾する `--yes-always` が紹介されています。これをタスクリストに対するシェルのループで包み、各実行を `timeout` で囲めば、シンプルな夜間キューの完成です。

## 5\. 夜間はプランセッションとトークン課金のどちらが安いですか？

夜間実行では、コストの問いが変わります。誰もメーターを見ておらず、行き詰まったエージェントは何時間もループし続けることがあります。

**トークン課金のキー**では、コストはエージェントが送る量で決まります。エージェントはステップごとにコンテキストを送り直すので、8 時間の実行では積み重なります。プロンプトキャッシュは大いに役立ちます（[DeepSeek V4.1 Flash](https://broadrouter.com/ja/models/deepseek-v4.1-flash/) のキャッシュ入力は 100 万トークンあたり $0.0055、新規入力は $0.175）が、出力トークンと推論トークンは全額課金されます。実行ごとのトークン予算と、アカウントの支出上限が必要です。

**プランセッション**には、トークンのメーターがありません。Full Moon セッションは月 $60 で DeepSeek V4.1 Flash を無制限に使え、エージェントがどれだけ長く動いても、どれだけループしても、これが上限です。夜間の作業ではこれが最大の魅力です。寝る前に最悪の場合の請求額が分かっています。

|  | トークン課金のキー | プランセッション |
| --- | --- | --- |
| 行き詰まった一晩の最悪のコスト | トークンに比例して増える | プラン料金で固定 |
| 並列エージェント | 従量課金キー 1 つにつき同時 4 リクエストまで | 1 セッションにつき一度に 1 リクエスト |
| モデル | すべてのチャットモデル | DeepSeek V4.1 Flash のみ |
| 仕組みはやはり必要か | 必要（コストと時間のため） | 必要（時間のため） |

セッションについて実務上の注意が 2 つあります。1 セッションは一度に 1 リクエストを処理するので、セッションを共有する 2 つのエージェントは交代で動きます。同じセッションのタスクは順番に実行され、夜間ならたいていそれで問題ありません。エージェントを並べて動かしたいなら、エージェントごとにセッションを購入してください。計算は[定額 API での並列エージェント](https://broadrouter.com/ja/blog/run-parallel-coding-agents-flat-rate/)で扱っています。

標準的な速度 毎秒約 100 トークン なら、1 セッションで 1 か月連続使用した場合に 約 2.59億 の出力トークンを生成できます。トークン課金より得かどうかは量次第です。BroadNet がフルタイムのコーディングエージェントについて示した計算例では、従量課金で月約 $65.40 になります。自分の数字は[定額とトークン課金の比較計算ツール](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/)で試算してください。長時間の無人実行には、コンテキストの管理と、クラッシュしても続けられる再試行も必要です。[タイムアウト、再試行、チェックポイント](https://broadrouter.com/ja/blog/long-running-agents-timeouts-retries/)を参照してください。

## 6\. 朝、実行結果をどうレビューしますか？

夜間実行の価値は、レビューのときに初めて実現します。素早く済ませましょう。

1.  \*\*まず NOTES.md を読む。\*\*エージェントは何を終え、何を飛ばし、どこで行き詰まったか。
2.  \*\*停止理由を確認する。\*\*完了、ステップ上限、終了時刻、繰り返しのどれか。
3.  \*\*テストを自分で実行する。\*\*エージェントの「テストはすべて通過」という報告を信用しないでください。
4.  \*\*diff をコミットごとに読む。\*\*小さなコミットなら、まずい変更を見つけて捨てるのが簡単です。
5.  \*\*残すものを squash か rebase し、\*\*通常のプルリクエストを作成します。

たいていの朝は、作業の大部分を残し、いくつかのコミットを手で直すことになります。運の悪い朝はブランチを削除します。どちらの場合も、あなたの手を経ずに `main` に触れたものはありません。

## 最初の夜、安全に試すには？

仕様が明確なタスク 1 つ、エージェント 1 つ、セッション 1 つから始めてください。Meteor の 1 時間（$1）があれば、何かを一晩中動かす前に、サンドボックス、ブランチ、仕組みの構成が機能するか確認できます。エージェント自体については、[Aider ガイド](https://broadrouter.com/ja/guides/aider-unlimited-deepseek/)に正確な接続設定があり、[コーディングエージェントに最適なオープンモデル](https://broadrouter.com/ja/blog/best-open-model-for-coding-agents/)がモデル選びに役立ち、[プランセッションの仕組み](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)でキーとセッションを説明しています。

関連する無料ツール （英語）

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[無料ツール （英語）](https://broadrouter.com/tools/)

## この記事の用語

[AI エージェント（AI agent）](https://broadrouter.com/ja/glossary/agent/)

AI エージェントとは、言語モデルが目標に向けて自分で手順を決めるシステムです。どのツールを呼ぶかを決め、結果を読み、最終回答を出すか上限に達するまで繰り返します。決まった箇所でモデルを呼ぶ固定のスクリプトは、ふつうワークフローと呼ばれます。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[AI コーディングエージェント（AI coding agent）](https://broadrouter.com/ja/glossary/coding-agent/)

AI コーディングエージェントとは、言語モデルがループの中でコードベースに取り組むソフトウェアツールです。ファイルを読み、編集し、テストなどのコマンドを実行し、出力を読んで次の手順を決めることを、タスクが終わるか上限に達するまで繰り返します。

[API キー（API key）](https://broadrouter.com/ja/glossary/api-key/)

API キーとは、API を呼び出すクライアントを識別し、認可するための秘密の文字列です。LLM API では通常 Authorization: Bearer ヘッダーで送り、キーを持つ人は誰でも、そのキーの所有アカウントに課金されるリクエストを送れます。

[キャッシュ入力トークン（cached input tokens）](https://broadrouter.com/ja/glossary/cached-input-tokens/)

キャッシュ入力トークンとは、LLM プロバイダーが直前に処理し、再計算せずにキャッシュから再利用できるプロンプトのトークンです。通常はシステムプロンプトやドキュメントなど繰り返し送るプレフィックスで、新しい入力トークンより安い単価で課金されます。

[コンテキストエンジニアリング（context engineering）](https://broadrouter.com/ja/glossary/context-engineering/)

コンテキストエンジニアリングとは、システムプロンプト、ツール定義、履歴、検索した文書、メモなど、モデルが各リクエストで見るトークンの集合を選び、保守する作業です。タスクに必要な、最小限で情報価値の高い内容をモデルに渡すことを目指します。

[リクエストタイムアウト（request timeout）](https://broadrouter.com/ja/glossary/request-timeout/)

リクエストタイムアウト（request timeout）とは、HTTP クライアントがサーバーを待つ最長時間で、超えるとリクエストを諦めます。通常は接続タイムアウトと読み取りタイムアウトに分かれます。長い回答には時間がかかるため、LLM では読み取りタイムアウトを長めにします。

## よくある質問

### エージェントに無人でシェルコマンドを実行させても安全ですか？

捨ててもかまわないサンドボックスの中でだけ安全です。リポジトリをマウントし、秘密情報と本番の認証情報は置かず、ネットワークアクセスはタスクに必要な範囲に制限してください。

### 1 つのプランセッションで一晩にいくつのタスクを処理できますか？

1 セッションは一度に 1 リクエストを処理するので、同じセッションのタスクは順番に実行されます。1 セッションに順番に並べるか、並列で動かしたいエージェントごとにセッションを購入してください。

### 夜の間にエージェントがビルドを壊したらどうなりますか？

レビューなしに main ブランチに届くものはありません。ステップごとにコミットしていれば、どこでおかしくなったかが正確に分かり、その前の正しいコミットは残せます。

### 夜間実行に向いているのはどんなタスクですか？

仕様が明確でテスト可能な作業です。呼び出し箇所の新しい API への移行、テストのないモジュールへのテスト追加、コードベース全体の lint 修正、依存関係のアップグレードなど。自由度の高い設計作業は、人が関わりながら進めるほうが適しています。

## 続けて読む

-   [コーディングエージェントの LLM コストを削減する 10 の方法（削減額の試算付き）](https://broadrouter.com/ja/blog/cut-coding-agent-llm-costs/)
-   [定額の LLM API で並列コーディングエージェントを動かす方法](https://broadrouter.com/ja/blog/run-parallel-coding-agents-flat-rate/)
-   [長時間動くエージェントのコンテキスト管理：100 万トークンを活かす](https://broadrouter.com/ja/blog/long-running-agent-context-management/)
-   [LLM API は定額とトークン課金のどちらが得か：損益分岐の計算](https://broadrouter.com/ja/blog/flat-rate-vs-pay-per-token-llm-api/)
-   [コーディングエージェントのプロンプトインジェクション：実際に効く防御](https://broadrouter.com/ja/blog/prompt-injection-coding-agents/)
-   [AI コーディングエージェント 1 回の実行コスト：ステップ数、コンテキストの増加、キャッシュ](https://broadrouter.com/ja/blog/ai-coding-agent-run-cost/)
-   [Claude Code でオープンモデルを使う：プロキシ、ネイティブエンドポイント、制限](https://broadrouter.com/ja/blog/claude-code-with-openai-compatible-models/)
-   [ガイド：Aider を無制限の DeepSeek V4.1 Flash で動かす](https://broadrouter.com/ja/guides/aider-unlimited-deepseek/)
-   [ガイド：エージェント向け無制限 LLM API プランのしくみ](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)
-   [ガイド：IP 許可リストで API キーを自社サーバーに限定する](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)

実際のワークロードで試してください。 新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-blog-overnight-coding-agent-runs&utm_content=page-cta) ·

**出典**

-   [Docker ドキュメント、Docker Engine のセキュリティ](https://docs.docker.com/engine/security/)
-   [Git ドキュメント、git-worktree](https://git-scm.com/docs/git-worktree)
-   [Aider ドキュメント、aider のスクリプト実行](https://aider.chat/docs/scripting.html)
-   [BroadNet Inference の無制限プラン （英語）](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-blog-overnight-coding-agent-runs&utm_content=sources)
