@cc-x/cc-x 0.4.7 → 0.4.9

package/README.en.md

@@ -29,7 +29,7 @@ different path: **switching happens purely at the environment-variable layer.**
 reads or writes any Claude Code config file. Your MCP, plugins, hooks — it won't touch them.
 
 ```text
-  CC-X v0.4.7 · Claude Code API switcher     Default: Official
+  CC-X v0.4.8 · Claude Code API switcher     Default: Official
 
    ▶ Official          (default)[Logged in]
      DeepSeek            [Key set] — work
@@ -89,6 +89,19 @@ xx DeepSeek -s     # Use this session, launch Claude now
 xx DeepSeek        # Set as default for new terminals
 ```
 
+### Updating
+
+Updating just means **re-running the install command** — the installer downloads the latest
+release and overwrites the old binary in place, no uninstall needed. **Open a new terminal**
+afterward; `xx --version` should show the new version.
+
+- **Windows**: `irm https://github.com/becomeless/cc-x/releases/latest/download/install.ps1 | iex`
+- **macOS / Linux**: `curl -fsSL https://github.com/becomeless/cc-x/releases/latest/download/install.sh | sh`
+- **npm**: `npm i -g @cc-x/cc-x@latest`
+
+> With the menu's "Update check" set to "notify", CC-X shows a banner at the top of the menu
+> when a new version is out, with the matching upgrade command for your platform.
+
 ---
 
 ## 60-second quick start
@@ -165,7 +178,7 @@ cc-switch is an excellent full-featured GUI; CC-X takes the opposite, minimal ap
 
 > CC-X cares more about boundaries than features.
 
-Claude Code already has its own config system, MCP ecosystem, and session state. CC-X is not trying to become a control panel above it, or to copy user config into another database. It stands at one narrow point before Claude Code starts: prepare the 7 managed environment variables, then let Claude Code run.
+Claude Code already has its own config system, MCP ecosystem, and session state. CC-X is not trying to become a control panel above it, or to copy user config into another database. It stands at one narrow point before Claude Code starts: prepare the 9 managed environment variables, then let Claude Code run.
 
 That constraint is deliberate: no writes to Claude Code config files, no MCP management, no automatic migration, no resident background controller. If process environment variables can solve it, CC-X avoids global files; if a choice matters, the user makes it explicitly. Doing less keeps the failure surface small.
 
@@ -186,6 +199,8 @@ Issues / PRs are welcome, but the direction is clear: **make switching steadier,
 | sonnet → model | `ANTHROPIC_DEFAULT_SONNET_MODEL` | |
 | haiku → model | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | |
 | effort level | `CLAUDE_CODE_EFFORT_LEVEL` | `low`–`max`; `auto` = model default; empty = unset. Third parties may not honor it |
+| Disable nonessential traffic | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1` disables nonessential Claude Code traffic; empty = unset. Zhipu GLM defaults to `1` |
+| Context window | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Fill with a Claude Code-supported window value; empty = unset |
 
 > CC-X **deliberately does not set** `ANTHROPIC_MODEL`. Use `/model opus|sonnet|haiku` in-session;
 > the mapping table translates to the provider's real model name.
@@ -199,12 +214,12 @@ Issues / PRs are welcome, but the direction is clear: **make switching steadier,
 
 ### Pre-seeded profiles
 
-| Profile | BASE_URL | OPUS / SONNET | HAIKU (incl. background) | effort |
-|---|---|---|---|---|
-| Official | empty (logged-in) | — | — | — |
-| DeepSeek | `https://api.deepseek.com/anthropic` | `deepseek-v4-pro` | `deepseek-v4-flash` | `max` (recommended) |
-| Zhipu GLM | `https://open.bigmodel.cn/api/anthropic` | `GLM-4.7` | `glm-4.5-air` | — |
-| Xiaomi MiMo | `https://api.xiaomimimo.com/anthropic` | `mimo-v2.5-pro` | `mimo-v2.5-pro` | — |
+| Profile | BASE_URL | OPUS / SONNET | HAIKU (incl. background) | effort | Extra env |
+|---|---|---|---|---|---|
+| Official | empty (logged-in) | — | — | — | — |
+| DeepSeek | `https://api.deepseek.com/anthropic` | `deepseek-v4-pro` | `deepseek-v4-flash` | `max` (recommended) | — |
+| Zhipu GLM | `https://open.bigmodel.cn/api/anthropic` | `GLM-4.7` | `glm-4.5-air` | — | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` |
+| Xiaomi MiMo | `https://api.xiaomimimo.com/anthropic` | `mimo-v2.5-pro` | `mimo-v2.5-pro` | — | — |
 
 > Model names change as providers update. Xiaomi MiMo has both pay-as-you-go and TokenPlan
 > endpoints; you pick one when selecting the provider.
