OpenSpec：OpenSpec 结合 Claude Code 的 AI 项目开发完整指南

下面这篇正文可以直接复制到 CSDN。文末我单独给了一个标题。

OpenSpec + Claude Code 项目开发完整指南：开发小白也能按步骤上手

很多新手用 AI 写代码时，最大的问题不是“AI 不会写”，而是“我不知道怎么把需求讲清楚”。结果经常变成：一开始让 AI 写功能，中途发现需求没说清，代码越改越乱，最后自己也不知道项目变成了什么样。

OpenSpec 的作用，就是在写代码之前，先让你和 AI 把“要做什么、为什么做、怎么做、分几步做”整理清楚。Claude Code 则负责读取代码、修改文件、运行命令、执行开发任务。Claude Code 官方文档中也说明，它可以读取代码库、编辑文件、运行命令，并集成到终端、IDE、桌面应用和浏览器中使用。(Claude)

OpenSpec 官方 README 也明确说，它是为 AI coding assistant 准备的轻量级 spec 层，用来在写代码前先对齐需求，并把每个变更整理成 proposal、specs、design、tasks 等文件。(GitHub)

简单理解：

Claude Code = 帮你写代码、改代码、跑命令的 AI 程序员 OpenSpec = 帮你把需求、设计、任务清单管理好的项目产品经理 OpenSpec + Claude Code = 先写清楚需求，再让 AI 稳定地实现

一、什么场景适合用 OpenSpec + Claude Code？

适合这些情况：

1. 你是开发新手，不知道怎么拆需求 2. 你怕直接让 AI 写代码会写偏 3. 你想做一个完整小项目，比如后台管理系统、博客系统、AI 工具、微信小程序后端 4. 你正在维护老项目，想新增功能但不想改乱 5. 你想让 AI 每次开发都有文档、有任务、有记录

不太适合的情况：

1. 只是改一个错别字 2. 只是让 AI 解释一段代码 3. 只是临时写一个很小的脚本

对于新手，我建议：只要是“新增功能”或“改动超过 2 个文件”，就可以使用 OpenSpec 流程。

二、核心概念：先看懂这 4 个文件

OpenSpec 初始化后，会在项目里创建一个openspec/目录。官方文档说明，openspec/specs/是当前系统行为的事实来源，openspec/changes/用来存放每一次计划中的变更；每个 change 下面通常有proposal.md、design.md、tasks.md和specs/。(GitHub)

你先记住这几个文件就够了：

proposal.md：说明为什么要做、要做什么、不做什么 specs/：用需求和场景描述功能变化 design.md：说明技术方案，比如接口、数据库、组件、流程 tasks.md：任务清单，AI 会按这个一步步实现

用人话理解：

proposal.md = 产品需求说明 specs/ = 功能验收标准 design.md = 技术设计方案 tasks.md = 开发任务清单

OpenSpec 的好处是：它不是让你一上来就写代码，而是先让 AI 帮你把这几个文件生成出来。你看得懂、能改、能确认之后，再让 Claude Code 开始写代码。

三、准备环境

1. 安装 Claude Code

Claude Code 可以在终端中使用。官方文档给出的安装方式如下。

macOS、Linux、WSL：

curl-fsSLhttps://claude.ai/install.sh|bash

Windows PowerShell：

irmhttps://claude.ai/install.ps1|iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装后，进入你的项目目录并启动：

cdyour-project claude

首次使用会要求登录。Claude Code 官方文档也提醒，Windows 原生环境推荐安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具；如果没有安装，则会退回 PowerShell。(Claude)

2. 安装 Node.js

OpenSpec 需要 Node.js。官方 README 写明，OpenSpec 要求 Node.js 20.19.0 或更高版本。(GitHub)

检查 Node.js 版本：