Claude使用技巧

CLAUDE 使用技巧方法汇总 更高效率输出。

---

一、CLAUDE.md

概述

随着代码库规模扩大，模块依赖关系、特定领域编码模式及团队内部约定难以直观展示，导致每次对话均需重复解释架构、测试要求及代码风格偏好。

CLAUDE.md 作为 Claude Code 的"项目说明书"，记录项目核心信息，形成持久上下文记忆，每次对话自动加载。

1.1 文件定义

CLAUDE.md 是 Claude Code 的项目备忘录，位于代码仓库中的配置文件，用于说明项目组织方式、约定、规范及开发流程。

1.2 存放位置

• 常规项目：仓库根目录，团队共享

• Monorepo：父级目录

• 用户主目录：跨项目生效

1.3 示例文件

 （示例代码）
   # Project Context

   When working with this Code base, prioritize readability over cleverness. Ask clarifying questions before making architectural changes.

   ## About This Project

   FastAPI REST API for user authentication and profiles. Uses SQLAlchemy for database operations and Pydantic for validation.

   ## Key Directories

   - `app/models/` - database models
   - `app/api/` - route handlers
   - `app/core/` - configuration and utilities

   ## Standards

   - Type hints required on all functions
   - pytest for testing (fixtures in `tests/conftest.py`)
   - PEP 8 with 100 character lines

   ## Common Commands
   ```bash
   uvicorn app.main:app --reload  # dev server
   pytest tests/ -v               # run tests
   ```

   ## Notes

   All routes use `/api/v1` prefix. JWT tokens expire after 24 hours.

init初始化

（示例代码）

cd your-project

claude

/init

Claude Code 扫描代码库，读取包管理文件、项目文档、配置文件及目录结构，生成初版 CLAUDE.md，包含构建/运行命令、测试说明、关键目录及编码规范。

注意事项

/init 生成的文件不可直接作为最终版本。自动生成内容可捕捉项目骨架，但缺少团队工作流细节，需仔细核对并调整。

若项目已有 CLAUDE.md，/init 命令对比现有文件与代码库最新变化，提供优化建议。

优化步骤

（1）检查准确性：确保推断信息正确

（2）补充细节：加入 Claude Code 无法推断的工作流，如分支命名规范、部署流程、代码审查要求

（3）精简内容：删除不适合当前项目的通用指导

（4）纳入版本控制：提交最终版文件，团队共享

/init 命令核心作用为搭建基础框架，CLAUDE.md 真正价值在于持续迭代完善。使用 # 键记录重复性操作指南，逐步打磨成匹配团队运作模式的专属配置。

构建 CLAUDE.md

在 CLAUDE.md 中加入简洁项目说明和清晰目录树，帮助 Claude Code 快速建立认知模型。

（示例代码）

main.py

├── docs

├── config

├── modules

├── tools

├── rules

├── tests

└── data

项目地图中可加入主要依赖、架构模式及"非标准"组织方式，使 Claude Code 准确判断代码归属及修改位置。

运行环境

部署脚本、测试脚本、代码生成器、数据处理脚本等常用工具可写入 CLAUDE.md，建议包含：

• 工具名称与用途

• 基础使用方法（命令格式、关键参数）

• 典型调用场景

• 是否支持 --help 获取帮助

MCP 工具配置

MCP 配置方式：

• 项目设置

• 全局设置

• 仓库中的 .mcp.json 文件

MCP 工具未正常显示时，可用 --mcp-debug 排查异常。

Slack MCP 配置示例：

 （示例代码）
   ### Slack MCP
   - Posts to #dev-notifications channel only
   - Use for deployment notifications and build failures
   - Do not use for individual PR updates (those go through GitHub webhooks)
   - Rate limited to 10 messages per hour

标准工作流定义

在 CLAUDE.md 中针对不同任务类型定好标准工作流，确保 Claude Code 动手前"想清楚"，明确以下问题：

（1）是否需调研当前代码现状？

（2）是否需先制定详细实现方案？

（3）当前信息是否充分？缺失哪些关键内容？

（4）完成后如何验证？确保方案有效性？

工作流可根据任务类型灵活定制：

