首页 / 全部技能 / 基础工具与工作流 / claude-switch-models-setup
English (EN)简体中文 (ZH)日本語 (JA)
基础工具与工作流 · daymade/claude-code-skills

claude-switch-models-setup

Set up and maintain multiple isolated Claude Code CLI profiles so students and power users can run different LLM providers (Kimi K3, Kimi K2.7 highspeed, MiniMax M3, MiniMax M2.7, GLM, DeepSeek, StepFun, Anthropic) in separate terminal windows at the same time. Use this skill whenever the user asks about multi-provider Claude setup, multiple Claude Code windows, switching models or the csk/csd/csg aliases, CLAUDE_CONFIG_DIR, the ~/.claude-profiles directory, or running Kimi/MiniMax/GLM/DeepSeek/StepFun alongside Anthropic. It also owns profile-drift troubleshooting — a third-party profile missing skills/hooks/plugins the default profile has, claude-profiles-doctor reporting a real directory where a symlink belongs, or settings not converging — and per-provider context-window configuration (the [1m] marker or explicit CLAUDE_CODE_MAX_CONTEXT_TOKENS).

L4 高权限 · 分级授权与审计V1 已固定执行命令联网读写文件Dual-pass Audit
Author daymadeGitHub daymade/claude-code-skills ↗Stars 1385License MIT（仓库根 LICENSE：Copyright (c) 2025 daymade；GitHub API spdx MIT）Commit d5c4678cb5
管控等级描述 skill 的能力与建议配套的管控措施，不代表质量或安全认证，也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同，请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者，使用风险由使用者自行承担。

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外部依赖

KindDependency / Endpoint
cliclaude（官方 CLI，按 profile 启动）
clipython3
cliuv（仅 daemon --install 时 uv python install 3.12 取托管运行时）
clilaunchctl（macOS LaunchAgent 安装/启动）
networkprovider 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.