Claude Code 三件套终极指南：CC-Switch + GLM-5.1 + OpenSpec + Superpowers 融合实战

写在前面

最近在 Claude Code 社区，"三件套"组合正在成为最热门的话题------用 CC-Switch 接入国产 GLM-5.1 模型，再融合 OpenSpec 的规范驱动开发和 Superpowers 的执行纪律，形成一套完整的 AI 辅助开发工作流。

这篇文章，我会把整个从零到一的配置过程，以及如何将 OpenSpec + Superpowers 融合成一个连贯的工作流，完整记录下来。你可以直接照着操作。

一、整体架构：这张图看懂全流程

复制代码

┌─────────────────────────────────────────────────────────────────┐
│                        你的终端 (Terminal)                       │
│                              │                                  │
│                      claude 命令                                │
│                              ↓                                  │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                    CC-Switch (配置层)                       │ │
│  │    - 管理 API Key                                          │ │
│  │    - 注入智谱端点                                           │ │
│  │    - 支持热切换模型                                         │ │
│  └───────────────────────────────────────────────────────────┘ │
│                              ↓                                  │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │              智谱 Coding API Endpoint                       │ │
│  │         https://open.bigmodel.cn/api/anthropic              │ │
│  └───────────────────────────────────────────────────────────┘ │
│                              ↓                                  │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                    GLM-5.1 模型                             │ │
│  │              SWE-Bench Pro 58.4 分，超越 Opus 4.6            │ │
│  └───────────────────────────────────────────────────────────┘ │
│                                                                  │
│  ═══════════════════════════════════════════════════════════════│
│                                                                  │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │              OpenSpec + Superpowers 工作流                  │ │
│  │                                                            │ │
│  │   需求 → /openflow proposal → proposal.md                  │ │
│  │         ↓                                                  │ │
│  │   探索 → /openflow brainstorming → 深度设计                 │ │
│  │         ↓                                                  │ │
│  │   规范 → /openflow spec → OpenSpec 生成 specs              │ │
│  │         ↓                                                  │ │
│  │   实施 → /openflow build → Superpowers TDD 执行             │ │
│  │         ↓                                                  │ │
│  │   归档 → /openflow close → 验证 + 归档                      │ │
│  └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

核心思路：CC-Switch 负责"连得上"，GLM-5.1 负责"跑得动"，OpenSpec + Superpowers 负责"做得对"。

二、环境准备：30分钟搭好基础

2.1 申请智谱 GLM Coding Plan

注意：也可以闲鱼买中转服务

第一步：注册智谱账号

访问智谱开放平台，手机号注册即可。新用户会送 2000 万 tokens，体验足够用。

第二步：完成实名认证（必须）

进入个人中心 → 账号设置 → 实名认证。需要真实姓名、身份证号、支付宝刷脸，通常 30 秒通过。

第三步：购买 Coding Plan（可选但推荐）

访问 GLM Coding Plan 页面：

套餐	价格	适用场景
Lite	¥20/月	轻度使用、学生、探索期
Pro	¥120/月	重度编程、专业开发者

新用户首次购买季付套餐可享 5 折优惠，Lite 套餐低至 ¥48/季（约 ¥16/月）。

第四步：获取 API Key

进入控制台 → API Key 管理 → 新建 API Key。

⚠️ 关键：智谱 Coding Plan 专用端点

复制代码

https://open.bigmodel.cn/api/anthropic

这个端点与通用端点不同，配置时不要填错。

2.2 安装 CC-Switch

CC-Switch 是开源的跨平台桌面工具，专门用来管理 Claude Code 的 API 配置。

Mac 用户（推荐，一行搞定）：

bash 复制代码

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows 用户：

从 GitHub Releases 下载 .exe 安装包
双击安装

Linux 用户：

下载 .AppImage 文件
给予执行权限后运行

2.3 在 CC-Switch 中配置智谱

