メインコンテンツにスキップ

設定

IaC Code は CLI 引数、環境変数、およびランタイム設定ディレクトリ内のファイルから設定を読み取ります。

設定の優先順位：

CLI 引数 > 環境変数 > 設定ファイル

ランタイムディレクトリは既定で以下です：

~/.iac-code/

IAC_CODE_CONFIG_DIR 環境変数を設定すると、ディレクトリを変更できます（~ と $VAR の展開をサポート）。設定すると、永続化されるすべての成果物 — 認証情報、設定、履歴、projects/、image-cache/、tool-results/、logs/、memory/、a2a/、telemetry/、skills/ — が新しい場所に追従します。

主要ファイル：

ファイル説明
.credentials.ymlLLM 認証情報
.cloud-credentials.ymlクラウドプロバイダー認証情報
settings.yml選択されたプロバイダー、モデル、および関連設定
history files対話ワークフローの入力履歴

このディレクトリのファイルにはシークレットやローカル設定が含まれる場合があるため、コミットや共有は避けてください。

プロジェクト設定​

ユーザーレベルの ~/.iac-code/settings.yml に加えて、IaC Code は現在の作業ディレクトリからプロジェクトレベルの設定を読み込みます：

ファイル範囲
.iac-code/settings.ymlプロジェクト共有設定（コミットしても安全）。
.iac-code/settings.local.ymlローカル上書き（.gitignore に追加すべき）。

マージ順序：ユーザー設定 → プロジェクト設定 → プロジェクトローカル設定 → CLI 引数（後のソースが前のものを上書きします）。

ツール権限設定​

settings.yml の permissions セクションで、どのツールアクションを許可、拒否、または確認を必要とするかを設定します：

permissions:
  mode: default
  allow:
    - "bash(git *)"
    - "bash(ls:*)"
  deny:
    - "bash(rm -rf *)"
  ask:
    - "bash(curl:*)"
  additional_directories:
    - "/tmp/workspace"
フィールド説明
mode権限モード：default、accept_edits、bypass_permissions、dont_ask。
allow自動承認するツール権限パターンのリスト。
deny自動拒否するツール権限パターンのリスト。
ask常に確認が必要なツール権限パターンのリスト。
additional_directoriescwd 以外でエージェントが書き込み可能な追加ディレクトリ。

パターン構文​

ツール権限パターンは tool_name(rule) の形式に従います：

パターン意味
bashすべての bash コマンドにマッチ（ツール名のみ）。
bash(git *)git で始まる bash コマンドにマッチ。
bash(curl:*)curl で始まる bash コマンドにマッチ。
write_fileすべての write_file ツール呼び出しにマッチ。

ルールは次の順序で評価されます：deny → ask → allow → デフォルト動作。CLI 引数（--allowed-tools、--disallowed-tools）が最も高い優先度を持ちます。