@@ -215,9 +230,9 @@ Issues / PRs are welcome, but the direction is clear: **make switching steadier,
   with ` 2`, ` 3`… Use **Note** to tell them apart, shown as "Provider — Note".
 - **Custom providers**: `presets.json` is the provider catalog; add a JSON entry to offer a new
   one, no code change. Drop `~/.cc-mini/presets.json` to override the shipped catalog.
-- **First-launch login prompt**: third-party APIs may still show onboarding. Add
-  `"hasCompletedOnboarding": true` to `~/.claude.json` (**only this key** — don't overwrite
-  the file; it also holds your MCP config).
+- **First-launch login prompt**: before launching a third-party profile, CC-X reads
+  `hasCompletedOnboarding` from `~/.claude.json` and prints a non-blocking hint when onboarding
+  is unfinished. It does not write the file; dismiss or skip the Claude Code prompt if it appears.
 - **Update check**: toggle to "notify" in the menu — a yellow one-liner appears atop the menu
   when a new release is out. At most one check per day; never auto-upgrades.
 
@@ -231,11 +246,13 @@ Issues / PRs are welcome, but the direction is clear: **make switching steadier,
   - Windows → registry `HKCU\Environment` + one change broadcast
   - Unix → `# >>> xx >>>` … `# <<< xx <<<` marker block in shell startup file (idempotent rewrite, chosen by `$SHELL`)
   - Same semantics either way: **only affects new terminals**; switching to "Official" clears all managed vars
-- **No Claude Code config file is ever modified.**
+- **No Claude Code config file is ever modified.** Before third-party launches, CC-X only reads
+  the onboarding field in `~/.claude.json` to decide whether to print a hint.
 
