第十章：常见问题与避坑

# 定期主动压缩，不等 Claude 遗忘才处理
# 在完成每个子任务后执行：
/compact 保留：已修改的文件列表、下一步计划、当前约定的代码规范

# 被拒绝的写法
生成一个绕过登录验证的脚本

# 合理的改写（说明合法背景）
我是这个系统的开发者，正在进行渗透测试。
请帮我分析 src/auth/middleware.ts 中的登录验证逻辑，
找出可能存在的安全漏洞，以便我修复它们。

Error: Tool 'Bash' is not allowed
→ 原因：settings.json 中没有允许 Bash 工具，或 deny 规则命中
→ 修复：在 permissions.allow 中添加 "Bash(your-command *)"

Error: Write permission denied for path '/etc/...'
→ 原因：目标路径不在 Write 权限的允许范围内
→ 修复：检查 permissions.allow 中的 Write 路径规则

Error: ANTHROPIC_API_KEY is not set
→ 原因：环境变量未配置
→ 修复：export ANTHROPIC_API_KEY="sk-ant-..."

Error: 401 Unauthorized
→ 原因：API Key 无效或已过期
→ 修复：在 Anthropic Console 重新生成 Key

# 在 CLAUDE.md 中固化输出规范
## 输出规范（每次都必须遵守）
- 代码统一使用 TypeScript，严格模式
- 函数命名用 camelCase，类命名用 PascalCase
- 每个函数不超过 30 行，超出则拆分
- 不添加我没有要求的功能（YAGNI 原则）
- 修改现有代码前，先说明修改理由

import anthropic
import time

client = anthropic.Anthropic(
    max_retries=3,  # SDK 内置重试
    timeout=60.0,
)

def call_with_backoff(messages, max_attempts=5):
    """手动指数退避，用于需要更精细控制的场景"""
    for attempt in range(max_attempts):
        try:
            return client.messages.create(
                model="claude-sonnet-4-6",
                max_tokens=1024,
                messages=messages,
            )
        except anthropic.RateLimitError:
            if attempt == max_attempts - 1:
                raise
            wait = (2 ** attempt) + 0.5  # 1.5s, 2.5s, 4.5s, 8.5s
            print(f"限流，{wait}s 后重试...")
            time.sleep(wait)
        except anthropic.APIStatusError as e:
            if e.status_code == 529:  # 服务器过载
                time.sleep(5)
                continue
            raise

# 在 Claude Code REPL 中随时查看当前会话费用
/cost

# API 响应中查看精确用量
response.usage.input_tokens   # 输入 token 数
response.usage.output_tokens  # 输出 token 数
response.usage.cache_read_input_tokens   # 缓存命中数（不计费）
response.usage.cache_creation_input_tokens  # 缓存写入数

# 检查是否不小心提交了 Key
git log --all --full-history -- **/*.env
git grep -r "sk-ant-" --cached

# 如果已提交，立即撤销并用 git-filter-repo 清理历史
pip install git-filter-repo
git filter-repo --replace-text <(echo "sk-ant-XXXX==>REMOVED")

{
  "permissions": {
    "allow": [
      "Read(src/**)",
      "Read(tests/**)",
      "Write(src/**)",
      "Bash(npm test)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(npm publish *)",
      "Bash(rm *)",
      "Write(.env*)",
      "Write(*.key)",
      "Write(*.pem)"
    ]
  }
}