Claude Code+OpenSpec 环境搭建与场景测试：AI 编码提效的真实体感

文章目录

• OpenSpec 基本概念
• • 什么是 OpenSpec
  • 常用命令
  • 典型执行路径
• 环境准备
• • Node.js 安装配置
  • OpenSpec 安装与初始化
  • Claude Code 安装与配置
  • • 命令行方式
    • VS Code插件
  • GPTs API
  • CC-Switch
• OpenSpec 效果测试
• • 测试用例
  • 指标分析（主观评估）
• OpenSpec 使用体验

OpenSpec 基本概念

什么是 OpenSpec

OpenSpec 用规范先行、提案驱动、文件化管理，让 AI 编程从 “模糊对话” 走向 “可控工程”，核心是提质量、降返工、可追溯、易协作。

常用命令

典型执行路径

# 场景1：简单明确需求:
/opsx:new ──► /opsx:ff ──► /opsx:apply ──► /opsx:verify ──► /opsx:archive

# 场景2：需求表达不出来:
/opsx:explore ──► /opsx:new ──► /opsx:continue ──► ... ──► /opsx:apply ──► /opsx:archive

环境准备

Node.js 安装配置

# 下载安装包
wget https://nodejs.org/dist/v24.14.0/node-v24.14.0-linux-x64.tar.xz
# 解压
tar -xvf node-v24.14.0-linux-x64.tar.xz
# 移动到/usr/local安装
mv node-v24.14.0-linux-x64 /usr/local/node-v24.14.0-linux-x64
cd /usr/local/node-v24.14.0-linux-x64

# 建立软链接
ln -s /usr/local/node-v24.14.0-linux-x64/bin/node /usr/local/bin/node
ln -s /usr/local/node-v24.14.0-linux-x64/bin/npm /usr/local/bin/npm

# 配置环境变量
vim /etc/profile

# 添加如下内容
export NODE_HOME=/usr/local/node-v24.14.0-linux-x64
export PATH=$PATH:$NODE_HOME/bin
export NODE_PATH=$NODE_HOME/lib/node_modules

# 使环境变量生效
source /etc/profile

# 查看版本号验证安装结果
node -v
npm -v

OpenSpec 安装与初始化

安装

# 安装
npm install -g @fission-ai/openspec@latest

# 查看版本号检查是否安装成功
openspec –version

项目初始化

cd your-project
openspec init

执行初始化后进入欢迎界面

Welcome to OpenSpec
A lightweight spec-driven framework

████ This setup will configure:
██ ██ • Agent Skills for AI tools
░░ ████ ░░ • /opsx:* slash commands
░░ ████ ░░
░░ ████ ░░ Quick start after setup:
██ ██ /opsx:new Create a change
████ /opsx:continue Next artifact
/opsx:apply Implement tasks

Press Enter to select tools...

选择编程工具（Claude Code）

? Select tools to set up (24 available)
Selected: Claude Code
Search: [type to filter]
↑↓ navigate • Space toggle • Backspace remove • Enter confirm
○ Amazon Q Developer
○ Antigravity
○ Auggie (Augment CLI)
› ◉ Claude Code (selected)
○ Cline
○ Codex
○ CodeBuddy Code (CLI)
○ Continue
○ CoStrict
○ Crush
○ Cursor
○ Factory Droid
○ Gemini CLI
○ GitHub Copilot
○ iFlow
(1/2)

生成openspec目录结构

# tree -a .claude openspec

.claude
├── commands
│ └── opsx
│ ├── apply.md
│ ├── archive.md
│ ├── explore.md
│ └── propose.md
└── skills
├── openspec-apply-change
│ └── SKILL.md
├── openspec-archive-change
│ └── SKILL.md
├── openspec-explore
│ └── SKILL.md
└── openspec-propose
└── SKILL.md
openspec
├── changes
│ └── archive
├── config.yaml
└── specs

Claude Code 安装与配置

命令行方式

Claude Code 官方文档：https://code.claude.com/docs/en/overview

# 官方脚本安装
curl -fsSL https://claude.ai/install.sh | bash

# 或通过npm全局安装
npm install -g @anthropic-ai/claude-code

安装完成后终端提示：

Setting up Claude Code...

✔ Claude Code successfully installed!

Version: 2.1.63

Location: ~/.local/bin/claude

Next: Run claude –help to get started

⚠ Setup notes:
• Native installation exists but ~/.local/bin is not in your PATH. Run:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

✅ Installation complete!

补充配置环境变量

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

验证安装与启动

# 验证版本
claude –version

# 启动
claude

启动后配置（主题选择）

Welcome to Claude Code v2.1.63
…………………………………………………………………………………………………………………………………………………………

* █████▓▓░
* ███▓░ ░░
░░░░░░ ███▓░
░░░ ░░░░░░░░░░ ███▓░
░░░░░░░░░░░░░░░░░░░ * ██▓░░ ▓
░▓▓███▓▓░
* ░░░░
░░░░░░░░
░░░░░░░░░░░░░░░░
█████████ *
██▄█████▄██ *
█████████ *
…………………█ █ █ █………………………………………………………………………………………………………………

