設定リファレンス

opencodex は、永続的な設定を $OPENCODEX_HOME/config.json (通常は ~/.opencodex/config.json) に保存します。 Windows では、デフォルトは %USERPROFILE%\.opencodex\config.json です。

設定の編集方法

タスクに合った編集チャンネルを選択してください。

ダッシュボード: ガイド付きプロバイダー、モデル、エージェント、アクセス、ストレージ設定には Web UI を使用します。
CLI: ocx init は初期ファイルを作成しますが、ocx provider、ocx models、 ocx combo、ocx agent、および ocx config は、独自の設定を更新または検査します。
ファイル: 専用の UI または CLI コマンドを使用せずに、フィールドに対して config.json を直接編集します。ファイルは次のとおりです。有効な JSON を維持します。

ダッシュボード、管理 API、および変更可能な CLI コマンドはすべて同じファイルに保持されます。それらのチャンネルを優先するか、手動で編集する前にプロキシを停止してください。実行中のプロセスは設定をメモリに保持するため、後でライブ保存すると、スナップショットから無関係な手動編集を書き換えることができます。ライブ保存では、外部で編集された claudeCode とリスナーバインディングフィールドがマージされ、これらのパスには明示的な競合保護が設定されていますが、その保護はすべてのサブツリーをカバーするわけではありません。

ファイルを解析できない場合、opencodex はファイルを config.json.invalid-<timestamp> としてバックアップし、コンソールに警告を表示し、デフォルトで起動します。欠落しているファイルでも、新規インストールのデフォルトである 1 つの openai フォワードプロバイダーが使用されます。

優先順位とデフォルト

config.json の有効な値は、組み込みのデフォルトをオーバーライドします。省略可能なフィールドが欠落している場合は、ドメインページに記載されているデフォルトが使用されます。 OPENCODEX_HOME は、デフォルトの構成ディレクトリよりも優先されます。 apiKey: "${PROVIDER_API_KEY}" などの環境参照を受け入れるフィールドは、リクエスト時にその変数を解決します。送信プロキシの場合、すでに設定されている HTTP_PROXY または HTTPS_PROXY が最上位の proxy フィールドよりも優先されます。

ルーティングには独自の順序付けされた解決ルールがあります。ルーティングを参照してください。

設定領域

プロバイダー — プロバイダーエントリ、認証、エンドポイント、カタログ、ホワイトリスト、コンテキスト制限、クォータ、プロバイダー固有のオプション。
ルーティング — defaultProvider、モデル解決順序、コンボ、エイリアスとコンボエフォートのデフォルト。
エージェント — マルチエージェントモード、委任ガイダンス、フォールバックモデル、ネイティブとデフォルトの同期、およびエフォートキャップ。
サーバーとランタイム — リスナーとリモートアクセス、アドミッションキー、タイムアウト、ストレージ、サイドカー、起動動作、およびシャドウコール。

ファイルに秘密を漏らさないようにする

API キーには ${ENV_VAR} 参照を優先します。リテラルの apiKey、apiKeyPool[].key、および apiKeys[].key 値は秘密です。コミットしたり、ログに貼り付けたり、共有したりしないでください。 OAuth およびフォワードプロバイダートークンは、config.json ではなく別の資格情報ストアに保存されます。アカウント ID と電子メールも非公開にしておく必要があります。サポートされている場合は、パブリックセレクターエイリアスを使用します。