• 功能开发："调研-规划-编码-提交"流程

• 算法开发："测试驱动开发"（TDD）模式

• UI 迭代："视觉原型迭代"流程

工作流指令示例：

 （示例代码）
   1) Before modifying Code  in the following locations: X, Y, Z
         - Consider how it might affect A, B, C
         - Construct an implementation plan
         - Develop a test plan that will validate the following functions...

渐进式完善原则

（1）先写最关键内容：项目结构、构建/运行命令、常用脚本示例

（2）辅助信息拆分为独立 Markdown 文件（如 testing.md、deploy.md、.claude/commands/*），CLAUDE.md 中引用

（3）随使用痛点逐步补充，文件随团队实践自然成长

CLAUDE.md 提交至仓库与团队共享。切勿写入敏感凭证，包括 API Key、数据库连接字符串、私有证书或安全漏洞详细信息。

CLAUDE.md 核心价值

CLAUDE.md 核心价值是将 Claude Code 从通用助手转变为代码库的定制版工具。

从简单开始，逐步演进。根据实际工作流痛点不断丰富内容，做到：

（1）固化重复输入的命令、检查点和上下文

（2）捕捉难以口述说明的架构与约定

（3）明确工作流，使 Claude Code 动手前按团队流程思考，减少返工

CLAUDE.md 真正价值在于"持续进化"。软件项目非静止状态：业务迭代新增模块，团队磨合沉淀高效协作模式，新工具融入工作流，这些变化均需同步更新至 CLAUDE.md。

总结：优质 CLAUDE.md 非写出来，而用出来。无需完美格式，仅需解决真问题；无需追随理论，仅需贴合团队 最终与代码库共同成长，成为项目组成部分。

Claude Code

保持上下文清洁

切换任务时使用 /clear 命令重置上下文。命令清除历史记录但保留 CLAUDE.md 配置，开启全新会话，避免旧内容干扰。

使用 Sub-agent 隔离阶段

复杂任务需多分析视角时，可让 Claude Code 启动 Sub-agent 处理新阶段分析。Sub-agent 拥有独立上下文，为该步骤开启全新干净工作空间，使不同分析阶段互不干扰。

创建高频任务自定义命令

将常用提示写入 .claude/commands/ 目录下 markdown 文件，作为自定义斜杠命令调用。

二、编写 SKILL

• Skills 是模型自动调用的,Claude 会根据你的请求和 Skill 的描述自主决定何时使用它们

• 采用渐进式披露原则,Claude 在启动时只预加载每个已安装 Skill 的名称和描述,仅在需要时才加载完整内容

• 支持跨平台使用,可在 Claude.ai、API 和 Claude Code 中使用

• 可以包含可执行代码,适用于传统编程比生成 token 更可靠的任务

Anthropic 提供了多个预构建的文档处理 Skills,包括 docx(Word 文档)、pdf(PDF 处理)、 pptx(PowerPoint 演示文稿)和 xlsx(Excel 电子表格)

用户skills:

适用于个人工作流程、实验性 Skills 和个人生产力工具

~/.claude/skills/

项目 Skills

目录,与团队共享,适用于团队工作流程、项目特定专业知识和共享工具

.claude/skills/

基本结构:

---
name: your-skill-name
description: 简要描述该 Skill 的功能以及何时使用
---# Skill 名称## 说明
为 Claude 提供清晰的分步指导

## 示例
展示使用该 Skill 的具体示例

name 字段必须仅使用小写字母、数字和连字符,最多 64 个字符;description 字段是关键,最多 1024 个字符,需要包含 Skill 的功能和使用时机

添加辅助文件

可以添加以下内容:

• 脚本文件(Python、JavaScript 等)

• 模板文件

• 参考文档

• 示例数据

测试 Skill

创建 Skill 后,通过提出与描述相匹配的问题来测试它

检查文件路径:

安装和使用 Skills

# 从市场安装
/plugin marketplace add anthropics/skills

# 从本地目录安装
/plugin add /path/to/skill-directory

与团队共享

• 将 Skills 添加到插件的 skills/ 目录

• 将插件添加到市场

• 团队成员安装插件