10 - 配置优化指南

⚙️ 深度定制 Claude Code，打造最适合你的开发环境

📋 本章目标

  • ✅ 掌握编辑器配置优化
  • ✅ 学会 API 设置和额度管理
  • ✅ 自定义 AI 行为规则
  • ✅ 项目级配置管理
  • ✅ 性能调优技巧

预计阅读时间: 20分钟

⚙️ 编辑器配置

基础设置

打开设置

Mac: Cmd + ,
Windows/Linux: Ctrl + ,

或

Cmd/Ctrl + Shift + P → "Settings"

推荐配置

// settings.json

{
  // === AI 设置 ===
  "claude.model": "claude-3-5-sonnet-20241022",
  "claude.temperature": 0.7,  // 创造性 (0-1)
  "claude.maxTokens": 4096,
  
  // === 自动补全 ===
  "editor.inlineSuggest.enabled": true,
  "editor.quickSuggestions": {
    "other": true,
    "comments": false,
    "strings": true
  },
  
  // === 代码格式化 ===
  "editor.formatOnSave": true,
  "editor.formatOnPaste": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  
  // === 自动保存 ===
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 1000,
  
  // === 字体 ===
  "editor.fontFamily": "'Fira Code', 'Monaco', monospace",
  "editor.fontLigatures": true,
  "editor.fontSize": 14,
  "editor.lineHeight": 1.6,
  
  // === 主题 ===
  "workbench.colorTheme": "GitHub Dark",
  "workbench.iconTheme": "material-icon-theme",
  
  // === 终端 ===
  "terminal.integrated.fontSize": 13,
  "terminal.integrated.fontFamily": "'MesloLGS NF'",
  
  // === 文件排除 ===
  "files.exclude": {
    "**/node_modules": true,
    "**/.git": true,
    "**/dist": true,
    "**/.next": true
  },
  
  // === 搜索排除 ===
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/.next": true,
    "**/build": true
  }
}

🤖 AI 模型配置

模型选择

Claude 3.5 Sonnet (推荐)

{
  "claude.model": "claude-3-5-sonnet-20241022",
  "claude.description": "最强大，最推荐"
}

特点:

  • ⭐⭐⭐⭐⭐ 代码质量
  • ⭐⭐⭐⭐ 速度
  • ⭐⭐⭐⭐⭐ 理解能力
  • 适合：所有场景

Claude 3 Haiku (快速)

{
  "claude.model": "claude-3-haiku-20240307",
  "claude.description": "更快，省额度"
}

特点:

  • ⭐⭐⭐ 代码质量
  • ⭐⭐⭐⭐⭐ 速度
  • ⭐⭐⭐ 理解能力
  • 适合：简单任务、快速补全

Temperature 设置

{
  "claude.temperature": 0.7
}

指南:

  • 0.0-0.3: 确定性高，适合生成测试、配置
  • 0.4-0.7: 平衡，适合日常开发（推荐）
  • 0.8-1.0: 创造性高，适合探索、创意

Max Tokens 设置

{
  "claude.maxTokens": 4096
}

指南:

  • 1024-2048: 短回复，快速补全
  • 2048-4096: 中等回复（推荐）
  • 4096-8192: 长回复，完整实现

📝 自定义 AI 规则

.cursorrules 文件

项目根目录创建 .cursorrules:

# .cursorrules

# === 项目信息 ===
项目名称: My Awesome App
技术栈: Next.js 14, TypeScript, Prisma, TailwindCSS
架构模式: Feature-based modules

# === 代码规范 ===
## 命名规范
- 文件: kebab-case (user-profile.tsx)
- 组件: PascalCase (UserProfile)
- 变量/函数: camelCase (getUserProfile)
- 常量: UPPER_SNAKE_CASE (API_BASE_URL)
- 类型/接口: PascalCase with prefix (IUser, TUserRole)

## 代码风格
- 使用函数式组件
- 优先使用 hooks
- 箭头函数优于 function
- 单引号优于双引号
- 末尾不加分号
- 使用 2空格缩进

