node --version   # 应输出 v18.x.x 或更高
npm --version

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

# Windows（PowerShell，用 winget）
winget install OpenJS.NodeJS.LTS

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

claude --version

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows（PowerShell）
irm https://claude.ai/install.ps1 | iex

mkdir ~/claude-lab && cd ~/claude-lab
claude

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

~/.claude/settings.json            # 用户级：所有项目生效
<项目>/.claude/settings.json       # 项目级：随仓库提交，团队共享
<项目>/.claude/settings.local.json # 本地级：不提交，个人覆盖

{
  "permissions": {
    "allow": [
      "Bash(python *)",
      "Bash(pip install *)",
      "Bash(cat *)",
      "Bash(ls *)",
      "Read",
      "Write",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  }
}

# 项目：命令行单词卡

## 目标
一个零依赖（仅 Python 标准库）的命令行单词卡背诵工具。

## 技术栈
- Python 3.8+，仅用标准库（json、random、argparse）
- 数据存在 words.json

## 功能
1. learn：添加生词（单词、释义、例句）
2. quiz：随机抽 5 个词测试，答对显示例句
3. list：列出全部词条

## 代码规范
- 中文注释，函数加 docstring
- 不引入第三方库
- 运行入口：python flashcard.py

请按 CLAUDE.md 的规划，实现这个单词卡工具。先给我一个实现方案和数据结构设计，不要写代码。

方案没问题，按此实现 flashcard.py 和示例 words.json。

import json, random, argparse, os
from pathlib import Path

DB = Path(__file__).parent / "words.json"

def load_words():
    """读取词库，不存在则返回空列表。"""
    if not DB.exists():
        return []
    return json.loads(DB.read_text(encoding="utf-8"))

def save_words(words):
    """持久化词库。"""
    DB.write_text(json.dumps(words, ensure_ascii=False, indent=2), encoding="utf-8")

def cmd_learn(args):
    """添加一个生词。"""
    words = load_words()
    words.append({"word": args.word, "meaning": args.meaning, "example": args.example or ""})
    save_words(words)
    print(f"✅ 已添加：{args.word} —— {args.meaning}")

def cmd_quiz(args):
    """随机抽测 n 个词。"""
    words = load_words()
    n = min(args.n, len(words)) if words else 0
    if n == 0:
        print("词库为空，先 learn 添加几个词吧。"); return
    score = 0
    for w in random.sample(words, n):
        ans = input(f"\n【{w['word']}】的释义是？> ")
        if ans.strip() == w["meaning"]:
            score += 1; print("✅ 正确！", f"例句：{w['example']}" if w['example'] else "")
        else:
            print(f"❌ 正确答案：{w['meaning']}")
    print(f"\n本轮得分 {score}/{n}")

def cmd_list(args):
    """列出全部词条。"""
    for i, w in enumerate(load_words(), 1):
        print(f"{i}. {w['word']} —— {w['meaning']}")

def main():
    p = argparse.ArgumentParser(description="命令行单词卡背诵工具")
    sub = p.add_subparsers(dest="cmd", required=True)
    pl = sub.add_parser("learn"); pl.add_argument("--word", required=True); pl.add_argument("--meaning", required=True); pl.add_argument("--example")
    pq = sub.add_parser("quiz"); pq.add_argument("-n", type=int, default=5)
    sub.add_parser("list")
    a = p.parse_args()
    {"learn": cmd_learn, "quiz": cmd_quiz, "list": cmd_list}[a.cmd](a)

if __name__ == "__main__":
    main()

用 python flashcard.py learn 添加 3 个示例词，再用 quiz 抽测 3 个，确认没有报错。

python flashcard.py learn --word serendipity --meaning "意外发现美好事物的能力" --example "Finding this cafe was pure serendipity."
python flashcard.py learn --word ephemeral --meaning "短暂的，转瞬即逝的"
python flashcard.py list
python flashcard.py quiz -n 2

1. serendipity —— 意外发现美好事物的能力
2. ephemeral —— 短暂的，转瞬即逝的

【ephemeral】的释义是？> 短暂的，转瞬即逝的
✅ 正确！

本轮得分 1/2

flowchart TD
    A[检查 Node 18+] --> B[安装 Claude Code<br/>npm 或 原生脚本]
    B --> C[claude 首次启动<br/>OAuth/API Key 登录]
    C --> D[新建项目目录<br/>进入会话]
    D --> E[写 settings.json<br/>配置 allow/deny 权限]
    E --> F[写 CLAUDE.md<br/>项目记忆与规范]
    F --> G[Plan 模式出方案]
    G --> H{方案满意?}
    H -- 否 --> G
    H -- 是 --> I[默认模式执行<br/>逐条确认]
    I --> J[让 Claude 跑测试]
    J --> K{通过?}
    K -- 否 --> I
    K -- 是 --> L[完成单词卡工具<br/>实机体验]
    L --> M[/cost 查花费<br/>/clear 收尾]