如果你安装了 Claude Code 只和它聊天——你就错过了重点

Source: Dev.to

你安装了 Claude Code，输入 claude，聊天窗口打开。如果你仅用它来修复 bug 或编写测试，那只利用了它大约 20 % 的潜力。真正的威力在于三个配置文件——CLAUDE.md、Hooks 设置和 MCP 服务器连接。配置好它们后，体验会彻底改变。

Claude Code 在会话结束后会忘记所有内容，所以像 “始终在 pytest 中使用 -v 参数” 这样的偏好会消失。项目根目录下的 CLAUDE.md 文件会在会话启动时自动保存这些规则。

项目指南

开发规则

• 始终使用 pytest tests/ -v 运行测试
• 在任何数据库操作前创建备份
• 提交信息使用 feat/、fix/、docs/ 前缀

技术栈

• 后端: Python 3.11、FastAPI、PostgreSQL
• 前端: Next.js 14 App Router

Hooks

Hooks 让你在特定生命周期点运行 shell 命令。

Post‑tool‑use Hook（自动格式化 TypeScript 文件）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read f; if echo \"$f\" | grep -qE '\\.(ts|tsx)$'; then npx prettier --write \"$f\" 2>/dev/null; fi; }"
          }
        ]
      }
    ]
  }
}

Pre‑tool‑use Hook（阻止对 .env 文件的编辑）

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "python3 -c \"import json,sys; d=json.load(sys.stdin); p=d.get('tool_input',{}).get('file_path',''); sys.exit(2 if '.env' in p else 0)\""
          }
        ]
      }
    ]
  }
}

MCP 集成

使用 claude mcp add 连接外部服务。

• -s user → 全局工具
• -s project → 项目专属工具

GitHub

claude mcp add github -s user \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=your-token \
  -- npx -y @modelcontextprotocol/server-github

Context7

claude mcp add context7 -s user -- npx -y @upstash/context7-mcp@latest

Playwright

claude mcp add playwright -s project -- npx -y @playwright/mcp@latest

PostgreSQL

claude mcp add postgres -s project \
  -e DATABASE_URL="postgresql://user:pass@localhost:5432/mydb" \
  -- npx -y @modelcontextprotocol/server-postgres

• CLAUDE.md 用于定义持久化规则。
• Hooks 用来执行质量检查和代码格式化。
• MCP 扩展了 Claude Code 的功能。

半小时的配置工作可以每天受益——Claude Code 的真正强大之处不只在对话，而在于驱动它的配置。