## TypeScript
- 严格模式开启
- 不使用 any (使用 unknown)
- 导出所有类型定义
- Props 接口命名：{ComponentName}Props

## React 规范
- Props 解构
- 使用 React.FC<Props> (可选)
- 默认导出组件
- 使用 memo 优化性能关键组件

## 文件组织

src/ ├── features/ # 功能模块 │ ├── auth/ │ │ ├── components/ │ │ ├── hooks/ │ │ ├── api/ │ │ └── types/ ├── shared/ # 共享代码 │ ├── components/ │ ├── hooks/ │ └── utils/


## 注释规范
- 所有导出的函数添加 JSDoc
- 复杂逻辑添加行内注释
- 组件添加描述注释
- 不写废话注释

## 错误处理
- 使用 try-catch
- 自定义错误类型
- 友好的错误提示
- 记录错误日志

## 测试
- 单元测试: Jest + React Testing Library
- E2E: Playwright
- 覆盖率目标: 80%+

## 性能
- 使用 useMemo/useCallback 优化
- 图片使用 next/image
- 代码分割（动态导入）
- 避免不必要的重渲染

## 安全
- 所有用户输入验证（Zod）
- SQL注入防护（Prisma）
- XSS防护（DOMPurify）
- CSRF token
- 环境变量不提交

## API 设计
- RESTful 风格
- 使用 HTTP 状态码
- 统一响应格式：

{ success: boolean data?: any error?: { code: string, message: string } }


## Git 规范
- Commit message: Conventional Commits
- 分支: feature/*, fix/*, refactor/*
- PR 需要 Review

## 重要文件引用
- 类型定义: @/types/index.ts
- API 基础配置: @/lib/api.ts
- 主题配置: @/styles/theme.ts
- 工具函数: @/lib/utils.ts

# === AI 行为 ===
## 生成代码时
1. 遵循上述所有规范
2. 添加适当注释
3. 考虑边界条件
4. 包含错误处理
5. 生成相应测试（如果需要）

## 回答问题时
1. 简洁明了
2. 提供代码示例
3. 解释原理
4. 指出潜在问题

## 重构代码时
1. 保持功能不变
2. 提升代码质量
3. 添加测试
4. 更新文档

# === 禁止事项 ===
- ❌ 不要生成 console.log（使用项目 logger）
- ❌ 不要使用 any 类型
- ❌ 不要忽略错误处理
- ❌ 不要生成未经验证的用户输入处理
- ❌ 不要硬编码敏感信息
- ❌ 不要生成过时的 API 用法

使用规则

生效范围:
1. Chat 对话
2. Inline Edit
3. Composer
4. 代码生成

优先级:
.cursorrules (项目) > .cursor/rules (全局) > 默认规则

🔑 API 设置

使用内置额度

免费额度:
- 每月 500 次请求
- 使用 Claude 3.5 Sonnet

优点:
- 开箱即用
- 无需配置

缺点:
- 额度有限
- 可能限速

使用自己的 API Key

步骤1: 获取 API Key

1. 访问 https://console.anthropic.com
2. 注册/登录
3. 创建 API Key
4. 复制 Key

步骤2: 配置 Cursor

Settings → Models → API Keys → Add API Key

粘贴你的 Key:
sk-ant-api03-xxxxxxxxxxxxx...

步骤3: 充值（如需）

访问 Anthropic Console:
1. Billing → Add Credits
2. 推荐充值: $20（够用很久）
3. 按使用量付费

API 使用优化

// 节省 API 调用
{
  "claude.caching": true,  // 启用缓存
  "claude.streaming": true,  // 流式响应
  "claude.retryOnError": true,  // 错误重试
  "claude.timeout": 30000  // 超时设置（毫秒）
}

📁 项目级配置

项目配置文件

.cursor/
├── mcp.json          # MCP Server 配置
├── skills.json       # Skills 配置
├── prompts/          # Prompt 模板
└── config.json       # 其他配置

MCP 配置

// .cursor/mcp.json

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "filesystem": {
      "command": "node",
      "args": ["./scripts/mcp-server-filesystem.js"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Skills 配置

// .cursor/skills.json

{
  "skills": [
    {
      "name": "deploy",
      "description": "Deploy to production",
      "command": "npm run deploy:prod",
      "confirmBefore": true
    },
    {
      "name": "test",
      "description": "Run all tests",
      "command": "npm test",
      "confirmBefore": false
    },
    {
      "name": "lint-fix",
      "description": "Fix linting issues",
      "command": "npm run lint:fix",
      "confirmBefore": false
    }
  ]
}

Prompt 模板

// .cursor/prompts/component.txt

创建 React 组件：{{name}}

技术要求：
- TypeScript + React 18
- 函数式组件
- Props 接口定义
- 默认导出

参考风格：
@shared/components/Button.tsx

Props：
{{props}}

功能：
{{functionality}}

使用:

Cmd + L → /prompt component 
  name=UserCard 
  props="user: User" 
  functionality="显示用户信息"

🚀 性能优化

1. 上下文优化

{
  "claude.contextWindow": {
    "maxFiles": 20,  // 最多引用文件数
    "maxFileSize": 100000,  // 最大文件大小 (字节)
    "excludePatterns": [
      "**/*.test.ts",
      "**/*.spec.ts",
      "**/dist/**",
      "**/build/**"
    ]
  }
}

