1实现原理 · 为什么它能做到

用 CLAUDE_CONFIG_DIR 做进程级隔离：每个 provider 一个 ~/.claude-profiles/<name>/ 目录、一份独立 .claude.json（凭证与会话历史），共享目录（skills/projects/hooks/agents/plugins 内容）symlink 回 ~/.claude，实现‘多窗口同时跑不同 provider 且配置不串’。

daymade-claude-code/claude-switch-models-setup/SKILL.md

The result: you can open one terminal with Kimi, another with DeepSeek, another with Anthropic — each running as a fully independent Claude Code process, without configuration bleed.

启动由 claude-profiles.sh 的 claude-profile 完成：CLAUDE_CONFIG_DIR=profile 目录 + claude --settings <provider>.json，provider 路由 env 由 ~/.claude/settings/<name>.json 提供。

settings.json 层做‘从默认 profile 收敛’：sync-profile-settings.py 注册为 SessionStart hook，把默认 profile 的 settings.json 各键复制进每个第三方 profile（保留 model/advisorModel 等身份键与 provider 路由 env 不覆盖），解决第三方窗口 hook/marketplace/env 漂移。

daymade-claude-code/claude-switch-models-setup/scripts/sync-profile-settings.py

Two denylists define the identity boundary — these are NEVER synced:

docstring 记录实测：9/9 profiles 零 hook、7/9 零 marketplace；ENV_KEY_DENYLIST 含 ANTHROPIC_* 前缀 + CLAUDE_CODE_SUBAGENT_MODEL 等隔离旗标。

.claude.json 行为键层做 allowlist 收敛 + 状态键三分类防护：workflowSizeGuideline 等少量行为键同步，state/credential/identity 键（oauthAccount/userID/token/secret…）永不同步，其余灰键只报告不自动写——防把一份 profile 的会话状态/账号身份抹到别的 profile。

daymade-claude-code/claude-switch-models-setup/scripts/sync-profile-settings.py

State keys (is_state_key(): prefixes/substrings/exact names) — per- profile runtime state, caches, counters, migration flags, identity and credentials. NEVER synced

实测动机（SKILL 正文）：2026-08-17 workflowSizeGuideline:small 只在主 profile，Kimi 会话把 Dynamic Workflow 扇出 30+ agents。

插件状态特殊处理：known_marketplaces.json 必须 per-profile（Claude 用 path.resolve() 校验 installLocation、不解析 symlink，共享一份会让其它 profile 报 corrupted installLocation），claude-plugins-sync.py 重建每个 profile 的 per-profile 结构并镜像 enabledPlugins。

daymade-claude-code/claude-switch-models-setup/scripts/claude-plugins-sync.py

Each profile runs with its own CLAUDE_CONFIG_DIR, so `c` is a DIFFERENT literal string per profile

脚本 docstring 说明了把整个 plugins/ symlink 共享为何失败（最后写者赢）及 per-profile 修复结构。

maintainer 专用本地源码同步：sync-local-skill-sources.py 把本地 skill 源仓库以 symlink 接进 Claude plugin cache 与 Codex ~/.agents/skills、~/.codex/skills，默认 dry-run、--apply 才改；用 O_NOFOLLOW dirfd、renameat2/renameatx_np 独占改名、时间戳备份防并发与目录竞态。

daymade-claude-code/claude-switch-models-setup/scripts/sync-local-skill-sources.py

Real files/directories and third-party links are never deleted or automatically moved.

该脚本 2153 行是仓库内最重的安全工程：先冻结 source/root 身份再改动、受影响根目录以 no-follow 句柄打开、失败回滚（exclusive_rename 双向往返）。

上下文窗口配置做成决策规则：真实 ~1M 才用字面量 [1m] 后缀（Claude Code 匹配该字面量），已知小窗口用显式 CLAUDE_CODE_MAX_CONTEXT_TOKENS/AUTO_COMPACT，未验证不猜；deepseek/glm 模板双写是刻意保留。

daymade-claude-code/claude-switch-models-setup/SKILL.md

Claude Code matches this literal string, not a made-up marker like `[1million]` or `[max]`.

references/context-window-config.md 存 [1m] 全机制与‘env 是否真改线上字节’的本地 http.server 捕获配方。

部署纪律：脚本用 symlink 部署而非 cp（防双向往漂移——修复躺在仓库 26 天、清理代码只进部署副本的真实事故），并提供 setup.sh 安装器与 claude-profiles-init/doctor/rm 运维命令族。

daymade-claude-code/claude-switch-models-setup/scripts/setup.sh

# Symlink rather than copy.

SKILL.md 有专门的 live-link 检查一行命令；claude-profile-rm 先扫描意外真实文件、要求 y/N 才 rm -rf 隔离目录。

2核心能力

01一键多 profile 建/启/查/删：claude-profiles-init / claude-profile <name> / doctor / rm