Step 1：打开 CC-Switch，顶部确认选中的是 Claude Code（不是其他应用）

Step 2 ：点击右上角"+"添加供应商，在列表中选择 "Zhipu GLM"（智谱 AI）

Step 3：粘贴你的 API Key，端点保持默认的 Coding 专用地址

Step 4：点击"健康检查"，验证配置正确性

Step 5：点击"启用"，CC-Switch 会自动将配置写入 Claude Code 配置文件

Step 6：验证配置生效

bash 复制代码

claude "用一句话介绍你自己"

如果返回内容中提到"智谱"或"GLM"，说明配置成功。

2.4 安装 Claude Code（如未安装）

bash 复制代码

# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

验证安装：

bash 复制代码

claude --version

2.5 配置模型映射（可选但推荐）

编辑 ~/.claude/settings.json，为不同任务级别指定模型：

json 复制代码

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1"
  }
}

级别	模型	消耗系数	适用场景
Haiku	GLM-4.5-Air	1×	简单问答、轻量任务
Sonnet	GLM-5-Turbo	1×	日常编程、代码补全
Opus	GLM-5.1	2-3×	复杂推理、架构设计

额度节省建议：日常任务用 GLM-5-Turbo，复杂架构问题再切换到 GLM-5.1。高峰期（14:00--18:00 UTC+8）GLM-5.1 消耗是平时 1.5 倍，建议避开。

三、安装 OpenSpec 和 Superpowers

3.1 全局安装 OpenSpec

bash 复制代码

npm install -g @fission-ai/openspec@latest

3.2 安装 Superpowers 插件

在 Claude Code 中执行：

bash 复制代码

/plugin install superpowers@claude-plugins-official

3.3 在项目中初始化

bash 复制代码

cd your-project

# 初始化 OpenSpec
openspec init

# 初始化 Superpowers（会自动检测 Claude Code）
npx superpowers-openspec-team init . --tool claude-code

初始化过程中，sot init 会自动检测并安装 5 个核心 workflow skills 到 .claude/skills/ 目录。

3.4 关键配置：干掉 OpenSpec 的 apply 命令

OpenSpec 默认会包含 apply 命令用于任务执行，但我们要把这个工作交给 Superpowers 来做。

bash 复制代码

openspec config profile

进入配置界面后：

选择 "Workflows only"
在列表中找到 [ ] Apply tasks
按空格取消选中
确认保存

配置完成后，openspec apply 将被禁用，任务执行全部由 Superpowers 接手。

四、核心：OpenSpec + Superpowers 融合工作流

4.1 为什么需要融合？

工具	擅长	短板
OpenSpec	结构化规范（proposal → specs → tasks）	缺少 TDD 纪律，执行环节薄弱
Superpowers	TDD 铁律、代码审查、系统化调试	设计共识无处持久化

融合价值：OpenSpec 管"写什么"，Superpowers 管"怎么做"，两者互补。

4.2 推荐方案一：使用 openflow 编排器（最省心）

@lininn/openflow 是一个专门为 OpenSpec + Superpowers 设计的编排器。

安装：

bash 复制代码

npm install -g @lininn/openflow

初始化：

bash 复制代码

cd your-project
openflow init --tools claude

可用命令：

命令	阶段	说明
`/openflow proposal`	需求捕捉	3-5 个问题快速收敛需求
`/openflow brainstorming`	深度设计	多轮方案探索和权衡
`/openflow spec`	规范生成	调用 OpenSpec 生成 specs + 转换为 plan-ready.md
`/openflow build`	实施	调用 Superpowers TDD 执行
`/openflow close`	归档	验证一致性 + 归档

完整流程示例：

bash 复制代码

# 1. 快速捕捉需求
/openflow proposal "添加用户认证功能"

# 2. 深度探索（复杂功能可选）
/openflow brainstorming

# 3. 生成规范和实施计划
/openflow spec