2. 缓存策略

{
  "claude.cache": {
    "enabled": true,
    "ttl": 3600,  // 缓存时间（秒）
    "maxSize": 100  // 最大缓存条目
  }
}

3. 并发控制

{
  "claude.concurrency": {
    "maxConcurrent": 3,  // 最大并发请求
    "queueSize": 10  // 队列大小
  }
}

4. 网络优化

{
  "claude.network": {
    "timeout": 30000,  // 请求超时
    "retries": 3,  // 重试次数
    "retryDelay": 1000,  // 重试延迟
    "proxy": ""  // 代理设置（如需）
  }
}

🎨 主题和外观

推荐主题

Code 主题:
- GitHub Dark/Light
- Dracula
- One Dark Pro
- Material Theme

文件图标:
- Material Icon Theme
- VSCode Icons
- Atom Material Icons

Chat 界面定制

{
  "cursor.chat": {
    "fontSize": 14,
    "fontFamily": "SF Pro Display, -apple-system",
    "codeBlockTheme": "github-dark",
    "showLineNumbers": true,
    "wordWrap": true,
    "maxHeight": 600
  }
}

🔧 高级配置

1. 自定义键绑定

// keybindings.json

[
  {
    "key": "cmd+shift+a",
    "command": "cursor.chat.focus",
    "when": "editorTextFocus"
  },
  {
    "key": "cmd+shift+x",
    "command": "cursor.composer.toggle"
  },
  {
    "key": "cmd+alt+t",
    "command": "cursor.generateTests"
  }
]

2. Workspace 配置

// .vscode/settings.json (项目特定)

{
  "claude.model": "claude-3-5-sonnet-20241022",
  "claude.temperature": 0.5,  // 项目特定温度
  "cursor.rulesFile": ".cursorrules",
  "cursor.mcpConfigFile": ".cursor/mcp.json"
}

3. 团队共享配置

.vscode/
├── settings.json      # 团队共享设置
├── extensions.json    # 推荐扩展
└── tasks.json         # 任务配置

.cursorrules           # AI 规则（共享）
.cursor/
└── prompts/           # Prompt 模板（共享）

.gitignore 中排除:
.cursor/mcp.json       # MCP 配置（私有，含密钥）

4. 多项目配置管理

# 全局配置目录
~/.cursor/
├── global-rules.txt
├── templates/
│   ├── react/
│   ├── vue/
│   └── node/
└── mcp/
    ├── development.json
    └── production.json

