你是否想过,即使不懂复杂的语法,也能让 AI 帮你写出健壮的代码?

今天,我们将在 Windows 上从零开始,搭建一套顶级的 AI 编程环境:Claude Code(官方工具) + GLM-5(免费中文神模)。如果你追求极致的工程化体验,我们还将解锁 Superpowers 插件,让 AI 学会像资深工程师一样思考。

准备工作:安装 Node.js

Claude Code 运行在 Node.js 环境下。这是目前最通用的前端基础环境,安装一次,终身受用。

  1. 下载:访问 Node.js 官网,下载左侧的 LTS 版本(长期支持版)。
  2. 安装:双击安装包,一路点击 “Next” 完成安装。
  3. 验证:打开 PowerShell(Win + R 输入 powershell),输入:
    node --version
    
    如果看到版本号(如 v22.x.x),说明环境就绪!

第一步:安装 Claude Code

Windows 用户推荐使用 npm 安装,简单快捷。在 PowerShell 中运行:

npm install -g @anthropic-ai/claude-code

安装完成后,输入 claude --version,看到版本号即代表安装成功。

第二步:接入 GLM-5 模型

Claude Code 默认使用 Claude 模型,但在国内,我们更推荐接入智谱的 GLM-5。它不仅中文理解能力极强,而且 Coding Plan(代码规划)额度大,访问速度快。

  1. 访问 GLM Coding Plan 官网
  2. 注册/登录并获取订阅。
  3. 按照官方文档指引,配置环境变量(通常设置 ANTHROPIC_BASE_URLANTHROPIC_API_KEY 指向 GLM 的端点)。

配置完成后,Claude Code 就拥有了强大的“中文大脑”。

第三步:开始你的第一次对话

  1. 进入你的项目目录(如果没有,先 mkdir my-project 创建一个)。
  2. 输入 claude 启动。
  3. 首次启动会询问是否信任文件夹,输入 Y
  4. 开始聊天:

    :请帮我分析一下这个项目结构,并写一个简单的 Hello World。

此时,Claude Code 已经能像助手一样帮你读代码、写代码、修 Bug 了。


进阶教学:为什么你需要 Superpowers?

如果你只是想写个脚本,上面的步骤足够了。但如果你想开发长期维护的项目,直接让 AI 写代码是非常危险的。

痛点是什么?

  • 乱改:AI 经常为了修一个 Bug,顺手把别的地方改坏了。
  • 无规划:写到哪里算哪里,没有测试,没有文档。
  • 凭感觉:遇到报错,AI 经常瞎猜,越改越乱。

Superpowers 的核心理念:Process over Prompt(流程大于提示)

它不只是一个插件,它是一套强制执行的软件工程工作流。它把人类工程师几十年的智慧,变成了 AI 的本能。

Superpowers 教学时刻:它如何改变 AI?

让我们看看 Superpowers 是如何通过几个核心“技能”来驯服 AI 的:

1. 头脑风暴
  • 普通 AI:你问“加个登录功能”,它直接开始写代码,结果发现你想要的是微信登录,它写成了账号密码。
  • Superpowers:在写代码前,它会强制停下来问你:

    “在开始之前,我需要确认:你需要支持第三方登录吗?忘记密码流程怎么处理?是否需要记住我?”
    教学点想清楚再动手,这是资深工程师的第一原则。

2. 测试驱动开发 (TDD)
  • 普通 AI:直接写函数代码。
  • Superpowers:它先写一个必定失败的测试用例,然后写代码让测试通过。
    教学点先定义预期结果,再实现逻辑。这保证了你的代码永远有测试保护,重构时不慌。
3. Git Worktree 隔离
  • 普通 AI:直接在你的主分支上改,改坏了整个项目崩溃。
  • Superpowers:它会自动创建一个虚拟的“平行宇宙”(Git Worktree)。在这个隔离区里,AI 怎么折腾都没关系。如果满意,再合并回来;如果不满意,直接丢弃,主代码干干净净。
    教学点隔离开发环境,是保护主分支安全的最强手段。

安装 Superpowers

https://github.com/obra/superpowers/

前置要求:安装 Git(Windows 版一路 Next 安装即可)。

在 Claude Code 终端中依次执行:

# 1. 注册应用市场
/plugin marketplace add obra/superpowers-marketplace

# 2. 安装插件
/plugin install superpowers@superpowers-marketplace

安装成功后,输入 /help,你会看到一系列以 /superpowers: 开头的命令。

实战演练:使用 Superpowers 开发功能

核心技能库 (Skills List)

Superpowers 将开发任务拆分为多个原子化的技能模块,主要包括:

  • 流程决策类
  • brainstorming:通过苏格拉底式提问进行设计细化,在写代码前达成共识。
    • systematic-debugging:四阶段根因分析(证据分析、建立假设、验证测试、实施修复)。
    • writing-plans:将设计转化为极小的、可验证的实施计划(通常每项任务 2-5 分钟)。
  • 执行与验证类
  • test-driven-development:强制执行“红-绿-重构”循环,未见测试失败禁止写功能代码。
    • executing-plans:批量执行任务计划,并在关键节点设置人工检查点。
    • subagent-driven-development:派发独立的子代理(Subagent)执行具体任务,并进行两阶段审查。
  • 环境与协同类
  • using-git-worktrees:在隔离的 Git 工作树中开发,保护主分支环境。
    • requesting-code-review / receiving-code-review:结构化的代码审查发起与反馈处理。
    • finishing-a-development-branch:验证所有测试后,执行合并、PR 或清理工作。 [1, 3, 4, 5, 6, 7, 8, 9]

标准使用流程

AI 智能体会根据任务上下文自动触发相关技能,典型的端到端流程如下:

  1. 构思阶段:触发 brainstorming。AI 会通过一问一答明确需求,并生成设计文档。
  2. 准备阶段:使用 using-git-worktrees 创建一个干净的开发分支和本地工作目录。
  3. 计划阶段:执行 writing-plans。AI 将大任务拆解为精细的 TODO 列表,包含具体的路径和命令。
  4. 开发阶段:基于 test-driven-development。
  • 派发子代理(subagent-driven-development)针对每个小任务编写测试并实现代码。
    • 每个任务完成后自动触发 requesting-code-review 进行质量检查。
  1. 结束阶段:运行 finishing-a-development-branch。验证全局测试通过后,清理分支并合并代码。 [1, 3, 5, 6, 10, 11]

应该先用哪个 Skill?

根据 Superpowers 的设计原则,必须从“过程类技能”(Process Skills)开始: [12, 13]

  • 如果你要“开发新功能”:首选 /superpowers:brainstorming。在未完成设计细化并获得用户批准前,系统禁止进入计划或编码阶段。
  • 如果你要“修复 Bug”:首选 /superpowers:systematic-debugging。必须先通过系统性排查确定根因,严禁直接尝试修复(Guess-and-check)。 [1, 3, 14]

总结

现在,你的电脑上已经装备了:

  1. Claude Code:官方 AI 终端。
  2. GLM-5:强大的中文编码模型。
  3. Superpowers:工程化工作流守护者。

给新手的建议:

  • 起步:先不要急着装 Superpowers,用基础指令熟悉 Claude Code 的交互感。
  • 进阶:当你准备开始正经项目时,安装 Git 和 Superpowers,体验“流程大于提示”的爽快感。

AI 时代,人人都是开发者。别犹豫了,打开终端,开始你的第一个项目吧!

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