Let's get started.

Choose the text style that looks best with your terminal
To change this later, run /theme

❯ 1. Dark mode ✔
2. Light mode
3. Dark mode (colorblind-friendly)
4. Light mode (colorblind-friendly)
5. Dark mode (ANSI colors only)
6. Light mode (ANSI colors only)

╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
1 function greet() {
2 – console.log("Hello, World!");
2 + console.log("Hello, Claude!");
3 }
╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
Syntax theme: Monokai Extended (ctrl+t to disable)

登录方式选择

Welcome to Claude Code v2.1.63
…………………………………………………………………………………………………………………………………………………………

* █████▓▓░
* ███▓░ ░░
░░░░░░ ███▓░
░░░ ░░░░░░░░░░ ███▓░
░░░░░░░░░░░░░░░░░░░ * ██▓░░ ▓
░▓▓███▓▓░
* ░░░░
░░░░░░░░
░░░░░░░░░░░░░░░░
█████████ *
██▄█████▄██ *
█████████ *
…………………█ █ █ █………………………………………………………………………………………………………………

Claude Code can be used with your Claude subscription or billed based on API usage through your Console account.

Select login method:

❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise

2. Anthropic Console account · API usage billing

3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI

登录成功后即可正常使用 Claude Code

╭─── Claude Code v2.1.63 ────────────────────────────────────────────────────────────────────────────────────────────────╮
│ │ Tips for getting started │
│ Welcome back Yao! │ Run /init to create a CLAUDE.md file with instructions for Claude │
│ │ ───────────────────────────────────────────────────────────────── │
│ │ Recent activity │
│ ▐▛███▜▌ │ No recent activity │
│ ▝▜█████▛▘ │ │
│ ▘▘ ▝▝ │ │
│ Sonnet 4.6 · API Usage Billing · Yao‘s Individual │ │
│ Org │ │
│ ~/workspace/FinQuery │ │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
❯ Try "write a test for <filepath>"
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
? for shortcuts

VS Code插件

插件市场中搜索“Claude Code for VS Code”进行安装

GPTs API

如无法直连Claude官方服务，可选择中转服务：https://gptsapi.net/

需将各 AI 模型的官方 API 地址替换为 GPTs API 地址：

• OpenAI API：https://api.openai.com → https://api.gptsapi.net
• Claude API：https://api.anthropic.com → https://api.gptsapi.net
• Gemini API：https://generativelanguage.googleapis.com → https://api.gptsapi.net

调用示例：

curl https://api.gptsapi.net/v1/messages \\
-H "Content-Type: application/json" \\
-H "x-api-key: sk-pTp7b3e8164015c23d53138c77a3511683b25d7b7b1G5Y87" \\
-H "anthropic-version: 2023-06-01" \\
-d '{
"model": "claude-opus-4-5-20251101",
"max_tokens": 1000,
"messages": [
{
"role": "user",
"content": "Hello, who are you"
}
]
}'

CC-Switch

安装 CC-switch 主要是为了方便切换各大模型厂商的API，下载地址：https://github.com/farion1231/cc-switch/releases

配置步骤：添加 Claude 模型供应商，将 API Key、请求地址、主模型替换为 GPTs API 提供的配置。

OpenSpec 效果测试

测试用例

选取部分有代表性场景记录如下：

指标分析（主观评估）

以下纯属主观印象：

OpenSpec 使用体验

优点

• 存量项目友好，增量迭代安全；
• 工具集成广泛，兼容 Cursor、Claude Code、Copilot 等主流 AI 编码助手；
• 变更隔离与协作友好，变更可审计、可追溯；
• 先定义精确规格（接口、边界、验收标准），提升AI输出的确定性与质量。

不足

• 太贵了，我是琼B不配玩AI。需严格评估效费比（如claude-opus-4-5-20251101模型：输入 $5.00/M Token，输出 $25.00/M Token；一个比较简单的文档总结需求：模型请求 14次，token消耗量 42W，费用 $1.61）；
• 流程开销大：对简单需求而言，规范驱动的开发模式过于笨重，易产生 “规范疲劳”；
• 额外维护成本：需在代码维护之外，同步维护 Spec 文档。

感想

• 角色转变：开发人员从 “编码执行者” 转向 “需求定义者 + 架构师”，对能力要求更高；
• 需求质量依赖：AI 输出效果极度依赖需求理解深度，对需求文档质量提出更高要求；
• 适用场景有限：Spec 并非万能，简单需求手写开发效率更高，需结合实际场景选择。

迷茫

• 整体提效验证：AI Coding 仅在编码环节有效率提升，全流程（需求、设计、测试、部署）是否提效缺乏严谨对照验证；
• 成本收益平衡：模型使用成本极高，效率提升能否覆盖资源投入成本尚未明确；
• 技术范式迭代：AI Coding 框架 / 模式层出不穷，学习成本很高，Spec 是否为最优范式？新技术出现是否会替代 Spec 模式？