環境変数
ローカルの CLI とデーモンが読み込む AACWORKFLOW_* 環境変数 — あなたが設定できるのはこれだけです。
AACWorkflow Cloud のバックエンドは AACWorkflow が一元的に運用しています — サーバー側にはあなたが設定する項目はありません。あなたが実際に設定するのは、自分のマシン上で動くローカルの CLI とデーモン — あなたの AI コーディングツールを AACWorkflow Cloud に接続するランタイムです。このページはデーモンが読み込むすべての変数を一覧にしたものです。
デーモンのチューニングパラメータ
デーモンはユーザーのローカルマシン上で実行され、その設定もローカル環境変数から読み込まれます。一般的なものは次のとおりです。
| 変数 | デフォルト | 説明 |
|---|---|---|
AACWORKFLOW_SERVER_URL | wss://api.aacworkflow.com/ws | AACWorkflow Cloud の WebSocket アドレス |
AACWORKFLOW_DAEMON_DEVICE_NAME | ホスト名 | Runtimes 画面に表示されるデバイス名 |
AACWORKFLOW_AGENT_RUNTIME_NAME | 組み込みデフォルト | ランタイムの表示名 |
AACWORKFLOW_DAEMON_HEARTBEAT_INTERVAL | 15s | ハートビート間隔 |
AACWORKFLOW_DAEMON_POLL_INTERVAL | 30s | タスクのポーリング間隔 |
AACWORKFLOW_DAEMON_MAX_CONCURRENT_TASKS | 20 | 最大同時タスク数 |
AACWORKFLOW_AGENT_TIMEOUT | 0 | エージェント実行あたりの絶対壁時計上限。0 は上限なしを意味し、実行時間は inactivity watchdog のみで抑えられます。ハードなリソース／コスト上限が欲しい場合は正の Go 期間を設定してください |
AACWORKFLOW_CODEX_SEMANTIC_INACTIVITY_TIMEOUT | 10m | Codex 固有の inactivity watchdog の待ち時間 |
AACWORKFLOW_CODEX_HANDSHAKE_TIMEOUT | 30s | Codex app-server 起動 RPC のタイムアウト |
AACWORKFLOW_DAEMON_AUTO_UPDATE | true | false/0/no/off でデーモンの CLI 自動アップデートを無効化 |
AACWORKFLOW_DAEMON_AUTO_UPDATE_INTERVAL | 6h | デーモンが CLI の新リリースを GitHub でチェックする間隔 |
AACWORKFLOW_AGENT_IDLE_WATCHDOG | 30m | ツールが実行中でない状態が続いたときのグローバルな無応答 watchdog。0 はプロバイダー固有の上書きを含めて watchdog 全体を無効化します |
AACWORKFLOW_OPENCODE_IDLE_WATCHDOG | 10m | 最初のトークンが来ない、またはストリームが停止した場合の OpenCode 固有の無応答ウィンドウ。0 は AACWORKFLOW_AGENT_IDLE_WATCHDOG にフォールバックし、より大きな値でもそのグローバル上限を超えて延長することはできません |
AACWORKFLOW_AGENT_TOOL_WATCHDOG | 2h | ツール呼び出しが実行中のときの沈黙許容時間。0 はスタックしたツールに対するこのバックストップを無効化します |
AACWORKFLOW_<PROVIDER>_PATH | CLI 名に一致 | 各 AI コーディングツールの実行ファイルへのパス(例: AACWORKFLOW_CLAUDE_PATH) |
AACWORKFLOW_<PROVIDER>_MODEL | 空 | 各 AI コーディングツールのデフォルトモデル |
AACWORKFLOW_<PROVIDER>_ARGS | 空 | バックエンドごとのデーモン全体のデフォルト CLI 引数。各タスクに対し、各エージェント自身の custom_args より前に適用される。AACWORKFLOW_CLAUDE_ARGS、AACWORKFLOW_CODEX_ARGS、AACWORKFLOW_CODEBUDDY_ARGS をサポート |
各パラメータがデーモンの動作にどう影響するかの完全な説明は、デーモンとランタイムを参照してください。
デーモン設定を config.json に永続化する
上表の各デーモンキー — device_name、runtime_name、max_concurrent_tasks、poll_interval、heartbeat_interval、agent_timeout、codex_semantic_inactivity_timeout、codex_handshake_timeout、disable_auto_update、auto_update_check_interval — は、プロファイルの ~/.aacworkflow/config.json(もしくは ~/.aacworkflow/profiles/<name>/config.json)に永続化することもできます。これにより、daemon start のたびにフラグを再指定したり環境変数を export したりする必要がなくなります。
aacworkflow config set device_name my-vm-custom-name
aacworkflow config set runtime_name worker-a
aacworkflow config set max_concurrent_tasks 8
aacworkflow config set poll_interval 10s # Go の期間、必ず > 0
aacworkflow config set heartbeat_interval 30s
aacworkflow config set agent_timeout 1h # 0s を渡すと壁時計上限を明示的に無効化
aacworkflow config set codex_semantic_inactivity_timeout 15m
aacworkflow config set codex_handshake_timeout 45s
aacworkflow config set disable_auto_update true # 単方向: 自動アップデートを無効化する用途のみ
aacworkflow config set auto_update_check_interval 12h期間系キーは正の Go 期間(500ms、10s、1m30s など)のみを受け付けます。0s、負値、パース不能な文字列は config set の時点で拒否されます。ただし agent_timeout は例外で、ここでは 0s は「壁時計上限を明示的に無効化する」意味を持つ有効値です(負値はやはり拒否されます)。永続化した値をクリアして環境変数 / 組み込みデフォルトに戻すには空文字を渡してください: aacworkflow config set poll_interval ""。
disable_auto_update は単方向のブール値です。true にするとデーモンの CLI 自動アップデートを無効化し、false(もしくは "" でクリア)にすると判定を AACWORKFLOW_DAEMON_AUTO_UPDATE に委ねます。config ファイルから自動アップデートを 強制的に有効化 することはできません。
優先順位は上から順に: daemon start の --flag > AACWORKFLOW_… 環境変数 > config.json > 組み込みデフォルト。systemd unit などで環境変数を設定するとファイルより優先され、明示的な CLI フラグは両者よりさらに優先されます。
--profile <name> で同一ホスト上に複数のデーモンを走らせるときに特に有用です。プロファイルごとに device_name を独立して設定すれば、Runtimes 画面でも共有ホスト名で潰れることなく別々の行として区別できます。
デフォルトのエージェント引数(AACWORKFLOW_<PROVIDER>_ARGS)
バックエンドに対してフリート全体のデフォルトとなる CLI フラグの層を設定します。各エージェントの custom_args を個別に編集することなく、デーモン上のすべてのエージェントにデフォルトのコスト・リソースのベースライン(例: --max-turns)を適用できる便利な手段です。これはデフォルトの層であり、超えられない上限ではありません。各エージェント自身の custom_args が後から追加され、これを上書きできます(下記の優先順位を参照)。
- 優先順位: デフォルト引数が先に適用され、その後に各エージェント自身の
custom_argsが追加されます。値を取るフラグについては、下流 CLI 自身の引数パーサーが最終的な勝者を決めます(多くのツールでは最後の出現が優先)。そのため個々のエージェントはデーモンのデフォルトを引き上げられますが、エージェントが上書きしない箇所ではデフォルトが引き続き有効です。 - パース: 値は POSIX シェルワード規則で分割されるため、クォートが使えます——
AACWORKFLOW_CLAUDE_ARGS='--append-system-prompt "multi word"'は 2 つのトークンに解析されます。 - 安全性: デフォルト引数の層と各エージェントの
custom_argsの層は、いずれも同じ blocked-flags フィルターを通過します。そのためプロトコル上重要なフラグ(Claude の-p、--output-format、--input-format、--permission-mode、--mcp-config、および Codex の--listenなど)はどちらの層からも注入できません。 - 未設定・空 の場合は動作に変化はありません。
次へ
- デーモンとランタイム — これらのパラメータが実際に何をするか
- CLI リファレンス — すべての CLI コマンドで認証は自動的に行われます
- トラブルシューティング — デーモンのオフライン、タスクが取得されない、その他よくある問題