基于claude-code+deepseek+openspec实现自动化代码生成个人教程
基于claude-code+deepseek+openspec实现自动化代码生成
1、Claude-Code与OpenSpec简介
Claude-Code是Anthropic开发的代码生成模型，专注于理解自然语言描述并生成高质量代码。OpenSpec通常指开放的API规范标准（如OpenAPI/Swagger），用于标准化接口描述。两者结合可实现从接口文档到代码的自动化生成。
2、Claude-Code与OpenSpec代码生成的优点
准确性：基于规范化的OpenSpec描述，生成的代码能精确匹配接口需求，减少手动错误。
效率提升：自动生成基础代码（如API客户端、服务端桩代码），节省开发时间。
一致性：团队遵循同一规范，确保代码风格和接口定义统一。
维护性：OpenSpec变更时，可快速重新生成代码，降低同步成本。
3、前期准备
本教程主要使用node.js进行安装，需要用户安装好node.js，node.js安装可以自行搜索，也可以参考菜鸟教程
4、实践步骤
4.1、安装claude-code
通过win+R 输入cmd进入命令行终端，执行以下命令
npminstall-g @anthropic-ai/claude-code 下载完成后可以执行一下
claude 看一下是否安装成功，如果能进入一下界面说明安装成功
安装成功后我们并无法立即使用，因为claude-code本身没有免费ai大模型可供使用，我们如果想要使用，则需要配置其他ai大模型的key，目前常用的是deepseek、阿里云千问等等，这里我们以deepseek为例，我们需要在环境变量中配置相关参数，参数有这些：
exportANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic exportANTHROPIC_AUTH_TOKEN=你的DeepSeek密钥 # 把占位符替换为真实密钥exportAPI_TIMEOUT_MS=600000exportANTHROPIC_MODEL=deepseek-chat # 要使用的模型exportANTHROPIC_SMALL_FAST_MODEL=deepseek-chat exportCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1在环境变量里面我们把上面6个参数依次创建
创建完成后重新打开cmd执行claude
此时正常情况claude已经将你配置的url作为默认源了，想在确认的话可以执行
/model命令进行检查和选用。
此时claude-code已经安装完成。
4.2、安装openspec
还是在cmd中执行
npminstall-g @fission-ai/openspec@latest 安装完成后可以在cmd中执行openspec init来验证是否生效，若已生效则openspec安装完成。
5、使用教程
5.1、初始化项目
在我们想要使用ai的目录下打开cmd，执行：
openspec init 然后我们可以进入claude了，在claude-code中我们可以输入/openspec，终端会自动补全可用命令：
这四个命令分别对应的是
- /openspec-explore
探索模式
作用：进入一个“思考伙伴”式的交互状态，帮助用户梳理思路、深入分析问题、澄清模糊的需求。
适用场景：当你对要解决的问题还不够清晰，或者需要讨论多种可能性时，可以使用该命令。Claude 会通过提问和引导，与你一起探索，最终形成更明确的方向。
- /openspec-propose
提出变更
作用：基于用户快速描述的想法，一次性生成完整的提案文档，包括规范（spec）、任务清单（tasks）和其他相关产物。
适用场景：当你已经大致知道要构建什么，希望快速得到一个结构化的方案时使用。它会将你的需求转化为可审查的规范，为后续实施奠定基础。
- /openspec-apply-change
实施变更
作用：根据已生成的 OpenSpec 变更（即任务清单），开始或继续执行具体的开发任务。Claude 会按照任务步骤逐一生成代码、编写测试等。
适用场景：当提案通过审查后，用此命令启动实现阶段。它会读取当前变更目录中的任务文件，并逐步完成所有待办项。
- /openspec-archive-change
归档变更
作用：在变更实施完成并确认无误后，将其归档。归档会将本次变更的所有记录（提案、规范、任务、实现代码等）整理保存到项目的历史目录中，同时清理工作区。
适用场景：功能开发完毕，经过测试和验收后，用此命令完成知识沉淀和版本收尾，确保主分支的规范始终反映最新状态。
我们想要构建项目首先要先使用/openspec-explore，此时ai会和你互动式交互，你提出你的需求，AI会根据你的需求不断向你咨询，完善和补全项目，最后生成一个任务，放在你的openspec\change目录下，当任务成功生成后，让 Claude 读取刚刚生成的规范文档
你可以直接告诉 Claude 文档的位置和要完成的任务，例如：
请根据 openspec/changes/[你的功能名称]/ 目录下的所有文档，开始实现这个功能。先阅读 proposal.md 和 tasks.md，然后按 tasks 列表的顺序逐一实现。 （将 [你的功能名称] 替换为实际文件夹名，比如 add-login-page） 按任务清单逐步实现
Claude 会理解 tasks.md 中的任务列表，然后依次生成代码。如果需要讨论某个任务，你可以随时提问。
验证实现是否完成
实现完一个任务后，可以让 Claude 帮你测试或解释代码。全部完成后，可以用 openspec list 确认所有变更是否已应用（如果有未提交的更改可能会显示为 active）。
实现过程中，ai会不断向你询问是否授权执行命令，最好自己辨别一下ai要执行的具体命令，防止ai越权操作导致系统bug。
最后，我们只需要等待ai生成代码，编译，自我验证完成即可。
