Qoder CLI のすべての構成項目、既定値、環境変数、およびファイルパスの全一覧
本ページでは、
JSON Schema はエディターの自動補完に使用でき、プロジェクトの
単語の判定は控えめです。バッククォート内のテキスト、パス、URL、フラグ、メールアドレス、語中に大文字を含む単語、ラテン辞書で判定できない文字体系はいずれも対象外で、カーソルのある単語にも印は付きません。スペルチェックは対話型のプロンプト入力にのみ適用されます。
settings.json のすべての設定グループ、主要フィールド、デフォルト値、再起動の要否、およびサポートされる環境変数について説明します。設定ファイルの階層化とマージルールについては、構成ファイルと適用順序 を参照してください。
構成ファイルの場所:
| レベル | パス |
|---|---|
| ユーザーレベル | ~/.qoder/settings.json |
| プロジェクトレベル | <プロジェクト>/.qoder/settings.json |
| ローカルレベル | <プロジェクト>/.qoder/settings.local.json |
schemas/settings.schema.json に配置されています。
最上位構成項目
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
mcpServers | object | {} | 要 | MCP サーバー構成。MCP リファレンス を参照してください。 |
autoMemoryEnabled | boolean | false | 要 | インタラクティブセッションで自動メモリを有効にします。 |
outputStyle | string | なし | 要 | 有効化する出力スタイル名。general.outputStyle の記法と互換性があり、最上位が優先されます。 |
language | string | なし | 要 | AI の応答に使用する優先言語（例："Chinese"）。 |
vpcInstanceName | string | なし | 要 | VPC プライベートデプロイメントのインスタンス名（CN 版のみ）。 |
agent | string | なし | 要 | メインスレッドで使用するエージェント名。 |
enabledPlugins | object | {} | 要 | プラグインの有効状態のマッピング（プラグイン ID → true/false）。プラグイン を参照してください。 |
hooks | object | {} | 不要 | イベントごとに構成されるフック。フックリファレンス を参照してください。 |
spellcheck（スペルチェック）
PATH 上にある aspell、hunspell、ispell のいずれかを使い、入力中のプロンプトでつづりの誤った単語に下線を引きます。既定では無効です。spellcheck.enabled が true になるまでプロセスは起動せず、チェッカーが未インストールの場合も何も起こりません。
ユーザーレベル設定と --settings フラグからのみ読み込まれます。そのうち優先度が最も高いブロックが一括で適用され、フィールド単位のマージは行われません。したがって適用されるブロックは必要な値をすべて持つ必要があります。これらの値は実行するプログラムを決めるため、プロジェクトレベルおよびローカルレベル設定の spellcheck ブロックは無視されます。
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
spellcheck.enabled | boolean | false | 不要 | プロンプト入力のスペルチェックを有効にします。 |
spellcheck.checker | enum | auto | 不要 | 使用するチェッカー: auto/aspell/hunspell/ispell。auto は PATH 上で最初に見つかったものを使います。 |
spellcheck.language | string | なし | 不要 | チェッカーへそのまま渡す辞書名（aspell --lang、hunspell -d、ispell -d）。例: en_GB。単純な辞書名である必要があり、それ以外の場合はチェッカー既定の辞書が使われます。 |
spellcheck.color | string | テーマのエラー色 | 不要 | つづりの誤った単語の色（下線も付きます）: red などの色名、#rrggbb、rgb(r,g,b)、ansi256(n)、ansi:<name>。 |
general（汎用）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
general.preferredEditor | string | なし | 不要 | ファイルを開く際の優先エディター。 |
general.vimMode | boolean | false | 不要 | Vim キーバインドを有効にします。 |
general.defaultPermissionMode | enum | default | 不要 | デフォルトの権限モード：default/accept_edits/plan/auto/bypass_permissions/dont_ask。 |
general.enableAutoUpdate | boolean | true | 不要 | 自動アップグレードを有効にします。 |
general.enableNotifications | boolean | false | 不要 | 実行イベント通知を有効にします。 |
general.maxAttempts | number | 10 | 不要 | メイン対話モデルリクエストの最大試行回数（10 以下）。 |
general.retryFetchErrors | boolean | true | 不要 | fetch failed などのネットワークリクエスト例外発生時に自動再試行します。 |
general.fileCheckpointing.enabled | boolean | true | 要 | ファイルチェックポイント（コードロールバック）を有効にします。 |
general.plan.enabled | boolean | true | 要 | Plan モードを有効にします。 |
general.plan.directory | string | システム一時ディレクトリ | 要 | プラン成果物の保存ディレクトリ。 |
general.plan.modelRouting | boolean | true | 不要 | Plan/実装フェーズでモデルを自動切り替えします。 |
general.sessionRetention.enabled | boolean | true | 不要 | セッションの自動クリーンアップを有効にします。 |
general.sessionRetention.maxAge | string | 30d | 不要 | この期間より前のセッションを自動削除します。 |
general.sessionRetention.minRetention | string | 1d | 不要 | 最小保持期間（安全な下限）。 |
output（出力）
| 構成項目 | 型 | デフォルト値 | 説明 |
|---|---|---|---|
output.format | enum | text | CLI 出力形式：text または json。 |
ui（インターフェイス）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
ui.theme | string | なし | 不要 | カラーテーマ名。 |
ui.autoThemeSwitching | boolean | true | 不要 | ターミナルの背景に応じてライト/ダークテーマを自動切り替えします。 |
ui.terminalBackgroundPollingInterval | number | 60 | 不要 | ターミナル背景色のポーリング間隔（秒）。 |
ui.customThemes | object | {} | 不要 | カスタムテーマの定義。 |
ui.inlineThinkingMode | enum | full | 不要 | インライン思考の表示：off/full。 |
ui.maxTurns | enum | 1000 | 不要 | TUI の入力ごとのモデル／ツールループ最大ターン数：1000/2000/3000/unlimited。-p/--print には影響しません。 |
ui.dynamicWindowTitle | boolean | true | 不要 | ステータスアイコンでウィンドウタイトルを更新します。 |
ui.hideBanner | boolean | false | 不要 | 起動バナーを非表示にします。 |
ui.hideFooter | boolean | false | 不要 | フッターを非表示にします。 |
ui.hideTips | boolean | false | 不要 | プロンプトを非表示にします。 |
ui.showLineNumbers | boolean | true | 不要 | 会話内で行番号を表示します。 |
ui.renderMermaid | boolean | true | 不要 | 閉じた mermaid コードブロックを文字の図として描画します。描画できない場合はソースを表示します。 |
ui.compactToolOutput | boolean | true | 不要 | ツール出力をコンパクトに表示します。 |
ui.copyFullResponse | boolean | false | 不要 | /copy で常に完全な応答をコピーします。 |
ui.loadingPhrases | enum | off | 不要 | 読み込み表示：tips/witty/all/off。 |
ui.errorVerbosity | enum | low | 不要 | 回復可能なエラーの詳細度：low/full。 |
ui.customWittyPhrases | string[] | [] | 不要 | カスタム読み込みフレーズ。 |
ui.footer.* | object | {} | 不要 | フッター項目の構成（items/showLabels/hideCWD/hideModelInfo など）。 |
ui.rotatingInfoLine.enabled | boolean | true | 不要 | 入力ボックス上部のカルーセル情報行。 |
ui.rotatingInfoLine.intervalMs | number | 4000 | 不要 | カルーセル間隔（ミリ秒）。 |
ui.useAlternateBuffer | boolean | false | 要 | 代替バッファーを使用します。 |
ui.accessibility.screenReader | boolean | false | 要 | スクリーンリーダーモード。プレーンテキストを出力します。 |
ui.showMemoryUsage | boolean | false | 不要 | インターフェイスにメモリ使用量情報を表示します。 |
ui.showSpinner | boolean | true | 不要 | 操作中に読み込みアニメーションを表示します。 |
ui.terminalBuffer | boolean | true | 要 | 新しいターミナルバッファーアーキテクチャを使用してレンダリングします。 |
ui.renderProcess | boolean | true | 要 | Ink レンダリングプロセスを有効にします。 |
ui.incrementalRendering | boolean | true | 要 | インクリメンタルレンダリング。ちらつきを減らしますが、レンダリングのアーティファクトが発生する可能性があります。ui.useAlternateBuffer が有効な場合のみサポートされます。 |
model / modelConfigs（モデル）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
model.name | string | なし | 不要 | 対話モデル。 |
model.reasoningEffort | enum | なし | 不要 | 推論エフォート：disabled/off/none/low/medium/high/xhigh/max。 |
model.contextWindow | number | なし | 不要 | 明示的なコンテキストウィンドウ（トークン）。 |
model.summarizeToolOutput | object | なし | 不要 | ツールごとの出力要約トークンバジェットを設定します。 |
modelConfigs.aliases | object | 組み込み | 不要 | モデル構成エイリアスのプリセット。 |
modelConfigs.customAliases | object | {} | 不要 | カスタムエイリアス。組み込みとマージして上書きします。 |
modelConfigs.overrides | array | [] | 不要 | 一致条件（主キーはモデルまたはエイリアス）に基づいて構成オーバーライドを適用します。最も具体的な一致が有効になります。 |
modelConfigs.customOverrides | array | [] | 不要 | カスタムオーバーライド。組み込みの overrides とマージして追加します。 |
context（コンテキスト）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
context.fileName | string/string[] | AGENTS.md | 不要 | メモリに読み込むコンテキストファイル名。 |
context.importFormat | enum | なし | 不要 | メモリインポート形式：tree/flat。 |
context.discoveryMaxDirs | number | 200 | 不要 | メモリディスカバリの最大ディレクトリ数。 |
context.memoryBoundaryMarkers | string[] | ['.git'] | 要 | メモリの上方ディスカバリの境界マーカー。 |
context.loadMemoryFromIncludeDirectories | boolean | false | 不要 | 追加の信頼済みディレクトリからメモリを読み込みます。 |
context.fileFiltering.respectGitIgnore | boolean | true | 要 | 検索時に .gitignore に従います。 |
context.fileFiltering.enableRecursiveFileSearch | boolean | true | 要 | @ の参照補完時に再帰検索を行います。 |
agentsMdExcludes | string[] | [] | 要 | glob に基づいてプロジェクトレベル/ローカルレベルのメモリファイルを除外します。最上位キーであり、手動構成のみサポートされます。 |
tools（ツール）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
tools.shell.pager | string | cat | 不要 | シェル出力のページングコマンド。 |
tools.shell.inactivityTimeout | number | 300 | 不要 | シェル出力なしのタイムアウト秒数。 |
tools.core | string[] | なし | 要 | 組み込みツールの許可リスト。 |
tools.exclude | string[] | なし | 要 | ディスカバリから除外するツール名。 |
tools.useRipgrep | boolean | true | 不要 | コンテンツ検索に ripgrep を使用します。 |
tools.disableLLMCorrection | boolean | true | 要 | 編集ツールの LLM 自動修正を無効にします。 |
mcp（MCP）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
mcp.allowed | string[] | なし | 要 | 許可された MCP サーバーのリスト。 |
mcp.excluded | string[] | なし | 要 | 除外された MCP サーバーのリスト。 |
mcp.enableAllProjectMcpServers | boolean | false | 要 | すべてのプロジェクトレベル MCP サーバーを自動承認します。 |
mcp.enabledProjectMcpServers | string[] | [] | 要 | 個別に承認されたプロジェクトレベル MCP サーバー名のリスト。 |
mcp.lazyLoad | boolean | false | 要 | MCP ツールを遅延読み込みします（メタツールを公開）。 |
security（セキュリティ）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
security.folderTrust.enabled | boolean | true | 要 | フォルダー信頼を有効にします。 |
security.disableYoloMode | boolean | false | 要 | bypass_permissions（YOLO）権限モードを無効にします。 |
security.blockGitExtensions | boolean | false | 要 | Git からの拡張機能のインストール/読み込みをブロックします。 |
security.allowedExtensions | string[] | [] | 要 | 拡張機能ソースの正規表現許可リスト。 |
security.environmentVariableRedaction.enabled | boolean | false | 要 | 鍵を含む可能性のある環境変数をマスキングします。 |
security.enableConseca | boolean | false | 要 | コンテキスト認識セキュリティチェックを有効にします。 |
permissions（権限）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
permissions.allow | string[] | [] | 不要 | 自動許可される権限ルールのリスト。ルール構文については 権限 を参照してください。 |
permissions.ask | string[] | [] | 不要 | 確認を求める権限ルールのリスト。 |
permissions.deny | string[] | [] | 不要 | 常に拒否される権限ルールのリスト。 |
permissions.additionalDirectories | string[] | [] | 不要 | ワークスペースコンテキストに追加する追加の信頼済みディレクトリ（/add-dir に対応）。 |
permissions.trustDirectories | string[] | [] | 不要 | ユーザーが明示的に信頼するディレクトリ。ユーザーレベル構成に保存され、プロジェクトレベルで上書きされることはありません。 |
autoMode | object | {} | 不要 | Auto モード分類子のソフトガイドルール（allow/soft_deny/environment）。最上位キーであり、ユーザーレベルとローカル構成からのみ読み込まれます。 |
allowManagedPermissionRulesOnly | boolean | false | 不要 | マネージドポリシーの権限ルールのみを使用します。最上位キーであり、主に組織のマネージドポリシーに使用されます。 |
privacy / aiCodeStatistics（プライバシー）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
privacy.usageStatisticsEnabled | boolean | true | 不要 | 使用データを共有します。オフにするとプライバシーモードになります。 |
aiCodeStatistics.enabled | boolean | true | 要 | AI 生成コード統計を記録し、報告します。 |
advanced（詳細）
| 構成項目 | 型 | デフォルト値 | 再起動 | 説明 |
|---|---|---|---|---|
advanced.autoConfigureMemory | boolean | true | 要 | Node.js のメモリ上限を自動構成します。 |
advanced.dnsResolutionOrder | string | なし | 要 | DNS 解決の順序。 |
advanced.excludedEnvVars | string[] | ['DEBUG','DEBUG_MODE'] | 不要 | プロジェクトコンテキストから除外する環境変数。 |
agents.overrides | object | {} | 要 | エージェント名ごとにその構成（有効状態、ツール、モデル、実行上限など）を上書きします。フィールドについては サブエージェント を参照してください。 |
statusLine（ステータスバー）
| 構成項目 | 型 | デフォルト値 | 説明 |
|---|---|---|---|
statusLine.type | string | command | ステータスバーのタイプ。 |
statusLine.command | string | "" | ステータスバーを生成するシェルコマンド。stdin 経由でセッションデータ JSON を受け取ります。 |
statusLine.padding | number | 0 | 水平パディングの文字数。 |
statusLine.colors | object | {} | 組み込みデフォルトステータスバーの各段落のカスタムカラー（model、branch、separator など）。 |
環境変数
Qoder 関連
| 環境変数 | 説明 |
|---|---|
QODER_PERSONAL_ACCESS_TOKEN | 個人アクセストークン（PAT）。設定すると、PAT 認証が自動的に使用されます。 |
QODER_CONFIG_DIR | ユーザー構成ディレクトリの場所（デフォルトは ~/.qoder）。 |
QODER_MODEL | 使用するモデルを指定します。 |
QODER_WORKING_DIR | 作業ディレクトリ。 |
QODER_SESSION_ID | セッション ID。 |
QODER_SESSION_NAME | セッション名。 |
QODER_PERMISSION_MODE | 権限モード。 |
QODER_APPEND_SYSTEM_PROMPT | システムプロンプトを追加します。 |
QODER_MCP_LAZY | 1 に設定すると、MCP の遅延読み込みが有効になります。 |
QODER_ASR_URL | 音声認識サービスのアドレス。 |
QODER_SUBAGENT_MODEL | サブエージェントが使用するモデル。 |
QODER_MEMORY | 1 に設定すると、自動メモリが有効になります（インタラクティブセッションでのみ有効）。 |
QODER_MEMORY_USER | 1 に設定すると、ユーザーレベルの自動メモリも同時に有効になります。QODER_MEMORY が有効な場合にのみ適用されます。 |
ネットワークプロキシ
| 環境変数 | 説明 |
|---|---|
HTTP_PROXY / http_proxy | HTTP リクエストのプロキシアドレス。 |
HTTPS_PROXY / https_proxy | HTTPS リクエストのプロキシアドレス。 |
NO_PROXY / no_proxy | プロキシを経由しないホストのリスト（カンマ区切り）。 |
NODE_EXTRA_CA_CERTS | 追加の CA 証明書ファイル（PEM 形式）へのパス。 |
SSL_CERT_FILE | 信頼された証明書ファイルのパスを指定します。自己署名証明書やエンタープライズルート証明書の環境で使用します。 |
次のステップ
- 構成の階層化とマージルール：構成ファイルと適用順序。
- ネットワークとプロキシの構成：ネットワーク、プロキシ、および VPC。