02settings.json 全量收敛器（SessionStart hook 自愈 + --all/--check）

03.claude.json 行为键 allowlist 同步（workflowSizeGuideline 等）+ 状态/凭证键三分类防护

04插件结构与 enabledPlugins 镜像修复（claude-plugins-sync.py，随 profile 启动/写入自动触发）

05本地 skill 源码 ↔ Claude/Codex 激活位点同步（dry-run 预览 + --apply + macOS LaunchAgent 守护）

0611 个 provider 配置模板（Kimi/MiniMax×2/GLM/DeepSeek/StepFun/Anthropic 等，含 [1m] 或显式窗口）+ 上下文窗口决策规则

07profile-drift 排障（orphan/real-dir drift/corrupted installLocation/settings 不收敛）

3外部依赖

Kind	Dependency / Endpoint
cli	claude（官方 CLI，按 profile 启动）
cli	python3
cli	uv（仅 daemon --install 时 uv python install 3.12 取托管运行时）
cli	launchctl（macOS LaunchAgent 安装/启动）
network	provider API 端点（经 claude CLI 转发；模板列出 base URL 需用户核实）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: scripts/setup.sh
网络端点: 声明外部网络访问: （SKILL 流程中的用户动作）claude CLI 经各 provider 端点/网关出网；daemon --install 时 uv python
本地工作目录: 文件读写与工件输出: ~/.claude-profiles/<name>/ 结构（.claude.json、symlink 目录）

审计说明： 。本技能的工作对象就是含明文凭证的配置：SKILL 让用户把 API key 明文写进 ~/.claude/settings/<provider>.json（与 Claude Code 原生一致），脚本族会读取/分类主 profile 与各 profile 的 settings.json 与 .claude.json（oauthAccount/token/secret 等状态键按名识别后明确跳过、永不写回，收敛方向单向默认→第三方，有 denylist/allowlist 三分类防线）；无自研网络外发，网络面是 claude CLI 按配置连 provider 端点（对象由用户配置决定）+ daemon 安装时 uv 取托管 Python（astral 官方源）。触发条件：仅当用户要求搭/维护多 provider profile 或排 profile 漂移时运行；评估重点是‘把明文密钥放进更多配置副本’与‘本地源仓库被当作可信激活源’两点。

5第二遍独立确认

[ok] 脚本零网络外发 — 全部脚本无 urllib/requests/socket；grep 到的 https 仅 setup.sh echo 链接与模板/文档里的 provider base URL
[ok] 凭证键不被同步（防串 profile） — STATE_EXACT 含 projects/oauthAccount/userID 等；STATE_SUBSTR 匹配 token/secret/credential/apikey；ENV_KEY_DENYLIST 拦 ANTHROPIC_* 与隔离旗标；灰键仅报告
[ok] converger 方向单向（默认→第三方） — docstring：'every key present in main's settings.json overwrites the profile's, except denylisted ones'；顶层 profile-only 键保留
[ok] 删除/修复路径受控 — claude-profile-rm：意外真实文件即 ABORT + y/N 确认；init --repair 把 real dir 归档为 .pre-symlink-bak-<ts> 再 symlink，不直接删
[ok] 源码同步竞态防护真实存在 — O_NOFOLLOW 打开每个路径组件、libc renameat2/renameatx_np 独占改名、失败 exclusive_rename 回滚、KEEP_JSON_BACKUPS=20
[ok] ‘claude-profiles-doctor 报 real dir’等能力声明有脚本支撑 — doctor 遍历 profile 目录对比 symlink 与 real dir（'WARN: <name> is a real directory (expected symlink...)'）

6结论

把多 provider 并行的配置漂移问题系统化：symlink 共享 + config 收敛 + state 隔离三层模型清晰可判

凭证/状态防护设计严谨：三分类（allowlist/state/gray）+ 单向收敛 + 灰键 tripwire 报告，防把账号身份抹到别的 profile

并发与目录竞态防护到位（no-follow fd、renameat2、回滚），工程上少见

文档即实测账本（日期+数字），后续维护者能核对每条设计动机

破坏性路径都有闸门：archive-first 修复、y/N 删除、dry-run 默认

适合： 适合需要同时跑多家 LLM provider 的 Claude Code 重度用户/学员批量装机（workshop），或维护本地技能源仓库、要让它实时进入 Claude/Codex 激活面的 maintainer。系统化多窗口隔离 + profile 漂移自动收敛正是它解决的问题。

不适合： 不适合只用单一 Anthropic 官方模型、无多 provider 需求的人（整套机制是负担）；不适合不能接受把 API key 明文放多个配置文件的安全策略；不适合完全不懂 Claude Code 配置结构的用户自助排障（应先走 student-setup-guide 或人工）；也不适合把本地未审计仓库直接当技能源使用。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload claude-switch-models-setup.tar.gz

sha256: 1c1947b7efbf6091…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit d5c4678cb5.