# 4. 执行 TDD 开发
/openflow build

# 5. 验证并归档
/openflow close

4.3 推荐方案二：手动命令组合（更灵活）

如果你不想引入额外的编排层，可以直接组合使用 OpenSpec 和 Superpowers 的命令。

完整工作流：

bash 复制代码

# Phase 1: 需求探索
/opsx:explore
# 苏格拉底式提问，收敛需求细节

# Phase 2: 生成规范文档
/opsx:propose your-change-name
# 自动生成 proposal.md, design.md, specs/, tasks.md

# Phase 3: 生成详细实施计划
/superpowers:writing-plans
# 将 tasks.md 拆成 2-5 分钟可执行的步骤

# Phase 4: TDD 执行
/superpowers:subagent-driven-development
# 每个任务过两道关：Spec 合规 + 代码质量

# Phase 5: 验证需求
/opsx:verify
# 逐条验证 GIVEN/WHEN/THEN scenarios

# Phase 6: 归档
/opsx:archive
# 合并变更到 specs/

核心依赖关系：

复制代码

tasks.md (做什么)          plan.md (怎么做)
├── checkbox 粒度          ├── 2-5 分钟操作粒度
├── spec requirement 级别   ├── 具体文件路径
└── 归属 OpenSpec         ├── RED → GREEN → REFACTOR
                          └── 归属 Superpowers

4.4 项目级 CLAUDE.md 配置

在项目根目录创建 CLAUDE.md，让规范在每个会话自动生效：

markdown 复制代码

# 项目上下文

## 工作流规范
本项目采用 SDD（规范驱动开发），使用 OpenSpec 管理规范变更，Superpowers 约束执行纪律。

## 技术栈
- 语言：Python 3.12 / Go 1.21+
- 框架：FastAPI / Gin + GORM
- 数据库：PostgreSQL

## 代码规范
- **必须**使用类型注解
- **禁止**在路由层直接编写业务逻辑
- **所有**数据库操作必须通过 repository 层

## 工作流约束
- 完成代码变更后，**必须**运行测试
- 提交信息**必须**遵循 Conventional Commits
- 复杂功能**必须**先走 OpenSpec proposal 流程

五、实战案例：添加一个更新状态指示器

以 ccstatusline 工具添加更新状态指示功能为例：

5.1 需求探索

bash 复制代码

/opsx:explore

Claude 会主动问：显示什么、用什么形式、多色指示具体是什么意思。需求细节在这个阶段收敛。

5.2 生成 Proposal

bash 复制代码

/opsx:propose ccstatusline-update-indicator

系统自动生成 proposal.md、design.md、specs/、tasks.md 四个文件。

5.3 写实施计划

bash 复制代码

/superpowers:writing-plans

Superpowers 会根据 tasks.md 生成详细计划，每个任务拆成 2-5 分钟可完成的步骤，附代码示例和测试方法。

5.4 执行

bash 复制代码

/superpowers:subagent-driven-development

每个任务过两道关：

Spec 合规：是否符合 OpenSpec 定义的行为
代码质量：是否符合项目规范

5.5 验证

bash 复制代码

/opsx:verify

验证发现 Widget 没有正确使用 context.updateStatus，修复后重新走 plan → execute → verify。

5.6 归档

bash 复制代码

/opsx:archive

变更归档到 openspec/changes/archive/，后续可追溯决策。

六、高阶配置：让 Claude Code 自动批准命令

频繁点击"同意"很烦人？有两种方式解决。

6.1 Shift+Tab 快速切换自动模式（日常推荐）

bash 复制代码

claude --enable-auto-mode

然后在会话中按 Shift+Tab 切换权限模式，直到屏幕显示 Auto 。AI 分类器会自动拦截危险操作（如 rm -rf /），但允许项目内正常操作。

6.2 配置文件永久允许特定命令

编辑 .claude/settings.json：

