@kikkimo/claude-launcher 3.0.0 → 3.1.0

package/lib/i18n/locales/zh-TW.js

@@ -38,6 +38,7 @@ module.exports = {
             model_upgrade_notification: "模型升級提示",
             telemetry: "Anthropic 遙測資料",
             api_launch_mode: "第三方API啟動模式",
+            no_flicker: "停用螢幕閃爍",
             back: "返回主選單"
         },
         api_select: {
@@ -122,7 +123,8 @@ module.exports = {
             failed_add: "新增API失敗：{0}",
             failed_remove: "刪除API失敗：{0}",
             failed_switch: "切換API失敗：{0}",
-            invalid_index: "無效的API索引"
+            invalid_index: "無效的API索引",
+            not_found: "未找到API：{0}",
         },
         password: {
             empty: "密碼不能為空",
@@ -194,7 +196,16 @@ module.exports = {
         exporting: "匯出設定中...",
         importing: "匯入設定中...",
         switching_language: "切換語言中...",
-        initializing: "初始化中..."
+        initializing: "初始化中...",
+        overridden: "已覆寫",
+        not_set: "(未設定)",
+        default: "預設",
+        enabled: "啟用",
+        disabled: "停用",
+        current_value: "目前生效",
+        recommended_value: "建議設定",
+
+        auto: "(未設定)",
     },
 
     // API詳情和標籤
@@ -235,7 +246,24 @@ module.exports = {
             duplicate: 'This change would create a duplicate configuration',
             provider_url_mismatch: 'Provider and URL may be inconsistent',
             provider_url_mismatch_detail: 'Provider: {0} / URL suggests: {1}',
-            url_provider_hint: "URL matches provider '{0}' but current provider is '{1}'. Consider updating Provider field."
+            url_provider_hint: "URL matches provider '{0}' but current provider is '{1}'. Consider updating Provider field.",
+            field_model_env_vars: '模型環境變數',
+            field_runtime_env_vars: '執行參數',
+            env_inherited: '繼承',
+            env_disabled: '已關閉 [off]',
+            manage_custom_env_vars: '管理自訂變數...',
+            no_custom_vars: '(無自訂變數)',
+            add_custom_var: '+ 新增自訂變數',
+            enter_custom_key: '輸入環境變數名稱:',
+            enter_custom_value: '輸入值:',
+            warn_model_not_in_provider: '警告: 模型 "{0}" 不在 {1} 模型列表中。請手動更新模型。',
+            warn_base_url_not_updated: '提示: Base URL 未自動更新 ({0})。如需更改請手動修改。',
+            warn_mixed_provider: '注意: Provider、Base URL 和 Model 來自不同供應商。請確認是否為有意配置。',
+        },
+        add: {
+            duplicate_detected: 'API "{0}" 已存在。跳轉編輯執行參數？',
+            jump_to_edit: '跳轉編輯已有 API',
+            cancel: '取消',
         }
     },
 
@@ -370,6 +398,10 @@ module.exports = {
         enter_choice: "輸入您的選擇（{0}，或任意其他鍵返回主選單）：",
         arrow_keys_not_available: "方向鍵不可用。輸入選擇編號 (1-{0})：",
         enter_choice_prompt: "[>] 輸入您的選擇 (1-2，或任意其他鍵返回主選單)：",
+        input_1_to_n_or_q: "輸入 1-{0} 或 q：",
+        invalid_selection: "無效選擇。請輸入 1-{0}。",
+        enter_to_edit: "Enter 鍵編輯，ESC 鍵返回",
+        enter_to_select: "Enter 鍵選擇，ESC 鍵返回",
         action: {
             edit: 'edit',
             remove: 'remove',
@@ -656,7 +688,7 @@ module.exports = {
         select_mode_active_none: '無',
         no_api_configured: '未設定第三方API，請先在「第三方API管理」中新增',
         api_management_info: '已設定 {0} 個API，目前啟用: {1}',
-        config_summary: '語言: {0} | 啟動模式: {1} | 遙測: {2}',
+        config_summary: '語言: {0} | 啟動模式: {1} | 遙測: {2} | 停用閃爍: {3}',
         edit_password_required: '🔒 Password verification required to edit API configuration',
         remove_password_required: '🔒 Password verification required to remove API',
         export_password_required: '🔒 Password verification required to export configuration',
@@ -666,22 +698,128 @@ module.exports = {
             auto_upgrade: '自動偵測並升級第三方API的模型版本',
             upgrade_notification: '在主選單頂部顯示模型可升級的通知',
             telemetry: '關閉後啟動時注入 DISABLE_TELEMETRY=1，建議關閉',
-            launch_mode: '直接模式: 使用啟用API啟動 / 選擇模式: 啟動前從列表選擇'
+            launch_mode: '直接模式: 使用啟用API啟動 / 選擇模式: 啟動前從列表選擇',
+            no_flicker: '停用螢幕閃爍 (CLAUDE_CODE_NO_FLICKER)'
         },
         api_select: {
             info: 'API: {0}',
             detail: '提供商: {0} | 模型: {1}',
             usage: '使用次數: {0} | 最後使用: {1}'
+        },
+        model: {
+            desc: '指定各場景使用的模型版本',
+            sonnet: '對應 Claude Code 的 Sonnet 檔位',
+            sonnet_detail: "Claude Code 日常對話使用的預設模型，平衡速度與推理能力。對應環境變數 [ANTHROPIC_DEFAULT_SONNET_MODEL]。目前值由模型編排按同代 Sonnet 檔位自動匹配",
+            opus: '對應 Claude Code 的 Opus 檔位',
+            opus_detail: "處理複雜推理、深度分析任務時使用的模型，能力最強。對應環境變數 [ANTHROPIC_DEFAULT_OPUS_MODEL]。目前值由模型編排按同代 Opus 檔位自動匹配",
+            haiku: '對應 Claude Code 的 Haiku 檔位',
+            haiku_detail: "輕量快速場景使用的模型，適合簡單任務和高頻呼叫。對應環境變數 [ANTHROPIC_DEFAULT_HAIKU_MODEL]。目前值由模型編排按同代高速變體自動匹配",
+            subagent: '子任務或分支執行時優先使用的模型',
+            subagent_detail: "子任務、分支執行時使用的模型，建議與快速模型一致以降低延遲和成本。對應環境變數 [CLAUDE_CODE_SUBAGENT_MODEL]。目前值由模型編排自動填入",
+            custom_option: '額外加入 /model 選擇器的模型 ID',
+            custom_option_detail: "向第三方 API 發起請求時使用的模型 ID。對應環境變數 [ANTHROPIC_CUSTOM_MODEL_OPTION]。目前值由模型編排自動填入",
+            custom_name: '自訂模型在 /model 中的顯示名稱',
+            custom_name_detail: "該模型在 /model 命令選擇器中的顯示名稱。對應環境變數 [ANTHROPIC_CUSTOM_MODEL_OPTION_NAME]。目前值由模型編排自動填入",
+        },
+        runtime: {
+            desc: '逾時、署名、網路行為等開關',
+            timeout: '控制 API 呼叫的最長等待時間',
+            timeout_detail: "API 呼叫最大等待時間（毫秒），逾時後請求自動中斷。對應環境變數 [API_TIMEOUT_MS]。",
+            attribution: '控制是否在輸出末尾附加署名標記',
+            attribution_detail: "控制是否在 AI 輸出末尾附加署名標記（如 Generated by Claude）。對應環境變數 [CLAUDE_CODE_ATTRIBUTION_HEADER]。",
+            nonessential: '控制是否減少非核心網路請求',
+            nonessential_detail: "開啟後減少版本檢查等後台網路請求，降低 API 開銷。對應環境變數 [CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC]。",
+            effort: '控制模型回答時投入的推理深度',
+            effort_detail: "控制模型回答時投入的推理深度，值越高推理越深但耗時越長。對應環境變數 [CLAUDE_CODE_EFFORT_LEVEL]。可選值：low / medium / high / xhigh / max / auto",
+            experimental: '停用 Anthropic 實驗性 Beta 功能，提高介面穩定性',
+            experimental_detail: "開啟後停用 Anthropic 實驗性 Beta 功能，提高介面穩定性。對應環境變數 [CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS]。",
+            nonstreaming: '控制串流請求失敗時是否禁止回退為非串流模式',
+            nonstreaming_detail: "開啟後串流請求失敗不會自動降級為非串流模式，適用於僅支援串流的第三方 API。對應環境變數 [CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK]。",
+            effort_values: "可選值: low, medium, high, xhigh, max, auto",
+            source_manual: "目前值由使用者手動設定",
+            source_provider: "目前值來自 Provider 推薦預設",
+            source_default: "目前值未設定，將使用 Claude Code 內建預設",
+        },
+        custom: {
+            desc: '注入啟動環境的額外鍵值對'
         }
     },
 
+    page: {
+        model_runtime_config: '模型與執行設定',
+        model_config: '模型設定',
+        runtime_config: '執行設定',
+        custom_vars: '自訂變數'
+    },
+
+    action: {
+        follow_recommended: '跟隨建議',
+        force_enable: '強制啟用',
+        force_disable: '強制停用',
+        custom_input: '自訂輸入',
+        edit_value: '編輯值',
+        delete_variable: '刪除變數',
+        add_variable: '新增變數',
+        finish_create: '完成建立（使用目前設定）',
+        cancel_config: "取消設定",
+        please_choose: '請選擇'
+    },
+
+    prompt: {
+        empty_to_restore: '輸入空值恢復為跟隨建議',
+        exit_to_cancel: '輸入 exit 取消'
+    },
+
+    add_api: {
+        step_n_of_m: '新增 API · 步驟 {0}/{1}',
+        confirm_config: '確認設定',
+        finish_hint: '系統已根據 provider 和 model 自動填入建議設定',
+        confirm_page_prompt: "可直接完成建立（配置項使用推薦的預設值），或選擇下方配置項進行自訂修改",
+        duplicate_title: '該 API 連線已存在',
+        duplicate_enter_config: '進入已有 API 的設定頁',
+        duplicate_back: '返回修改連線資訊',
+        duplicate_draft_discarded: '注意：如果您在新增流程中修改過 env 設定，這些修改不會自動合併到已有 API',
+        duplicate_race_lost: '剛才建立的 API 已被另一流程佔用，目前草稿未保留',
+        partial_failure: '部分 env 設定寫入失敗，請手動檢查',
+        recommended_models: '建議模型'
+    },
+
+    summary: {
+        x_items: '{0} 項'
+    },
+
+    // Config label display names (used in env editing menus)
+    config_labels: {
+        model: {
+            ANTHROPIC_DEFAULT_SONNET_MODEL: '一般模型（Sonnet）',
+            ANTHROPIC_DEFAULT_OPUS_MODEL: '高強度模型（Opus）',
+            ANTHROPIC_DEFAULT_HAIKU_MODEL: '快速模型（Haiku）',
+            CLAUDE_CODE_SUBAGENT_MODEL: '子代理模型',
+            ANTHROPIC_CUSTOM_MODEL_OPTION: '自訂模型',
+            ANTHROPIC_CUSTOM_MODEL_OPTION_NAME: '自訂模型名稱',
+        },
+        runtime: {
+            API_TIMEOUT_MS: '請求逾時',
+            CLAUDE_CODE_ATTRIBUTION_HEADER: '輸出署名',
+            CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '減少非必要流量',
+            CLAUDE_CODE_EFFORT_LEVEL: '推理強度',
+            CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: '停用實驗性功能',
+            CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK: '停用非串流回退',
+        },
+    },
+
+    confirm: {
+        delete_variable: '確認刪除此變數？(y/N)'
+    },
+
     config: {
         values: {
             on: '開啟',
             off: '關閉',
             direct_mode: '直接模式',
             select_mode: '選擇模式',
-            recommended_off: '關閉 (推薦)'
+            recommended_off: '關閉 (推薦)',
+            recommended_on: '開啟 (推薦)'
         }
     }
 };

package/lib/i18n/locales/zh.js

@@ -38,6 +38,7 @@ module.exports = {
             model_upgrade_notification: "模型升级提示",
             telemetry: "Anthropic 遥测数据",
             api_launch_mode: "第三方API启动模式",
+            no_flicker: "禁用屏幕闪烁",
             back: "返回主菜单"
         },
         api_select: {
@@ -122,7 +123,8 @@ module.exports = {
             failed_add: "添加API失败：{0}",
             failed_remove: "删除API失败：{0}",
             failed_switch: "切换API失败：{0}",
-            invalid_index: "无效的API索引"
+            invalid_index: "无效的API索引",
+            not_found: "未找到API：{0}",
         },
         password: {
             empty: "密码不能为空",
@@ -194,7 +196,16 @@ module.exports = {
         exporting: "导出配置中...",
         importing: "导入配置中...",
         switching_language: "切换语言中...",
-        initializing: "初始化中..."
+        initializing: "初始化中...",
+        overridden: "已覆盖",
+        not_set: "(未设置)",
+        default: "默认",
+        enabled: "开启",
+        disabled: "关闭",
+        current_value: "当前生效",
+        recommended_value: "推荐配置",
+
+        auto: "(未设置)",
     },
 
     // API详情和标签
@@ -235,7 +246,24 @@ module.exports = {
             duplicate: '此更改将创建重复的配置',
             provider_url_mismatch: '供应商和 URL 可能不一致',
             provider_url_mismatch_detail: '供应商：{0} / URL 建议：{1}',
-            url_provider_hint: "URL 匹配供应商 '{0}'，但当前供应商为 '{1}'。建议更新供应商字段。"
+            url_provider_hint: "URL 匹配供应商 '{0}'，但当前供应商为 '{1}'。建议更新供应商字段。",
+            field_model_env_vars: '模型环境变量',
+            field_runtime_env_vars: '运行参数',
+            env_inherited: '继承',
+            env_disabled: '已关闭 [off]',
+            manage_custom_env_vars: '管理自定义变量...',
+            no_custom_vars: '(无自定义变量)',
+            add_custom_var: '+ 添加自定义变量',
+            enter_custom_key: '输入环境变量名:',
+            enter_custom_value: '输入值:',
+            warn_model_not_in_provider: '警告: 模型 "{0}" 不在 {1} 模型列表中。请手动更新模型。',
+            warn_base_url_not_updated: '提示: Base URL 未自动更新 ({0})。如需更改请手动修改。',
+            warn_mixed_provider: '注意: Provider、Base URL 和 Model 来自不同的供应商。请确认是否为有意配置。',
+        },
+        add: {
+            duplicate_detected: 'API "{0}" 已存在。跳转编辑运行参数？',
+            jump_to_edit: '跳转编辑已有 API',
+            cancel: '取消',
         }
     },
 
@@ -370,6 +398,10 @@ module.exports = {
         enter_choice: "输入您的选择（{0}，或任意其他键返回主菜单）：",
         arrow_keys_not_available: "方向键不可用。输入选择编号 (1-{0})：",
         enter_choice_prompt: "[>] 输入您的选择 (1-2，或任意其他键返回主菜单): ",
+        input_1_to_n_or_q: "输入 1-{0} 或 q：",
+        invalid_selection: "无效选择。请输入 1-{0}。",
+        enter_to_edit: "回车键编辑，ESC键返回",
+        enter_to_select: "回车键选择，ESC键返回",
         action: {
             edit: '编辑',
             remove: '删除',
@@ -656,7 +688,7 @@ module.exports = {
         select_mode_active_none: '无',
         no_api_configured: '未配置第三方API，请先在「第三方API管理」中添加',
         api_management_info: '已配置 {0} 个API，当前激活: {1}',
-        config_summary: '语言: {0} | 启动模式: {1} | 遥测: {2}',
+        config_summary: '语言: {0} | 启动模式: {1} | 遥测: {2} | 无闪烁: {3}',
         edit_password_required: '🔒 编辑API配置需要密码验证',
         remove_password_required: '🔒 删除API需要密码验证',
         export_password_required: '🔒 导出配置需要密码验证',
@@ -666,22 +698,134 @@ module.exports = {
             auto_upgrade: '自动检测并升级第三方API的模型版本',
             upgrade_notification: '在主菜单顶部显示模型可升级的通知',
             telemetry: '关闭后启动时注入 DISABLE_TELEMETRY=1，建议关闭',
-            launch_mode: '直接模式: 使用激活API启动 / 选择模式: 启动前从列表选择'
+            launch_mode: '直接模式: 使用激活API启动 / 选择模式: 启动前从列表选择',
+            no_flicker: '禁用屏幕闪烁 (CLAUDE_CODE_NO_FLICKER)'
         },
         api_select: {
             info: 'API: {0}',
             detail: '提供商: {0} | 模型: {1}',
             usage: '使用次数: {0} | 最后使用: {1}'
+        },
+        model: {
+            desc: '指定各场景使用的模型版本',
+            sonnet: '对应 Claude Code 的 Sonnet 档位',
+            sonnet_detail: "Claude Code 日常对话使用的默认模型，平衡速度与推理能力。对应环境变量 [ANTHROPIC_DEFAULT_SONNET_MODEL]。当前值由模型编排按同代 Sonnet 档位自动匹配",
+            opus: '对应 Claude Code 的 Opus 档位',
+            opus_detail: "处理复杂推理、深度分析任务时使用的模型，能力最强。对应环境变量 [ANTHROPIC_DEFAULT_OPUS_MODEL]。当前值由模型编排按同代 Opus 档位自动匹配",
+            haiku: '对应 Claude Code 的 Haiku 档位',
+            haiku_detail: "轻量快速场景使用的模型，适合简单任务和高频调用。对应环境变量 [ANTHROPIC_DEFAULT_HAIKU_MODEL]。当前值由模型编排按同代高速变体自动匹配",
+            subagent: '子任务或分支执行时优先使用的模型',
+            subagent_detail: "子任务、分支执行时使用的模型，建议与快速模型一致以降低延迟和成本。对应环境变量 [CLAUDE_CODE_SUBAGENT_MODEL]。当前值由模型编排自动填充",
+            custom_option: '额外加入 /model 选择器的模型 ID',
+            custom_option_detail: "向第三方 API 发起请求时使用的模型 ID。对应环境变量 [ANTHROPIC_CUSTOM_MODEL_OPTION]。当前值由模型编排自动填充",
+            custom_name: '自定义模型在 /model 中的显示名',
+            custom_name_detail: "该模型在 /model 命令选择器中的显示名称。对应环境变量 [ANTHROPIC_CUSTOM_MODEL_OPTION_NAME]。当前值由模型编排自动填充",
+        },
+        runtime: {
+            desc: '超时、署名、网络行为等开关',
+            timeout: '控制 API 调用的最长等待时间',
+            timeout_detail: "API 调用最大等待时间（毫秒），超时后请求自动中断。对应环境变量 [API_TIMEOUT_MS]。",
+            attribution: '控制是否在输出末尾附加署名标记',
+            attribution_detail: "控制是否在 AI 输出末尾附加署名标记（如 Generated by Claude）。对应环境变量 [CLAUDE_CODE_ATTRIBUTION_HEADER]。",
+            nonessential: '控制是否减少非核心网络请求',
+            nonessential_detail: "开启后减少版本检查等后台网络请求，降低 API 开销。对应环境变量 [CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC]。",
+            effort: '控制模型回答时投入的推理深度',
+            effort_detail: "控制模型回答时投入的推理深度，值越高推理越深但耗时更长。对应环境变量 [CLAUDE_CODE_EFFORT_LEVEL]。可选值：low / medium / high / xhigh / max / auto",
+            experimental: '禁用 Anthropic 实验性 Beta 功能，提高接口稳定性',
+            experimental_detail: "开启后禁用 Anthropic 实验性 Beta 功能，提高接口稳定性。对应环境变量 [CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS]。",
+            nonstreaming: '控制流式请求失败时是否禁止回退到非流式模式',
+            nonstreaming_detail: "开启后流式请求失败不会自动降级为非流式模式，适用于仅支持流式的第三方 API。对应环境变量 [CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK]。",
+            effort_values: "可选值: low, medium, high, xhigh, max, auto",
+            source_manual: "当前值由用户手动设置",
+            source_provider: "当前值来自 Provider 推荐默认",
+            source_default: "当前值未设置，将使用 Claude Code 内置默认",
+        },
+        custom: {
+            desc: '注入启动环境的额外键值对'
         }
     },
 
+    // Page titles for env config sections
+    page: {
+        model_runtime_config: '模型与运行配置',
+        model_config: '模型配置',
+        runtime_config: '运行配置',
+        custom_vars: '自定义变量'
+    },
+
+    // Actions for env config editing
+    action: {
+        follow_recommended: '跟随推荐',
+        force_enable: '强制开启',
+        force_disable: '强制关闭',
+        custom_input: '自定义输入',
+        edit_value: '编辑值',
+        delete_variable: '删除变量',
+        add_variable: '添加变量',
+        finish_create: '完成创建（使用当前配置）',
+        cancel_config: "取消配置",
+        please_choose: '请选择'
+    },
+
+    // Prompts
+    prompt: {
+        empty_to_restore: '输入空值恢复为跟随推荐',
+        exit_to_cancel: '输入 exit 取消'
+    },
+
+    // Add API flow
+    add_api: {
+        step_n_of_m: '添加 API · 步骤 {0}/{1}',
+        confirm_config: '确认配置',
+        finish_hint: '系统已根据 provider 和 model 自动填充推荐配置',
+        confirm_page_prompt: "可直接完成创建（配置项使用推荐的默认值），或选择下方配置项进行自定义修改",
+        duplicate_title: '该 API 连接已存在',
+        duplicate_enter_config: '进入已有 API 的配置页',
+        duplicate_back: '返回修改连接信息',
+        duplicate_draft_discarded: '注意：如果你在新增流程中修改过 env 配置，这些修改不会自动合并到已有 API',
+        duplicate_race_lost: '刚刚创建的 API 已被另一流程占用，当前草稿未保留',
+        partial_failure: '部分 env 配置写入失败，请手动检查',
+        recommended_models: '推荐模型'
+    },
+
+    // Summary
+    summary: {
+        x_items: '{0} 项'
+    },
+
+    // Config label display names (used in env editing menus)
+    config_labels: {
+        model: {
+            ANTHROPIC_DEFAULT_SONNET_MODEL: '常规模型（Sonnet）',
+            ANTHROPIC_DEFAULT_OPUS_MODEL: '高强度模型（Opus）',
+            ANTHROPIC_DEFAULT_HAIKU_MODEL: '快速模型（Haiku）',
+            CLAUDE_CODE_SUBAGENT_MODEL: '子代理模型',
+            ANTHROPIC_CUSTOM_MODEL_OPTION: '自定义模型',
+            ANTHROPIC_CUSTOM_MODEL_OPTION_NAME: '自定义模型名称',
+        },
+        runtime: {
+            API_TIMEOUT_MS: '请求超时',
+            CLAUDE_CODE_ATTRIBUTION_HEADER: '输出署名',
+            CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '减少非必要流量',
+            CLAUDE_CODE_EFFORT_LEVEL: '推理强度',
+            CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: '禁用实验性功能',
+            CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK: '禁用非流式回退',
+        },
+    },
+
+    // Confirmations
+    confirm: {
+        delete_variable: '确认删除此变量？(y/N)'
+    },
+
     config: {
         values: {
             on: '开启',
             off: '关闭',
             direct_mode: '直接模式',
             select_mode: '选择模式',
-            recommended_off: '关闭 (推荐)'
+            recommended_off: '关闭 (推荐)',
+            recommended_on: '开启 (推荐)'
         }
     }
 };

package/lib/launcher.js

@@ -108,6 +108,9 @@ function launchClaude(command, envVars = {}, disableAuthTokens = false, opts = {
     if (launcherConfig.disableTelemetry) {
         envVars.DISABLE_TELEMETRY = '1';
     }
+    if (launcherConfig.noFlicker) {
+        envVars.CLAUDE_CODE_NO_FLICKER = '1';
+    }
 
     // Disable Ctrl+C monitoring before launching Claude Code
     // This allows Ctrl+C to be handled exclusively by Claude Code process
@@ -137,9 +140,8 @@ function launchClaude(command, envVars = {}, disableAuthTokens = false, opts = {
 
     // Disable conflicting auth tokens when using third-party API
     if (disableAuthTokens) {
-        // Only delete CLAUDE_CODE_OAUTH_TOKEN - keep ANTHROPIC_AUTH_TOKEN that we just set
         delete env.CLAUDE_CODE_OAUTH_TOKEN;
-        console.log(colors.gray + '  Disabled: CLAUDE_CODE_OAUTH_TOKEN' + colors.reset);
+        delete env.ANTHROPIC_API_KEY;
     }
 
     // Parse command and arguments
@@ -214,36 +216,63 @@ function launchClaudeAutoMode() {
  * Get environment variables based on provider type
  */
 function getProviderEnvVars(api) {
-    // Decrypt the auth token (all tokens are stored encrypted)
     const { decrypt } = require('./crypto');
     const decrypted = decrypt(api.authToken);
-
     if (!decrypted.success) {
-        console.error('Failed to decrypt auth token:', decrypted.error);
         throw new Error('Failed to decrypt API auth token. Please check your configuration.');
     }
 
     const authToken = decrypted.value;
 
-    const baseEnvVars = {
+    // Step 1: Base variables
+    const env = {
         ANTHROPIC_BASE_URL: api.baseUrl,
         ANTHROPIC_AUTH_TOKEN: authToken,
         ANTHROPIC_MODEL: api.model,
-        ANTHROPIC_SMALL_FAST_MODEL: api.smallFastModel || api.model
+        ANTHROPIC_SMALL_FAST_MODEL: api.smallFastModel || api.model,
     };
 
-    // Get provider configuration and merge provider-specific environment variables
+    // Step 2: Provider-level defaults
     const providerConfig = getProvider(api.provider);
-
     if (providerConfig && providerConfig.envVars) {
-        // Merge base env vars with provider-specific env vars
-        return {
-            ...baseEnvVars,
-            ...providerConfig.envVars
-        };
+        Object.assign(env, providerConfig.envVars);
+    }
+
+    const { PREDEFINED_MODEL_ENV_KEYS, PREDEFINED_RUNTIME_KEYS, TYPE_A_FIELDS, RESERVED_ENV_KEYS } = require('./validators');
+
+    // Step 3: modelEnvVars (whitelist, non-empty)
+    if (api.modelEnvVars) {
+        for (const key of PREDEFINED_MODEL_ENV_KEYS) {
+            const val = api.modelEnvVars[key];
+            if (val !== undefined && val !== '') env[key] = val;
+        }
+    }
+
+    // Step 4: runtimeEnvVars (whitelist, non-empty, skip "off")
+    if (api.runtimeEnvVars) {
+        for (const key of PREDEFINED_RUNTIME_KEYS) {
+            const val = api.runtimeEnvVars[key];
+            if (val !== undefined && val !== '' && val !== 'off') env[key] = val;
+        }
+    }
+
+    // Step 5: customEnvVars (skip reserved/predefined)
+    if (api.customEnvVars) {
+        const allPredefined = new Set([...RESERVED_ENV_KEYS, ...PREDEFINED_RUNTIME_KEYS, ...PREDEFINED_MODEL_ENV_KEYS]);
+        for (const [key, val] of Object.entries(api.customEnvVars)) {
+            if (allPredefined.has(key)) continue;
+            if (val !== undefined && val !== '') env[key] = val;
+        }
+    }
+
+    // Step 6: Remove Type A fields with "off" (tombstone)
+    if (api.runtimeEnvVars) {
+        for (const key of TYPE_A_FIELDS) {
+            if (api.runtimeEnvVars[key] === 'off') delete env[key];
+        }
     }
 
-    return baseEnvVars;
+    return env;
 }
 
 /**
@@ -281,8 +310,8 @@ function launchClaudeWithApi(api, skipPermissions = false, opts = {}) {
     if (providerConfig && providerConfig.envVars && Object.keys(providerConfig.envVars).length > 0) {
         console.log(colors.yellow + '  ⚡ ' + i18n.tSync('launch.provider_optimizations_applied') + colors.reset);
 
-        // Display specific optimizations based on envVars
-        const msRaw = providerConfig.envVars.API_TIMEOUT_MS;
+        // Display specific optimizations from merged envVars
+        const msRaw = envVars.API_TIMEOUT_MS;
         const ms = Number(msRaw);
         if (Number.isFinite(ms) && ms > 0) {
             const timeoutSec = Math.floor(ms / 1000);