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

環境変数

IaC Code は CLI 引数、環境変数、設定ファイルから設定を読み取ります。優先順位は以下の通りです：

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

環境変数は、設定ファイルを編集せずに CI/CD パイプライン、コンテナ、一時的な上書きに便利です。

LLM 設定​

変数説明
IAC_CODE_PROVIDERモデルプロバイダー名（大文字小文字不問）。有効な値：DashScope、DashScope Token Plan、OpenAI、Anthropic、DeepSeek、Gemini、Azure OpenAI、ModelScope、Kimi CN、Kimi Intl、MiniMax CN、MiniMax Intl、ZhiPu CN、ZhiPu Intl、Volcengine CN、SiliconFlow CN、SiliconFlow Intl、Aliyun CodingPlan、Aliyun CodingPlan Intl、ZhiPu CN CodingPlan、ZhiPu Intl CodingPlan、Volcengine CodingPlan、OpenAPI Compatible、Anthropic Compatible、OpenRouter、Ollama、LM Studio
IAC_CODE_MODELモデル名
IAC_CODE_BASE_URL現在アクティブなプロバイダーの API エンドポイントを上書きします。保存済みの apiBase と組み込みの既定 URL より優先されます
IAC_CODE_API_KEYプロバイダー API キー。.credentials.yml のアクティブプロバイダーのキーを上書きします

詳細は LLM プロバイダー をご覧ください。

Alibaba Cloud 認証情報​

変数説明
ALIBABA_CLOUD_ACCESS_KEY_IDAccessKey ID
ALIBABA_CLOUD_ACCESS_KEY_SECRETAccessKey Secret
ALIBABA_CLOUD_SECURITY_TOKENSTS トークン。設定すると認証モードが STS に切り替わります
ALIBABA_CLOUD_REGION_IDデフォルトリージョン
ALIBABA_CLOUD_ECS_METADATA任意の ECS RAM ロール名。モードがすでに EcsRamRole で、保存済みのロール名がない場合に使用されます。この変数だけではモードは選択されません
ALIBABA_CLOUD_ECS_METADATA_DISABLEDtrue に設定すると、ECS インスタンスメタデータ認証情報を無効にします
ALIBABA_CLOUD_IMDSV1_DISABLEDtrue に設定すると IMDSv2 を必須とし、IMDSv1 へのフォールバックを無効にします

ECS メタデータ関連の環境変数は、認証モードを EcsRamRole に設定した後にのみ適用されます。IaC Code に保存されたロール名は ALIBABA_CLOUD_ECS_METADATA より優先され、どちらも設定されていない場合は IMDS からロール名を自動検出します。

詳細は Alibaba Cloud 認証情報 をご覧ください。

テレメトリ​

変数説明
IAC_CODE_DISABLE_NONESSENTIAL_TRAFFIC1 / true / yes / on に設定すると、重要でないテレメトリトラフィックを無効にします
DISABLE_TELEMETRY1 / true / yes / on に設定すると、すべてのテレメトリを無効にします
IAC_CODE_TELEMETRY_ENDPOINTベース OTLP エンドポイント。個別のシグナルエンドポイントはこの値がデフォルトになります
IAC_CODE_TELEMETRY_TRACES_ENDPOINTトレース用のオーバーライドエンドポイント
IAC_CODE_TELEMETRY_METRICS_ENDPOINTメトリクス用のオーバーライドエンドポイント
IAC_CODE_TELEMETRY_LOGS_ENDPOINTログ用のオーバーライドエンドポイント
IAC_CODE_TELEMETRY_HEADERSカスタム OTLP ヘッダー（JSON またはキー=値形式）
IAC_CODE_CHANNEL安定した低カーディナリティのテレメトリソースチャネル（デフォルト：unknown）。例：ros_official、partner_acme

その他​

変数説明
IAC_CODE_CONFIG_DIRランタイム設定ディレクトリを上書き（デフォルト ~/.iac-code/）。~ と $VAR の展開をサポート。永続化されるすべての成果物（認証情報、設定、履歴、projects、image-cache、skills、telemetry など）はこのディレクトリに従います
IAC_CODE_LOG_DIRローカルの起動/デバッグログディレクトリを上書き（デフォルト <config-dir>/logs/）。~ と $VAR の展開をサポート。権限監査レコードはセッションレイアウトに従い、この変数では移動されません
IAC_CODE_PERMISSION_AUDIT_INCLUDE_TOOL_INPUTpermissions.audit.include_tool_input を上書きします。1 / true / yes / on に設定すると、権限監査レコードに形状のみのツール入力を含め、業務 payload の生文字列の代わりに型/長さ/フィンガープリントを記録し、ホワイトリスト外のフィールド名もフィンガープリント化します
IAC_CODE_ENVデプロイ環境ラベル（デフォルト：production）
IAC_CODE_TENANT_IDテレメトリ用テナント識別子。iac_tenant_ プレフィックスが付いていない場合は自動的に付加されます
IAC_CODE_GIT_BASH_PATHWindows で Git Bash が PATH にない場合の bash.exe パス
IAC_CODE_A2A_PUSH_KEYRING環境管理された A2A 暗号化プッシュシークレットキーリング（JSON 形式）
OTEL_EXPORTER_OTLP_ENDPOINT標準 OpenTelemetry エンドポイント。設定すると OTLP エクスポートが有効になります
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENTスパンで GenAI メッセージ/ツールコンテンツをキャプチャ：SPAN_ONLY、EVENT_ONLY、SPAN_AND_EVENT

セッションバックアップ​

変数説明
IAC_CODE_CONFIG_BACKUP_DIR任意のセッションバックアップ先で、~ と $VAR 展開をサポートし、Windows では %VAR% 展開もサポートします。PowerShell では具体的なパスを渡すか、iac-code 起動前にシェル側で $env:VAR を展開してください。sandbox 環境では OSS のマウント先を指定することが一般的ですが、IAC_CODE_CONFIG_DIR やセッションソースとは独立し、重ならない場所にし、重要チェックポイントに十分な低レイテンシである必要があります。UNC パス、マップドライブ、OSS マウントパスは、インクリメンタルミラーリングに必要な .backup-lock ファイルロック、atomic replace、ファイルメタデータを保つ必要があります。アクティブなセッションソース、バックアップルート、ミラーされたセッションでは、シンボリックリンク、junction、reparse point の祖先パスを避けてください。有効にすると、チェックポイントで各 v2 セッションを元と同じ構成のまま <backup>/projects/<project>/<session_id>/ にミラーします。.backup-state.json と .backup-lock はローカルに残りコピーされません。通常チャットのターン終了バックアップは normal_turn_end を使い、応答をブロックしません。critical=true チェックポイントの失敗だけが公開をブロックします。共有 A2A task/context インデックスは別にマウントできます。
IAC_CODE_CONFIG_BACKUP_TMP_DIRiac-code a2a 用の任意のローカル一時バックアップディレクトリです。IAC_CODE_CONFIG_BACKUP_DIR も必要です。A2A バックアップは不変の <session_id>_vX スナップショットがローカルで完成するまでだけブロックし、その後は専用プロセスがバージョン順に最終バックアップ先へコピーし、成功後に削除します。両方とも重複しない絶対パスで、このディレクトリは IAC_CODE_CONFIG_DIR の外に置く必要があります。他の実行モードはこの設定を無視します。