Claude Code

Appearance

快速开始 ​

本指南将帮助您快速设置和使用 Claude Code。

安装配置 ​

1. 基础配置 ​

Claude Code 使用两个配置文件：

全局配置 (settings.json) ​

json
{
  "permissions": {
    "file_operations": true,
    "code_analysis": true,
    "git_operations": true
  },
  "cleanup": {
    "auto_cleanup": true,
    "retention_days": 30
  }
}

个人配置 (settings.local.json) ​

json
{
  "permissions": {
    "flutter_development": true,
    "nodejs_development": true,
    "docker_operations": true,
    "kubernetes_operations": true
  }
}

2. 项目文档创建 ​

为您的项目创建 CLAUDE.md 文件：

markdown
# Claude Code Entry Point

@COMMANDS.md
@FLAGS.md
@PRINCIPLES.md
@RULES.md
@MCP.md
@PERSONAS.md
@ORCHESTRATOR.md
@MODES.md
@GRAPHITI.md
@BASIC.md

交互模式 ​

启动 Claude Code 进入交互模式：

bash
claude

在交互模式中，您可以：

  • 直接对话交流
  • 使用斜杠命令
  • 切换不同代理
  • 查看执行历史

命令行模式 ​

bash
# 直接提问
claude "如何优化这个函数的性能？"

# 使用项目上下文
claude -p "分析当前项目的架构问题"

# 继续上次对话
claude -c

# 管道输入
cat main.dart | claude -p "检查这段代码的问题"

斜杠命令 ​

在交互模式或命令行中使用斜杠命令：

bash
# 构建项目
/build flutter

# 分析代码
/analyze @lib/main.dart

# 改进代码
/improve --performance @lib/utils.dart

# 设计功能
/design "用户认证系统"

代理使用 ​

自动激活 ​

Claude Code 会根据上下文自动选择合适的代理：

  • 谈论新功能 → 自动激活规划师
  • 项目初始化 → 自动激活架构师
  • 代码实现 → 自动激活执行器
  • 代码审查 → 自动激活审查员
  • 问题调试 → 自动激活调试器
  • 文档编写 → 自动激活撰写员

手动切换 ​

您也可以手动指定代理：

bash
# 使用规划师规划新功能
claude --agent=planner "我需要添加用户认证功能"

# 使用架构师分析项目
claude --agent=architect "分析项目结构并生成文档"

# 使用执行器实现功能
claude --agent=executor "实现登录API接口"

高级配置 ​

MCP 服务配置 ​

启用特定的 MCP 服务：

bash
# 启用 Context7 服务（文档查询）
claude --mcp=context7 "Flutter 状态管理最佳实践"

# 启用 Sequential 服务（复杂分析）
claude --mcp=sequential "分析这个复杂的性能问题"

# 启用多个服务
claude --mcp=context7,sequential,magic "设计一个高性能的Flutter应用"

Wave 系统 ​

对于复杂任务，Wave 系统会自动激活：

bash
# 复杂项目分析（自动启用 Wave）
/analyze --deep @.

# 大规模重构（自动启用 Wave）
/improve --refactor @lib/

项目导向文件 ​

为更好的AI理解，创建 .ai-rules/ 目录：

.ai-rules/
├── product.md     # 产品愿景和功能
├── tech.md        # 技术栈说明
└── structure.md   # 项目结构约定

product.md 示例 ​

yaml
---
title: "Flutter电商应用"
description: "跨平台移动电商解决方案"
include_in_context: true
---

# 产品概述
移动优先的电商平台，支持商品浏览、购物车、支付等功能。

## 核心功能
- 用户认证和个人资料
- 商品展示和搜索
- 购物车和订单管理
- 支付集成
- 推送通知

tech.md 示例 ​

yaml
---
title: "技术栈文档"
description: "项目使用的技术和工具"
include_in_context: true
---

# 技术栈

## 前端
- Flutter 3.x
- Dart 3.x
- Provider (状态管理)
- HTTP (网络请求)

## 后端
- Node.js + Express
- PostgreSQL
- Redis (缓存)
- JWT (认证)

## 工具
- Docker (容器化)
- GitHub Actions (CI/CD)

最佳实践 ​

1. 明确任务目标 ​

bash
# 模糊的请求
claude "优化代码"

# 明确的请求
claude "优化 lib/api/user_service.dart 中的网络请求性能，减少响应时间"

2. 提供足够上下文 ​

bash
# 缺少上下文
claude "这个错误怎么解决？"

# 提供完整上下文
claude "@lib/main.dart 启动时出现 'RenderFlex overflow' 错误，如何修复？"

3. 合理使用代理 ​

  • 规划阶段: 使用规划师制定详细计划
  • 实现阶段: 使用执行器进行编码
  • 质量阶段: 使用审查员检查代码
  • 问题阶段: 使用调试器解决问题

4. 利用命令系统 ​

bash
# 系统化的开发流程
/design "新功能设计"      # 设计阶段
/build --implement       # 实现阶段
/analyze --quality      # 质量检查
/improve --optimize     # 优化改进

常见问题 ​

Q: 代理没有自动激活？ ​

A: 确保您的请求明确表达了意图，或手动指定代理：

bash
claude --agent=executor "实现用户登录功能"

Q: MCP 服务连接失败？ ​

A: 检查服务状态并重启：

bash
# 检查 MCP 服务
claude mcp list

下一步 ​

现在您已经掌握了基础使用方法，建议深入了解：

有问题？查看 故障排除指南 或 联系支持

Claude Code 使用指南

Copyright © 2025