# Win-ClaudeCodeSetup

**Repository Path**: henryqi91/win-claude-code-setup

## Basic Information

- **Project Name**: Win-ClaudeCodeSetup
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code / Codex 一键安装与卸载（Windows）

仓库根目录下共 4 个自包含脚本，双击即用，可直接复制到任意 Windows 10/11 电脑，无需其他文件：

| 文件 | 作用 |
|------|------|
| `install-all.bat` | 安装向导：选 Claude Code 或 Codex（命令行也可两个都装），配置 API 与模型，注册右键菜单 |
| `install-claude-code.bat` | 仅安装 Claude Code：CLI、配置与右键菜单 |
| `install-codex.bat` | 仅安装 Codex：CLI、配置、右键菜单与可选桌面 App |
| `uninstall.bat` | 卸载向导：检测已装 CLI，卸载 CLI 与右键菜单 |

脚本内部已内嵌全部所需文件（右键菜单 DLL、MenuHost、manifest、图标、codex 模型目录），运行时释放到 `%LOCALAPPDATA%`，不依赖同目录其他文件。

---

## install-all.bat 交互流程

只装单个工具可直接双击 `install-claude-code.bat` 或 `install-codex.bat`，向导流程一致，只是少了“选择目标”一步，直接进入对应工具的安装配置。

双击后全程使用 **↑/↓ 方向键 + 回车** 选择，Esc 取消；以下为完整向导：

```
选择目标：1) Claude Code  2) Codex
  │
  ├─ Claude Code
  │    输入版本（默认 2.1.200，回车用默认）
  │    选择渠道：1) DeepSeek（外网） 2) 南湖MaaS（内网）
  │      ├─ DeepSeek
  │      │    输入 API Key
  │      │    主模型：默认 deepseek-v4-flash，可选 flash / deepseek-v4-pro[1m]（官方模型名，无连字符）/ custom（自填完整名）
  │      │    次模型：默认 deepseek-v4-flash，同上
  │      └─ 南湖MaaS
  │           输入 API Key（必填）
  │           后台调用 v1/models 获取模型列表（成功打印“成功获取模型列表”）
  │           主模型：默认 deepseek-v4-pro，只能从列表选择
  │           次模型：默认 deepseek-v4-flash，只能从列表选择
  │    显示配置摘要 → 回车开始安装 → hello 测试 → 完成
  │
  └─ Codex（当前仅 DeepSeek）
       输入版本（默认 0.146.0，回车用默认）
       输入 API Key
       主模型：默认 deepseek-v4-flash，可选 flash / custom（Responses API 目前仅支持 deepseek-v4-flash，pro 暂不可用）
       是否同时安装 Codex 桌面 App（默认安装，与 CLI 共用 .codex 配置）
       显示配置摘要 → 回车开始安装 → hello 测试 → 完成
```

也支持命令行指定目标：`install-all.bat claude` / `install-all.bat codex` / `install-all.bat all`（两个都装）。

## 配置写入内容

### Claude Code（`%USERPROFILE%\.claude\settings.json`）

主模型写入 `ANTHROPIC_MODEL`、`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`；
次模型写入 `ANTHROPIC_DEFAULT_HAIKU_MODEL`、`CLAUDE_CODE_SUBAGENT_MODEL`。

| 渠道 | ANTHROPIC_BASE_URL |
|------|--------------------|
| DeepSeek | `https://api.deepseek.com/anthropic` |
| 南湖MaaS | `http://i-nhi.zhejianglab.org/maas/v1`（可用环境变量 `CCM_NANHU_BASE` 覆盖） |

南湖渠道额外写入 `CLAUDE_CODE_MAX_CONTEXT_TOKENS=256000`、`DISABLE_COMPACT=1`。

### Codex（`%USERPROFILE%\.codex\config.toml` + `models.json`）

- 主模型写入 `model = "…"`
- Codex 走 DeepSeek Responses API：官方目前仅支持 `deepseek-v4-flash`，`deepseek-v4-pro` 暂不支持（预计 8 月初支持），因此向导只提供 flash 与自定义；若自定义填写 pro 模型会给出警告
- effort 相关字段固定为 `model_reasoning_effort = "high"`
- 写入 `model_catalog_json` 指向本机 `models.json`；所选模型不在目录中时自动补录（基于 deepseek-v4-flash 条目克隆，无 BOM、压缩写入）
- `experimental_bearer_token` 写入 API Key

## 安装器自动完成