-CC-X only touches these 7 "managed" variables (and clears the ones a target profile doesn't use):
+CC-X only touches these 9 "managed" variables (and clears the ones a target profile doesn't use):
 `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_API_KEY`, `ANTHROPIC_DEFAULT_OPUS_MODEL`,
-`ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `CLAUDE_CODE_EFFORT_LEVEL`.
+`ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `CLAUDE_CODE_EFFORT_LEVEL`,
+`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `CLAUDE_CODE_AUTO_COMPACT_WINDOW`.
 
 > 💡 To change `settings.json`, use Claude Code's own `/update-config` and describe what you want
 > in natural language (e.g. "allow npm commands") — safer than letting an external tool rewrite it.

package/README.md

@@ -28,7 +28,7 @@ CC-X 把这事儿做到了最简——切换只在环境变量层，**不读写
 你的 MCP、插件、hooks，它碰都不会碰。
 
 ```text
-  CC-X v0.4.7 · Claude Code API 切换器     默认：官方
+  CC-X v0.4.8 · Claude Code API 切换器     默认：官方
 
    ▶ 官方            （默认）[登录态]
      DeepSeek                [密钥已设] — 公司
@@ -87,6 +87,16 @@ xx DeepSeek -s     # 本次启用，立即启动 Claude
 xx DeepSeek        # 设为默认，以后新终端自动生效
 ```
 
+### 更新到新版本
+
+更新就是**重新跑一遍安装命令**——安装器会下载最新版覆盖旧的，不用先卸载。跑完**新开一个终端**，`xx --version` 即为新版本。
+
+- **Windows**：`irm https://github.com/becomeless/cc-x/releases/latest/download/install.ps1 | iex`
+- **macOS / Linux**：`curl -fsSL https://github.com/becomeless/cc-x/releases/latest/download/install.sh | sh`
+- **npm**：`npm i -g @cc-x/cc-x@latest`
+
+> 把菜单里的「更新检查」开到「提醒」后，有新版时 CC-X 会在菜单顶部横幅提示，并直接给出上面对应平台的升级命令。
+
 ---
 
 ## 60 秒上手
@@ -158,7 +168,7 @@ cc-switch 是优秀的全能 GUI；CC-X 走相反的极简路线。
 
 > CC-X 的边界比功能更重要。
 
-Claude Code 已经有自己的配置系统、MCP 生态和会话状态。CC-X 不想再造一个"上层控制台"，也不想把用户的配置收编进自己的数据库。它只站在 Claude Code 进程启动前的那一小步：把 7 个受管环境变量准备好，然后让 Claude Code 自己工作。
+Claude Code 已经有自己的配置系统、MCP 生态和会话状态。CC-X 不想再造一个"上层控制台"，也不想把用户的配置收编进自己的数据库。它只站在 Claude Code 进程启动前的那一小步：把 9 个受管环境变量准备好，然后让 Claude Code 自己工作。
 
 所以它的取舍是有意的：不写 Claude Code 配置文件，不接管 MCP，不做自动迁移，不做后台常驻管理。能用进程环境变量解决，就不碰全局文件；能让用户显式选择，就不替用户自动决定。少做一点，是为了把风险面压到足够小。
 
@@ -179,6 +189,8 @@ Claude Code 已经有自己的配置系统、MCP 生态和会话状态。CC-X
 | sonnet → 模型 | `ANTHROPIC_DEFAULT_SONNET_MODEL` | |
 | haiku → 模型 | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | |
 | effort 思考档 | `CLAUDE_CODE_EFFORT_LEVEL` | `low` ~ `max`；`auto`=模型默认；留空=不设。第三方不一定生效 |
+| 禁用非核心流量 | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1`=禁用 Claude Code 非核心流量；留空=不设。GLM 预置为 `1` |
+| 上下文窗口大小 | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 按 Claude Code 支持的窗口值填写；留空=不设 |
 
 > CC-X **刻意不设** `ANTHROPIC_MODEL`。在会话里用 `/model opus|sonnet|haiku` 选档，映射表负责翻译成对应供应商的模型名。
 
@@ -191,12 +203,12 @@ Claude Code 已经有自己的配置系统、MCP 生态和会话状态。CC-X
 
 ### 预置配置
 
-| 配置 | BASE_URL | OPUS / SONNET | HAIKU（含后台任务） | effort |
-|---|---|---|---|---|
-| 官方 | 留空=登录态 | — | — | — |
-| DeepSeek | `https://api.deepseek.com/anthropic` | `deepseek-v4-pro` | `deepseek-v4-flash` | `max`（官方推荐） |
-| 智谱GLM | `https://open.bigmodel.cn/api/anthropic` | `GLM-4.7` | `glm-4.5-air` | — |
-| 小米MiMo | `https://api.xiaomimimo.com/anthropic` | `mimo-v2.5-pro` | `mimo-v2.5-pro` | — |
+| 配置 | BASE_URL | OPUS / SONNET | HAIKU（含后台任务） | effort | 额外 env |
+|---|---|---|---|---|---|
+| 官方 | 留空=登录态 | — | — | — | — |
+| DeepSeek | `https://api.deepseek.com/anthropic` | `deepseek-v4-pro` | `deepseek-v4-flash` | `max`（官方推荐） | — |
+| 智谱GLM | `https://open.bigmodel.cn/api/anthropic` | `GLM-4.7` | `glm-4.5-air` | — | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` |
+| 小米MiMo | `https://api.xiaomimimo.com/anthropic` | `mimo-v2.5-pro` | `mimo-v2.5-pro` | — | — |
 
 > 模型名随各家更新而变，以供应商官方接入文档为准。小米有按量付费和 TokenPlan 两个地址，选供应商时会让你挑。
 
@@ -204,7 +216,7 @@ Claude Code 已经有自己的配置系统、MCP 生态和会话状态。CC-X
 
 - **多账号**：同一家建多份配置，名称自动追加「 2」「 3」…用**备注**区分，列表显示为「供应商 — 备注」。
 - **自定义供应商**：`presets.json` 是供应商目录，加一个 JSON 条目就多一个供应商，无需改代码。可在 `~/.cc-mini/presets.json` 放自定义版覆盖随工具发布的版本。
-- **第三方首次弹登录**：在 `~/.claude.json` 最外层加 `"hasCompletedOnboarding": true`（**只加这个键**，别覆盖整个文件——里面还有你的 MCP 配置）。
+- **第三方首次弹登录**：CC-X 启动第三方前会只读检测 `~/.claude.json` 的 `hasCompletedOnboarding`，未完成时只打印提示，不阻断、不写文件；若 Claude Code 仍显示引导，按提示跳过或关闭即可。
 - **更新检查**：主菜单可切「提醒」模式，新版本出现时菜单顶部黄字提示升级命令。每天最多查一次，不自动升级。
 
 ---
@@ -217,10 +229,10 @@ Claude Code 已经有自己的配置系统、MCP 生态和会话状态。CC-X
   - Windows → 注册表 `HKCU\Environment` + 广播一次变更
   - Unix → shell 启动文件 `# >>> xx >>>` … `# <<< xx <<<` 标记块（幂等重写，按 `$SHELL` 选文件）
   - 语义一致：**只影响新终端**；切到「官方」会清除全部受管变量
-- **不修改任何 Claude Code 配置文件。**
+- **不修改任何 Claude Code 配置文件。** 启动第三方前只读探测一次 `~/.claude.json` 的 onboarding 字段，用于提示。
 
-CC-X 只动这 7 个「受管」环境变量，切换时清掉目标不用的：
-`ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`CLAUDE_CODE_EFFORT_LEVEL`。
+CC-X 只动这 9 个「受管」环境变量，切换时清掉目标不用的：
+`ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`CLAUDE_CODE_EFFORT_LEVEL`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`CLAUDE_CODE_AUTO_COMPACT_WINDOW`。
 
 > 💡 需要改 `settings.json`？直接用 Claude Code 的 `/update-config` 说需求（如"允许 npm 命令"），比让外部工具改可靠。
 

package/dist/actions.js

@@ -1,7 +1,8 @@
 /**
  * 共享动作：本次启用（CLI 路径与菜单都用，避免 index ↔ menus 循环依赖）。
  */
-import { getProviderState } from './config/store.js';
+import { hasCompletedOnboarding } from './claudecfg.js';
+import { isOfficial, getProviderState } from './config/store.js';
 import { sessionLaunch } from './env/session.js';
 import { providerDisplayName, T } from './i18n/index.js';
 /** 非官方且未填密钥时给黄字提示（对齐现版）。 */
@@ -13,6 +14,9 @@ export function warnIfNoKey(p) {
 /** 本次启用：缺密钥提示 + banner + 套环境启动 claude，阻塞至其退出。 */
 export function launchSession(p) {
     warnIfNoKey(p);
+    if (!isOfficial(p) && !hasCompletedOnboarding()) {
+        console.log(`  ${T('session.onboardingHint')}`);
+    }
     console.log('');
     console.log(`  ${T('session.launch', providerDisplayName(p))}`);
     console.log(`  ${T('session.starting')}`);

package/dist/claudecfg.js

@@ -0,0 +1,23 @@
+/**
+ * 对 ~/.claude.json 的只读访问。
+ * 铁律：只读不写，任何写操作都在 ccx 范围之外。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * 只读检测 ~/.claude.json 的 hasCompletedOnboarding 字段。
+ * 文件不存在、解析失败或字段缺失，均返回 false（视为未完成）。
+ */
+export function hasCompletedOnboarding() {
+    const path = join(homedir(), '.claude.json');
+    if (!existsSync(path))
+        return false;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf-8'));
+        return data.hasCompletedOnboarding === true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/config/presets.js

@@ -26,6 +26,10 @@ export const BUILTIN_PRESETS = [
         auth: 'AUTH_TOKEN',
         urls: [{ label: 'Anthropic 兼容', url: 'https://open.bigmodel.cn/api/anthropic' }],
         models: { opus: 'GLM-4.7', sonnet: 'GLM-4.7', haiku: 'glm-4.5-air' },
+        env: {
+            CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
+            CLAUDE_CODE_AUTO_COMPACT_WINDOW: '1000000',
+        },
     },
     {
         name: '小米MiMo',
@@ -59,6 +63,16 @@ function normalizeModels(raw) {
         models.haiku = m.haiku;
     return models;
 }
+const PRESET_ENV_KEYS = ['CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW'];
+function normalizeEnv(raw) {
+    const m = (raw && typeof raw === 'object' ? raw : {});
+    const env = {};
+    for (const key of PRESET_ENV_KEYS) {
+        if (typeof m[key] === 'string')
+            env[key] = m[key];
+    }
+    return Object.keys(env).length > 0 ? env : undefined;
+}
 function normalizePreset(raw) {
     const p = (raw && typeof raw === 'object' ? raw : {});
     const name = asString(p.name).trim();
@@ -69,6 +83,9 @@ function normalizePreset(raw) {
     const preset = { name, auth, urls, models: normalizeModels(p.models) };
     if (typeof p.effort === 'string' && p.effort.trim())
         preset.effort = p.effort.trim();
+    const env = normalizeEnv(p.env);
+    if (env)
+        preset.env = env;
     return preset;
 }
 /** 把任意解析结果规整为 Preset[]；非数组或全空则返回 undefined（让调用方跌落兜底）。 */

package/dist/config/store.js

@@ -44,6 +44,7 @@ export function defaultStore() {
                     ANTHROPIC_DEFAULT_OPUS_MODEL: 'GLM-4.7',
                     ANTHROPIC_DEFAULT_SONNET_MODEL: 'GLM-4.7',
                     ANTHROPIC_DEFAULT_HAIKU_MODEL: 'glm-4.5-air',
+                    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
                 },
             },
             {

package/dist/config/types.js

@@ -3,7 +3,7 @@
  *
  * 数据格式必须与现版 PowerShell 完全兼容（老用户的 ~/.cc-mini/providers.json 能直接读）。
  */
-/** 受管的 7 个环境变量（工具只动这些，其它一律不碰）。详见 plan §2。 */
+/** 受管的 9 个环境变量（工具只动这些，其它一律不碰）。详见 plan §2。 */
 export const KNOWN_KEYS = [
     'ANTHROPIC_BASE_URL',
     'ANTHROPIC_AUTH_TOKEN',
@@ -12,4 +12,6 @@ export const KNOWN_KEYS = [
     'ANTHROPIC_DEFAULT_SONNET_MODEL',
     'ANTHROPIC_DEFAULT_HAIKU_MODEL',
     'CLAUDE_CODE_EFFORT_LEVEL',
+    'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC',
+    'CLAUDE_CODE_AUTO_COMPACT_WINDOW',
 ];

package/dist/env/default.js

@@ -1,7 +1,7 @@
 /**
  * 设为默认（Set-Default）—— 持久化用户环境变量，仅影响新开终端、不动运行中会话。
  *
- * 对 7 个受管键：目标配置有值的写值，没值的清除（vals 里记 null）。然后 store.current=name 并存盘。
+ * 对 9 个受管键：目标配置有值的写值，没值的清除（vals 里记 null）。然后 store.current=name 并存盘。
  * 平台分叉是唯一有平台差异的地方：Windows 走注册表+广播，Unix 走 rc 文件 marker 块。
  * `--default-scope process` = 不落盘 dry-run（评审⑥）：照常算 vals、更新 store，但跳过系统持久化。
  */
@@ -18,23 +18,33 @@ export function computeManagedVals(p) {
     }
     return vals;
 }
-export function setDefault(paths, store, p, scope) {
+export function persistDefaultEnv(p, scope) {
     const vals = computeManagedVals(p);
     const dryRun = scope === 'process';
     const result = { scope, dryRun };
-    let persisted = true;
     if (!dryRun) {
         if (process.platform === 'win32') {
             result.windows = persistWindows(vals);
-            persisted = result.windows.ok;
         }
         else {
             result.unix = persistUnix(vals);
-            persisted = !result.unix.unsupported; // fish 未写入 → 不算持久化成功
         }
     }
+    return result;
+}
+function envPersisted(result) {
+    if (result.dryRun)
+        return true;
+    if (result.windows)
+        return result.windows.ok;
+    if (result.unix)
+        return !result.unix.unsupported; // fish 未写入 → 不算持久化成功
+    return false;
+}
+export function setDefault(paths, store, p, scope) {
+    const result = persistDefaultEnv(p, scope);
     // [P1] 仅当持久化成功（或 dry-run）才改默认指向并落盘，避免「报失败却已改默认」的不一致。
-    if (dryRun || persisted) {
+    if (envPersisted(result)) {
         store.current = p.name;
         saveStore(paths, store);
     }

package/dist/env/persist-windows.js

@@ -3,7 +3,7 @@
  *
  * 评审③：钉 `powershell.exe`（5.1，Windows 必然存在），不用 `pwsh`（7+，可能没装）。
  * 逻辑搬自现版 Set-UserEnv-Fast + Invoke-EnvBroadcast：注册表瞬时写入、最后只广播一次（100ms 短超时、
- * SMTO_ABORTIFHUNG 跳过挂死窗口），避免「逐个 setx 广播 7 次、每窗口等 1s」的拖慢。
+ * SMTO_ABORTIFHUNG 跳过挂死窗口），避免「逐个 setx 广播 9 次、每窗口等 1s」的拖慢。
  *
  * 键值通过环境变量传 JSON 给子进程、用 ConvertFrom-Json 解析 —— 彻底避开命令行注入/引号转义。
  */

package/dist/env/session.js

@@ -1,7 +1,7 @@
 /**
  * 本次启用（Session-Launch）—— 进程级、阅后即焚。
  *
- * 1) 对 7 个受管键：有值 set，没值 delete（只动这 7 个）。
+ * 1) 对 9 个受管键：有值 set，没值 delete（只动这 9 个）。
  * 2) 找到 claude（which；Windows 上是 claude.cmd，评审②）。
  * 3) spawn 且 stdio:inherit —— 子进程继承真实控制台句柄，天然没有现版 PowerShell 的
  *    「stdin 被包成管道 → claude 误判非交互」问题。
@@ -10,7 +10,7 @@
 import { spawnSync } from 'node:child_process';
 import which from 'which';
 import { KNOWN_KEYS, getProviderEnvMap } from '../config/store.js';
-/** 把目标配置的受管环境变量套到当前进程（有值 set、没值 delete，只动这 7 个）。 */
+/** 把目标配置的受管环境变量套到当前进程（有值 set、没值 delete，只动这 9 个）。 */
 export function applyManagedEnv(p) {
     const map = getProviderEnvMap(p);
     for (const key of KNOWN_KEYS) {

package/dist/i18n/messages.js

@@ -90,6 +90,8 @@ export const messages = {
     'edit.field.sonnet': { zh: 'sonnet→ 模型  ', en: 'sonnet→ model ' },
     'edit.field.haiku': { zh: 'haiku → 模型  ', en: 'haiku → model ' },
     'edit.field.effort': { zh: 'effort 思考档 ', en: 'effort level  ' },
+    'edit.field.disableTraffic': { zh: '禁用非核心流量  ', en: 'Disable traffic ' },
+    'edit.field.autoCompact': { zh: '上下文窗口大小  ', en: 'Context window  ' },
     'edit.toggleSecretShow': { zh: '显示密钥明文（当前隐藏）', en: 'Show key in plaintext (now hidden)' },
     'edit.toggleSecretHide': { zh: '隐藏密钥（当前明文）', en: 'Hide key (now shown)' },
     'edit.save': { zh: '保存并返回', en: 'Save & back' },
@@ -121,6 +123,7 @@ export const messages = {
     'error.storeRead': { zh: '配置文件读取失败：{0}', en: 'Failed to read config file: {0}' },
     'error.storeCorrupt': { zh: '配置文件解析失败（JSON 语法错误）：{0}', en: 'Failed to parse config file (invalid JSON): {0}' },
     'error.storeFormat': { zh: '配置文件结构不正确（顶层须为对象、providers 须为数组且条目结构合法）：{0}', en: 'Config file has invalid structure (top-level must be an object, providers must be an array with valid profile entries): {0}' },
+    'error.storeSave': { zh: '配置文件保存失败：{0}', en: 'Failed to save config file: {0}' },
     'error.storeCorruptHint': {
         zh: '为避免误删，未对它做任何改动。请修复后重试；或删除该文件以重新生成默认配置（会丢失已填的密钥）。',
         en: 'Left untouched to avoid data loss. Fix it and retry; or delete the file to regenerate defaults (loses any saved keys).',
@@ -138,6 +141,10 @@ export const messages = {
     },
     'session.noClaude': { zh: '未找到 claude 命令，请确认它在 PATH 中。', en: 'claude not found on PATH.' },
     'session.noClaudeHint': { zh: '下一步：安装 Claude Code 后新开终端；npm 用户可运行 `npm install -g @anthropic-ai/claude-code`。', en: 'Next: install Claude Code and open a new terminal; npm users can run `npm install -g @anthropic-ai/claude-code`.' },
+    'session.onboardingHint': {
+        zh: '提示：若 Claude Code 首次启动出现登录引导，选择跳过或关闭引导后第三方 API 会自动生效。',
+        en: 'Tip: if Claude Code shows a login prompt on first launch, dismiss or skip it — the third-party API will take effect regardless.',
+    },
     // —— 配置自检（只读网络探测）——
     'check.noUrl': { zh: '官方登录态 / 未设置 API 地址，无需自检。', en: 'Official login / no API URL set; nothing to probe.' },
     'check.noKey': { zh: '还没填密钥，无法自检。', en: 'No key set; cannot probe.' },

package/dist/index.js

@@ -4,7 +4,7 @@
  *
  * 入口：解析 CLI 参数 → 分派到 CLI 路径（--list / xx <name> / -s）或交互菜单（TUI）。
  *
- * 铁律：绝不写 Claude Code 配置文件；API 切换只动 7 个受管环境变量。详见 CLAUDE.md / plan §2。
+ * 铁律：绝不写 Claude Code 配置文件；API 切换只动 9 个受管环境变量。详见 CLAUDE.md / plan §2。
  */
 import { createRequire } from 'node:module';
 import { Command, Option } from 'commander';

package/dist/ui/edit.js

@@ -22,6 +22,8 @@ function fromProvider(p) {
         sonnet: m.ANTHROPIC_DEFAULT_SONNET_MODEL ?? '',
         haiku: m.ANTHROPIC_DEFAULT_HAIKU_MODEL ?? '',
         effort: m.CLAUDE_CODE_EFFORT_LEVEL ?? '',
+        disableTraffic: m.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ?? '',
+        autoCompact: m.CLAUDE_CODE_AUTO_COMPACT_WINDOW ?? '',
     };
 }
 /**
@@ -46,6 +48,8 @@ export async function editForm(prov, store, catalog, focusKey = false) {
             { action: 'sonnet', label: `${T('edit.field.sonnet')}: ${v(W.sonnet)}` },
             { action: 'haiku', label: `${T('edit.field.haiku')}: ${v(W.haiku)}` },
             { action: 'effort', label: `${T('edit.field.effort')}: ${v(W.effort)}` },
+            { action: 'disableTraffic', label: `${T('edit.field.disableTraffic')}: ${v(W.disableTraffic)}` },
+            { action: 'autoCompact', label: `${T('edit.field.autoCompact')}: ${v(W.autoCompact)}` },
             { action: 'sep', label: '' },
             { action: 'toggle', label: showSecret ? T('edit.toggleSecretHide') : T('edit.toggleSecretShow') },
             { action: 'sep', label: '' },
@@ -76,6 +80,12 @@ export async function editForm(prov, store, catalog, focusKey = false) {
                         W.haiku = pp.models.haiku;
                     if (pp.effort)
                         W.effort = pp.effort;
+                    if (pp.env && Object.prototype.hasOwnProperty.call(pp.env, 'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC')) {
+                        W.disableTraffic = pp.env.CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ?? '';
+                    }
+                    if (pp.env && Object.prototype.hasOwnProperty.call(pp.env, 'CLAUDE_CODE_AUTO_COMPACT_WINDOW')) {
+                        W.autoCompact = pp.env.CLAUDE_CODE_AUTO_COMPACT_WINDOW ?? '';
+                    }
                 }
                 break;
             }
@@ -120,6 +130,18 @@ export async function editForm(prov, store, catalog, focusKey = false) {
             case 'effort':
                 W.effort = await pickEffort(W.effort);
                 break;
+            case 'disableTraffic': {
+                const r = await readValue(T('edit.field.disableTraffic').trim(), W.disableTraffic);
+                if (r.changed)
+                    W.disableTraffic = r.value;
+                break;
+            }
+            case 'autoCompact': {
+                const r = await readValue(T('edit.field.autoCompact').trim(), W.autoCompact);
+                if (r.changed)
+                    W.autoCompact = r.value;
+                break;
+            }
             case 'toggle':
                 showSecret = !showSecret; // 仅切换显示，不改数据、不持久化
                 break;
@@ -134,6 +156,8 @@ export async function editForm(prov, store, catalog, focusKey = false) {
                     ANTHROPIC_DEFAULT_SONNET_MODEL: W.sonnet,
                     ANTHROPIC_DEFAULT_HAIKU_MODEL: W.haiku,
                     CLAUDE_CODE_EFFORT_LEVEL: W.effort,
+                    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: W.disableTraffic,
+                    CLAUDE_CODE_AUTO_COMPACT_WINDOW: W.autoCompact,
                 };
                 if (W.auth === 'API_KEY')
                     fields.ANTHROPIC_API_KEY = W.token;

package/dist/ui/menus.js

@@ -8,7 +8,7 @@
 import { launchSession } from '../actions.js';
 import { checkProfile } from '../check.js';
 import { getProviderEnvMap, getProviderState, isOfficial, reconcileCurrent, saveStore } from '../config/store.js';
-import { setDefault } from '../env/default.js';
+import { persistDefaultEnv, setDefault } from '../env/default.js';
 import { getLang, providerDisplayName, setLang, T } from '../i18n/index.js';
 import { currentTerminalLine, hostOf } from '../runtime-info.js';
 import { banner as updateBanner, maybeRefresh, MODE_NOTIFY, upgradeCommand } from '../update/update.js';
@@ -91,9 +91,7 @@ export async function openMenu(paths, store, scope, version, catalog) {
             if (shortcut === 'e') {
                 const old = target.name;
                 if (await editForm(target, store, catalog)) {
-                    if (store.current === old)
-                        store.current = target.name;
-                    saveStore(paths, store);
+                    ({ warn: warnFlash, toast: flash } = saveEditedProfile(paths, store, target, old, scope));
                 }
             }
             else if (shortcut === 's') {
@@ -137,9 +135,7 @@ export async function openMenu(paths, store, scope, version, catalog) {
                     // #9：无密钥的第三方配置，Enter 直达编辑并聚焦密钥行（铺平首次成功路径）。
                     const old = target.name;
                     if (await editForm(target, store, catalog, true)) {
-                        if (store.current === old)
-                            store.current = target.name;
-                        saveStore(paths, store);
+                        ({ warn: warnFlash, toast: flash } = saveEditedProfile(paths, store, target, old, scope));
                     }
                 }
                 else {
@@ -187,9 +183,7 @@ async function actionMenu(paths, store, p, scope, catalog) {
         else if (sel === 3) {
             const old = p.name;
             if (await editForm(p, store, catalog)) {
-                if (store.current === old)
-                    store.current = p.name; // 改了名/供应商时同步默认指向
-                saveStore(paths, store);
+                ({ warn: warnFlash, toast: flash } = saveEditedProfile(paths, store, p, old, scope));
             }
         }
         else if (sel === 4) {
@@ -212,14 +206,19 @@ function defaultDisplayName(store) {
         return '—';
     return providerDisplayName(store.providers.find((p) => p.name === store.current) ?? { name: store.current, env: {} });
 }
-/**
- * 设为默认，返回 { warn, toast }：warn 为黄字警告（缺密钥），toast 为绿色结果。
- * 分开返回让调用方各自上色，避免警告被染成「成功」绿。
- */
-function applyDefault(paths, store, p, scope) {
-    const name = providerDisplayName(p);
-    const warn = getProviderState(p).key === 'noKey' ? T('default.noKey', name) : '';
-    const r = setDefault(paths, store, p, scope);
+function saveEditedProfile(paths, store, p, oldName, scope) {
+    const wasDefault = store.current === oldName;
+    if (wasDefault)
+        store.current = p.name; // 改了名/供应商时同步默认指向
+    saveStore(paths, store);
+    if (wasDefault)
+        return syncDefaultEnv(p, scope);
+    return {};
+}
+function defaultWarning(p) {
+    return getProviderState(p).key === 'noKey' ? T('default.noKey', providerDisplayName(p)) : '';
+}
+function defaultResultMessage(warn, name, r) {
     if (r.dryRun)
         return { warn, toast: `${T('default.done', name)}  ${T('default.dryRun')}` };
     if (r.windows && !r.windows.ok)
@@ -228,6 +227,18 @@ function applyDefault(paths, store, p, scope) {
         return { warn, toast: T('default.fishUnsupported') };
     return { warn, toast: T('default.done', name) };
 }
+function syncDefaultEnv(p, scope) {
+    const name = providerDisplayName(p);
+    return defaultResultMessage(defaultWarning(p), name, persistDefaultEnv(p, scope));
+}
+/**
+ * 设为默认，返回 { warn, toast }：warn 为黄字警告（缺密钥），toast 为绿色结果。
+ * 分开返回让调用方各自上色，避免警告被染成「成功」绿。
+ */
+function applyDefault(paths, store, p, scope) {
+    const name = providerDisplayName(p);
+    return defaultResultMessage(defaultWarning(p), name, setDefault(paths, store, p, scope));
+}
 // hostSuffix 返回行尾的灰字 host（如 ` · api.deepseek.com`）；无 base（官方/未填）返回空。
 // 超宽时由 selectMenu 的 ANSI-aware 截断从行尾裁掉，不会切坏颜色。
 function hostSuffix(p) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cc-x/cc-x",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Claude Code API 切换器（命令 xx）：在官方账号与第三方 Anthropic 兼容 API 间切换，纯环境变量、不碰 Claude Code 配置文件。",
   "keywords": [
     "claude",

package/presets.json

@@ -14,7 +14,11 @@
     "urls": [
       { "label": "Anthropic 兼容", "url": "https://open.bigmodel.cn/api/anthropic" }
     ],
-    "models": { "opus": "GLM-4.7", "sonnet": "GLM-4.7", "haiku": "glm-4.5-air" }
+    "models": { "opus": "GLM-4.7", "sonnet": "GLM-4.7", "haiku": "glm-4.5-air" },
+    "env": {
+      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+      "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
+    }
   },
   {
     "name": "小米MiMo",