【开源】CCQ：一个 Windows 从零搭建 Claude Code 环境，到开箱即用的 Powershell 脚本

Invoker 2026-03-08 15:29 1

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

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

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

我的开源项目已链接认可 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 步走完）

Node.js：可选nvm、Node.js两种安装方式，支持从fnm、nvm、Node.js迁移

Git：winget 自动安装 + 推荐配置项

Claude Code：npm 全局安装

第三方供应商配置：内置智谱 GLM / MiniMax / Kimi 模板，也支持自定义供应商

进阶扩展（按需选装）

CCometixLine：哈雷佬的状态栏增强，装完自动 patch

Claude 基础配置：自动写入推荐的 settings.json 配置（语言、权限、超时等），只补缺失，不覆盖已有配置

CLAUDE.md：生成用户级提示词

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（浏览器调试自动化）

CCG Workflow：风佬的 ccg-workflow（强烈推荐）

OpenSpec：规范驱动的开发工具（强烈推荐，做大型复杂项目时好用）

cc-switch：Claude Code / Codex / Gemini CLI 辅助桌面软件（可选）

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 冲突）。