json 复制代码

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(pytest *)",
      "Bash(git status)"
    ],
    "deny": [
      "Bash(rm -rf /)",
      "Bash(sudo *)",
      "Read(.env*)"
    ]
  }
}

规则生效顺序：先拒绝 → 询问 → 允许。

七、模型选择与成本优化

7.1 模型对比

智谱模型	对标 Claude	适用场景	消耗系数
GLM-5.1	Opus 4.6	复杂推理、架构设计	2-3×
GLM-5-Turbo	Sonnet	日常编程、代码补全	1×
GLM-4.5-Air	Haiku	快速响应、轻量任务	1×

7.2 额度恢复机制

智谱套餐采用 5 小时周期恢复机制------额度耗尽后，等待下一个周期自动恢复，不会自动扣费。规划好使用节奏。

7.3 最佳实践

日常任务：用 GLM-5-Turbo
架构设计/难题调试：切换到 GLM-5.1
高峰期（14:00-18:00）：GLM-5.1 消耗翻倍，建议避开
简单问答：用 GLM-4.5-Air

在 Claude Code 中切换模型：

bash 复制代码

/model

八、常见问题排查

问题现象	原因	解决方案
健康检查失败："404 Not Found"	Endpoint 填了通用地址	改用 `https://open.bigmodel.cn/api/anthropic`
claude 命令仍然连官方 API	环境变量覆盖了 CC-Switch 配置	检查 `ANTHROPIC_API_KEY` 等环境变量，删除后重试
`/openflow:xxx` 命令不存在	openflow 未正确安装	重新执行 `openflow init --tools claude`
Superpowers 不自动触发 TDD	`CLAUDE.md` 中未声明工作流	在项目 CLAUDE.md 中添加工作流规范声明
OpenSpec apply 还在执行	未取消选中 apply tasks	重新执行 `openspec config profile` 取消选中

九、总结：全流程命令速查表

步骤	命令	产物
环境配置	CC-Switch 配置智谱 GLM-5.1	API 连通
项目初始化	`openspec init`	`openspec/` 目录
项目初始化	`sot init . --tool claude-code`	`.claude/skills/`
关闭 OpenSpec apply	`openspec config profile`	配置变更
融合工作流（方案一：openflow）
需求捕捉	`/openflow proposal`	`proposal.md`
深度设计	`/openflow brainstorming`	设计决策记录
规范生成	`/openflow spec`	`specs/` + `plan-ready.md`
TDD 实施	`/openflow build`	代码 + 测试
归档	`/openflow close`	变更归档
融合工作流（方案二：手动）
需求探索	`/opsx:explore`	需求澄清
生成规范	`/opsx:propose <name>`	4 个规范文档
生成计划	`/superpowers:writing-plans`	`plan.md`
TDD 执行	`/superpowers:subagent-driven`	代码 + 测试
验证	`/opsx:verify`	验证报告
归档	`/opsx:archive`	归档变更
辅助命令
查看状态	`openflow status` 或 `openspec list`	变更列表
升级 skills	`openflow update` 或 `sot update`	skills 同步
诊断配置	`sot doctor`	健康报告
自动批准模式	`Shift+Tab` 切换	减少确认弹窗

写在最后

这套 Claude Code + CC-Switch + GLM-5.1 + OpenSpec + Superpowers 的融合方案，在我看来是目前国内开发者用上顶级 AI 编程能力、同时保证输出质量的最优解。

成本：使用成本较低
效率：规范驱动 + TDD 纪律，减少返工
质量：OpenSpec 保证设计可追溯，Superpowers 保证代码质量
体验：无需代理，国内直连，稳定不封号

2026 年的后端开发，拼的不再是"谁加班多"，而是"谁的规范更清晰、谁的 AI 协作更高效、谁的工程纪律更严谨"。

希望这篇文章能帮你从零到一搭建起这套工作流。如果在配置过程中遇到问题，欢迎留言交流。