本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

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脚本->基础环境。当然旧的指令也是支持的

ccq

更新管理

一键检测所有已安装组件的远程版本，列出可更新项。更新前会自动备份 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

求个 star，欢迎提 Issue 和 PR。

更新记录