# 使用
ln -s ~/.cursor/templates/react/.cursorrules .cursorrules

📊 监控和日志

启用详细日志

{
  "claude.logging": {
    "level": "debug",  // error | warn | info | debug
    "outputFile": "~/.cursor/logs/claude.log",
    "maxFileSize": 10485760,  // 10MB
    "maxFiles": 5
  }
}

查看日志

方法1: 命令面板
Cmd+Shift+P → "View Claude Logs"

方法2: 文件
cat ~/.cursor/logs/claude.log

方法3: 实时监控
tail -f ~/.cursor/logs/claude.log

使用统计

查看使用情况:
Settings → Usage

显示:
- 今日/本月请求数
- Tokens 使用量
- 费用统计
- 响应时间分布

✅ 配置检查清单

基础配置

  • [ ] 选择合适的 AI 模型
  • [ ] 设置 Temperature
  • [ ] 配置自动保存
  • [ ] 设置代码格式化

项目配置

  • [ ] 创建 .cursorrules
  • [ ] 配置 MCP Servers（如需）
  • [ ] 设置 Prompt 模板
  • [ ] 排除不必要的文件

性能优化

  • [ ] 启用缓存
  • [ ] 优化上下文大小
  • [ ] 配置并发控制
  • [ ] 设置合理的超时

团队协作

  • [ ] 共享 .cursorrules
  • [ ] 统一编辑器配置
  • [ ] 创建 Prompt 模板库
  • [ ] 文档化配置说明

🎯 配置建议

个人开发者

推荐配置:
- Model: Claude 3.5 Sonnet
- Temperature: 0.7
- Max Tokens: 4096
- 自己的 API Key (更稳定)
- 启用所有优化

小团队

推荐配置:
- 统一 .cursorrules
- 共享 Prompt 模板
- 使用团队 API Key
- 设置代码规范
- 建立最佳实践文档

企业团队

推荐配置:
- 严格的 .cursorrules
- 安全审计规则
- 自托管 MCP Servers
- 详细日志记录
- 使用统计和监控
- 合规性检查

📚 配置示例

完整的项目配置

my-project/
├── .cursorrules          # AI 规则
├── .cursor/
│   ├── mcp.json          # MCP 配置
│   ├── skills.json       # Skills
│   └── prompts/          # 模板
├── .vscode/
│   ├── settings.json     # VS Code 设置
│   └── extensions.json   # 推荐扩展
├── .eslintrc.js          # Linter
├── .prettierrc           # Formatter
└── tsconfig.json         # TypeScript

参考: https://github.com/examples/cursor-config

💡 配置技巧

1. 环境特定配置

开发环境: .cursorrules.dev
生产环境: .cursorrules.prod

使用:
ln -sf .cursorrules.dev .cursorrules

2. 配置继承

# .cursorrules
@import "./rules/typescript.txt"
@import "./rules/react.txt"
@import "./rules/security.txt"

# 项目特定规则
...

3. 动态配置

# 根据项目类型选择配置
./scripts/setup-cursor.sh --type=react
./scripts/setup-cursor.sh --type=vue
./scripts/setup-cursor.sh --type=node

🆘 配置疑难解答

配置不生效

1. 检查文件路径
2. 重启 Cursor
3. 清除缓存: Cmd+Shift+P → "Reload Window"
4. 检查语法错误
5. 查看日志

性能问题

1. 减少上下文文件数量
2. 排除大文件和目录
3. 降低并发数
4. 启用缓存
5. 使用更快的模型（临时）

MCP 连接问题

1. 检查 command 路径
2. 验证环境变量
3. 测试手动运行
4. 查看 MCP 日志
5. 检查网络连接

📚 延伸阅读

⚙️ 好的配置是高效的基础

投入时间优化配置，长期收益巨大！

🎉 恭喜！你已完成 Claude Code 完整教程！

现在开始实践，成为 AI 辅助编程专家！

"Configuration is an investment, not an expense."

最近更新:
Contributors: wsyx