基于 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。
4. 实践步骤
4.1 安装 Claude-Code
通过 Win+R 输入 cmd 进入命令行终端,执行以下命令:
npm install -g @anthropic-ai/claude-code
下载完成后执行以下命令验证安装:
claude
若能进入交互界面说明安装成功。[图片]
安装成功后无法立即使用,因为 Claude-Code 本身没有免费 AI 大模型可供使用。若需使用,则需配置其他 AI 大模型的 Key,目前常用的是 DeepSeek、阿里云千问等。这里以 DeepSeek 为例,需要在环境变量中配置相关参数:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=你的 DeepSeek 密钥
export API_TIMEOUT_MS=600000
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
在系统环境变量中依次添加上述 6 个参数。[图片]
创建完成后重新打开 cmd 执行 claude。此时正常情况下 Claude 已将配置的 URL 作为默认源,可通过 /model 命令进行检查和选用。[图片]
至此 Claude-Code 已安装完成。
4.2 安装 OpenSpec
在 cmd 中执行:
npm install -g @fission-ai/openspec@latest
安装完成后可以在 cmd 中执行 openspec init 来验证是否生效,若已生效则 OpenSpec 安装完成。
5. 使用教程
5.1 初始化项目
在想要使用 AI 的目录下打开 cmd,执行:
openspec init
然后我们可以进入 Claude,在 Claude-Code 中输入 /openspec,终端会自动补全可用命令:[图片]