- 缺 Git / Node.js 时从清华源下载安装（安装包缓存到脚本所在目录，可预置离线）
- Windows Terminal 缺失时自动安装（winget 静默安装；已装则跳过，失败仅警告不阻断主流程）
- npm 切换到国内镜像 `https://registry.npmmirror.com`
- 固定版本安装：`@anthropic-ai/claude-code@2.1.200`、`@openai/codex@0.146.0`
- 右键菜单注册：注册前仅清理当前目标（claude/codex）自己的旧右键注册（经典菜单项 + 旧版脚本 HKLM 遗留），不会误删另一套菜单；Windows 11 注册到一级菜单（需开发者模式时自动提权开启），失败自动回退经典菜单；Windows 10 直接注册经典菜单
- Codex 额外提供 `codex app`：通过 `codex://threads/new?path=...` 深链直接打开 Codex 桌面 App 并载入当前目录（需已安装桌面 App）；Windows 11 一级菜单为内置三项（codex auto / codex auto continue / codex app），Windows 10 通过经典菜单注册全部三项
- 启动时请求管理员权限（UAC）：npm 全局安装、Node.js/Git 安装、Windows 11 开发者模式都需要管理员；不想提权可设 `CCM_NO_ELEVATE=1`（不推荐，部分步骤会失败）
- 安装完成执行 `claude -p "hello"` / `codex exec --skip-git-repo-check "hello"` 连通测试
- 安装完成后打印“下一步操作”指引（右键菜单用法 / 终端命令 / 桌面 App），最后【按任意键关闭】
- Codex 向导可选安装桌面 App（Microsoft Store，`winget install --id 9PLM9XGG6VKS -s msstore`）；桌面 App 与 CLI 共用 `%USERPROFILE%\.codex` 配置，装好即直接走 DeepSeek；安装成功时自动在桌面创建快捷方式（`Codex.lnk`，同名被占用则用 `Codex (DeepSeek).lnk`），图标取自 App 自带的 OpenAI/Codex 图标

## 卸载 uninstall.bat

启动时请求管理员权限（UAC）：npm 全局卸载、HKLM 遗留菜单清理都需要管理员，卸载将在新的管理员窗口继续；UAC 被取消则退出（交互环境会询问是否以当前权限继续）。不想提权可设 `CCM_NO_ELEVATE=1`（不推荐，部分步骤会失败）；`CCM_DRYRUN=1` / `CCM_MOCK_CLIS=1` 模式不执行真实卸载，自动跳过提权。

1. 自动检测本机已安装的 CLI 及版本号（如 `Claude Code（版本 2.1.200）`、`Codex（版本 0.146.0）`）
2. ↑/↓ 选择要卸载的 CLI，回车
3. 提示“您确认要卸载 … 及其右键菜单吗？”，回车执行
4. 卸载内容：npm 全局 CLI 包、Appx 右键菜单包、经典注册表菜单项、旧版脚本遗留的 HKLM 菜单项、`%LOCALAPPDATA%` 插件目录；卸载 Codex 时如检测到桌面 App 会询问是否一并卸载；最后重启资源管理器
5. 显示“卸载完成”，按任意键退出

保留项：API Key 配置文件（`.claude` / `.codex`）、Git / Node.js。

## 版本与下载源

- Claude Code 默认 2.1.200、Codex 默认 0.146.0（npm 当前最新稳定版；0.148.0 在 npm 上不存在，勿用）
- Git/Node：清华源 `mirrors.tuna.tsinghua.edu.cn`（已验证六个安装包全部可达）
- npm：`registry.npmmirror.com`（两个包均已验证存在）
- 首次安装必须联网；完全断网的内网机需把 Git/Node 安装包提前放到脚本同目录作为缓存，npm 安装仍需要可访问 npm 源

## 测试 / 自动化钩子（环境变量）

| 变量 | 作用 |
|------|------|
| `CCM_DRYRUN=1` | 只收集配置并打印摘要/计划，不执行安装或卸载 |
| `CCM_MOCK_NANHU=1` | 南湖模型列表使用假数据（联调用） |
| `CCM_NANHU_BASE=url` | 覆盖南湖 MaaS 地址 |
| `CCM_API_KEY=key` | 免输入 Key |
| `CCM_SKIP_KEY=1` | 跳过 Key 输入 |
| `CCM_CLASSIC=1` | 仅注册经典右键菜单 |
| `CCM_CODEX_APP=0` | Codex 向导跳过桌面 App 安装提问（默认询问） |
| `CCM_NO_ELEVATE=1` | 跳过安装/卸载启动时的管理员提权（不推荐：npm 全局安装/卸载等步骤可能因权限失败） |
| `CCM_MOCK_CLIS=1` | 卸载脚本假装已装 claude/codex（测试用） |

## 常见问题

- **双击闪退看不到错误**：已修复。出错时窗口保持打开，红字显示“安装脚本出错：<信息> / 位置：第 N 行”，按任意键退出；安装成功结束时也会停留显示结果。另外：
  - 需要 UAC 提权时（缺 Git/Node），安装会在新的管理员窗口继续，原窗口等待；若管理员窗口异常退出，原窗口会红字提示退出码并停留，不会无声关闭。
  - 全程写入日志 `%TEMP%\ccm_install.log`（含 npm 安装输出），窗口即使被强制关闭也可凭日志追查。
  - 脚本正常结束会写完成标记；若 bat 结束但未见标记，会停留提示“安装窗口意外退出”。
- **安装失败先看错误内容**：最常见原因是网络（清华源/npmmirror 不可达）、UAC 被取消、Git/Node 安装失败、API Key 无效导致 hello 测试失败。
- 脚本改名、移动位置均不影响使用；插件文件释放到 `%LOCALAPPDATA%`，不要手动删除。