最佳实践

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://nexor.nexoraivision.com/v1"
)

LONG_SYSTEM = """
你是这个项目的资深贡献者。规则：
1. ...（500+ tokens 的详细规则）
"""

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": LONG_SYSTEM,
            "cache_control": {"type": "ephemeral"}  # 关键
        }
    ],
    messages=[{"role": "user", "content": "..."}]
)

# 查看缓存命中情况
print(response.usage)
# {
#   "input_tokens": 10,
#   "cache_creation_input_tokens": 0,    # 0 表示命中
#   "cache_read_input_tokens": 523,       # 命中的缓存 token 数
#   "output_tokens": 150
# }

# 项目名

## 技术栈
- Vue 3 + TypeScript + Nuxt 4
- pnpm 包管理
- Vitest 测试

## 目录结构
- `app/` — Nuxt 应用代码
- `server/` — API routes
- `content/` — 文档 Markdown

## 编码规范
- 函数式优先，避免类继承
- 错误用 Result<T,E>，不抛异常
- 组件命名 PascalCase，工具函数 camelCase

## 常用命令
```bash
pnpm dev          # 启动 dev server
pnpm test         # 跑测试
pnpm lint:fix     # 自动修 lint

### 自动生成

```bash
claude
> /init       # 让 Claude 帮你生成 CLAUDE.md

项目/
├── CLAUDE.md              # 全局约定
└── packages/
    └── api/
        └── CLAUDE.md      # API 包专属约定

# 交互模式：精准引用
> 看下 @src/api/user.ts 的 getUserById 函数

# 启动时：批量加载
claude --add-dir ./src/api

> /compact

帮我写个登录功能

基于 @src/auth/ 现有代码，给登录功能加上：
1. 邮箱 + 密码登录
2. 失败 3 次锁定 5 分钟
3. 锁定时间存 Redis，key 格式 `lock:user:<email>`
4. 写 vitest 测试覆盖：正常登录、密码错、锁定中、解锁后
5. 用现有的 Result<T,E> 错误处理风格，不要 throw

参考 @src/auth/utils.ts 的命名风格。

> 我想给现有的 KV 缓存层加 LRU 淘汰策略，不破坏已有调用方。
> 先告诉我你打算怎么改、影响哪些文件、风险点。不要写代码。

[Claude 给方案]

> 方案 OK，按你说的顺序开始改。每改完一个文件先告诉我，我看完确认你再继续。

**/.claude/settings.json
**/.continue/config.json
**/opencode.json

npm test 2>&1 | claude -p "解释这堆失败，从最根本的问题开始排"

claude --max-turns 20 "实现 utils/date.ts 的 formatRelative，写完跑 npm test，失败就改直到全过"

claude --verbose "..."

claude doctor

项目/
└── .claude/
    └── prompts/
        ├── review-pr.md
        ├── write-test.md
        └── debug-flake.md

claude -p "$(cat .claude/prompts/review-pr.md)"

- name: Claude PR review
  env:
    ANTHROPIC_BASE_URL: https://nexor.nexoraivision.com
    ANTHROPIC_AUTH_TOKEN: ${{ secrets.NEXOR_CLAUDE_KEY }}
  run: |
    git diff origin/main --unified=10 > diff.txt
    claude -p --output-format json --model claude-sonnet-4-6 \
      "review 下面的 diff，输出 JSON: {issues:[{file,line,severity,message}]}" \
      < diff.txt > review.json

# macOS
claude "重构 auth 模块" -f src/auth/*.ts && \
  osascript -e 'display notification "完成" with title "Claude"' && \
  afplay /System/Library/Sounds/Glass.aiff