CCQ（Claude Code Quickstart）是一个在 Windows PowerShell 中执行的 Claude Code 开发环境自动化安装器。

前言

• 你还在为不是开发者，想体验一下 vibe coding 的乐趣而不知道从何下手吗？
• 你还在为想转 Claude Code，却不知道怎么配置、装什么 MCP、用什么工作流，最后又回归 AIDE 吗？

简介

年底年会的时候公司要求全员 AI，让我给大家培训 cc 的使用，遂突然有了一个想法：何不直接搞个脚本一键安装部署呢？

于是趁着过年在家没事开始 vibe coding，CCQ 就诞生了。经过不断调优，终于给佬友们端上来了。

前置要求

• Windows 10 1903+ 或 Windows 11
• winget（App Installer，一般都自带）
• 管理员权限
• 有一个能稳定访问 GitHub 的网络环境

整个安装分成两级：基础环境 和 进阶扩展。

基础环境（4 步走完）

1. Node.js：可选nvm、Node.js两种安装方式，支持从fnm、nvm、Node.js迁移
2. Git：winget 自动安装 + 推荐配置项
3. Claude Code：npm 全局安装
4. 第三方供应商配置：内置智谱 GLM / MiniMax / Kimi 模板，也支持自定义供应商

进阶扩展（按需选装）

1. CCometixLine：哈雷佬的状态栏增强，装完自动 patch
2. Claude 基础配置：自动写入推荐的 settings.json 配置（语言、权限、超时等），只补缺失，不覆盖已有配置
3. CLAUDE.md：生成用户级提示词
4. MCP Server：交互式选装，凭据持久化到本地 vault，重装不用重新填，自动同步 settings.json 权限和 ~/.claude/rules/ 提示词，具体有：

• Context7（库文档检索，推荐）
• DeepWiki（GitHub 仓库 AI 文档，推荐）
• Playwright（网页自动化，推荐）
• Exa Search（AI 网络搜索，推荐，需 Key）
• Tavily（实时搜索，需 Key）
• ACE Tool（代码语义检索，需凭据）
• MasterGo（设计稿转代码，需 Token）
• Figma（设计稿代码生成，OAuth 认证）
• Chrome DevTools（浏览器调试自动化）

5. CCG Workflow：风佬的 ccg-workflow（强烈推荐）
6. OpenSpec：规范驱动的开发工具（强烈推荐，做大型复杂项目时好用）
7. cc-switch：Claude Code / Codex / Gemini CLI 辅助桌面软件（可选）
8. Codex CLI / Gemini CLI：可选安装，配合 ccg 做多模型协作

流程

1. 运行引导脚本

首先用管理员打开系统自带的 PowerShell，执行引导脚本。它会帮你装好 Windows Terminal 和 PowerShell 7（如果没有的话）：

Set-ExecutionPolicy Bypass -Scope Process -Force
[Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://github.com/MrNine-666/claude-code-quickstart/releases/latest/download/Bootstrap-ClaudeEnv.built.ps1')) | iex

2. 执行主安装脚本

然后在 Windows Terminal 中用管理员打开 PowerShell 7，执行主安装脚本：

Set-ExecutionPolicy Bypass -Scope Process -Force
irm 'https://github.com/MrNine-666/claude-code-quickstart/releases/latest/download/Install-ClaudeEnv.built.ps1' | iex

依次完成基础环境、进阶扩展的安装即可

3. 日常管理脚本

安装好之后，日常管理用 Manage 脚本：

v1.7.8 更新后只需要执行 ccq 即可，旧安装用户需重新执行一下上面的Install脚本->基础环境。当然旧的指令也是支持的

更新管理

一键检测所有已安装组件的远程版本，列出可更新项。更新前会自动备份 settings.json、.claude.json、CLAUDE.md 和 rules 文件到快照目录，翻车了可以回滚。对于模板类步骤（CLAUDE.md、ClaudeConfig、CCG Workflow），有内容指纹比对机制，模板没变会自动跳过，避免无意义覆盖。

供应商管理

对已配置供应商做 CRUD、切换活跃供应商。切换时会把对应 Profile 配置写入 settings.json。

MCP 管理

查看所有 MCP Server 状态（活跃/禁用/缺失），可禁用、启用、删除。禁用时配置从 ~/.claude.json 移到 vault 暂存，启用时再恢复，不用重复填凭据。

一些设计上的考虑

1. 脚本环境分层

引导脚本兼容 PS 5.1（Windows 自带），负责装 PS 7；主安装脚本跑在 PS 7。这样不用提前手动装 PS 7。

2. 供应商 Profile 机制

所有供应商配置以 Profile 文件形式保存在 ~/.claude/providers/。新增/切换供应商时，会把 Profile 里的 BaseUrl 和 ApiKey 写入 ~/.claude/settings.json 的 env 字段。需要 modelMapping 的（比如 MiniMax、Kimi）会自动配好映射关系。这样做可以避免污染 settings.json 其他配置（注意：会与 ccswitch 冲突）。

3. MCP 凭据 Vault

MCP Server 的凭据（API Key 等）持久化到 ~/.ccq/mcp-meta.json。重装或更新 MCP 时可自动填充，不用每次重输。并且有 Mutex 保护防并发写入，也有损坏恢复机制。

最后

这里特别感谢 L 站以及哈雷佬、风佬、各位公益站站长，从他们那里学到了很多，再次感谢。

项目地址：GitHub - MrNine-666/claude-code-quickstart · GitHub

鸣谢

• cexll/myclaude - codeagent-wrapper
• UfoMiao/zcf - Git 工具 + 输出风格
• telagod/code-abyss - 邪修输出风格
• GudaStudio/skills - 智能路由设计
• fission-ai/opsx - OpenSpec 规范驱动框架
• ace-tool MCP - 代码检索工具
• code-abyss - skills参考