☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Claude Code 是 Anthropic 推出的智能编程助手，直接集成到终端环境中，能够理解代码库并通过自然语言命令帮助编程。

本文从实践者的角度，系统分享 Claude Code 的最佳实践和使用技巧。

1️⃣ 初始化配置 ​ ​

1.1 安装 Claude Code ​ ​

# 全局安装

npm install -g @anthropic-ai/claude-code

# 验证安装

claude --version

1.2 创建 CLAUDE.md 文件 ​ ​

CLAUDE.md 是 Claude Code 的核心配置文件，会被自动读取并加入到上下文中。

文件内容应包含： ​ ​

• 项目基础信息和架构说明
• 常用命令和构建脚本
• 代码规范和约定
• 测试指南
• 开发环境配置
• 其他必要的上下文信息（可通过 @path/to/import 来引用项目文件）

创建方式： ​ ​

# 使用 /init 命令自动生成

claude> /init

# 或者手动创建并填充内容

touch CLAUDE.md

文件位置优先级： ​ ​

• 项目根目录：./CLAUDE.md（推荐，可提交到 git）
• 项目本地：./CLAUDE.local.md（不提交到 git）
• 全局配置：~/.claude/CLAUDE.md
• 父目录和子目录中也会被自动读取

1.3 配置工具权限 ​ ​

Claude Code 默认采用保守的权限策略。可以通过四种方式显式授权：

1. 启动时的交互式授权提示
2. 运行 /permissions 命令
3. 手动编辑 .claude/settings.json
4. 启动参数 --allowedTools

# 使用 /permissions 命令管理权限

> /permissions

# 或者通过命令行参数

claude --allowedTools Edit,Bash(git commit:*)

推荐允许的工具： ​ ​

• Edit: 文件编辑
• Bash(git commit:*): Git 提交操作
• WebFetch(*): 访问 URL 网址

1.4 安装配套工具 ​ ​

推荐安装 GitHub CLI，自动化 GitHub 工作流：

# 安装 GitHub CLI

brew install gh

# 配置 GitHub 认证

gh auth login

2️⃣ 工作流程 ​ ​

2.1 探索 - 计划 - 编程 - 提交流程 ​ ​

这是最通用的工作流程，适用于大多数开发任务：

# 1. 探索阶段 - 了解现有代码

"请阅读相关文件了解当前架构，但暂时不要编写代码"

# 2. 计划阶段 - 使用扩展思考（按两次 Shift+TAB 进入 PLAN 模式）

"请 ultrathink 并制定详细的实现计划，并指示 sub-agents 并行验证关键细节"

# 3. 编码阶段

"请按照计划实现功能"

# 4. 提交阶段

"请提交更改并创建 PR"

2.2 测试驱动开发流程 ​ ​

对于可以通过测试验证的功能：

# 1. 编写测试

"请基于期望的输入输出编写测试，确保测试会失败"

# 2. 运行测试确认失败

"运行测试确认失败，不要编写实现代码"

# 3. 提交测试

"请提交测试代码"

# 4. 实现功能

"请编写代码使测试通过，不要修改测试"

# 5. 提交实现

"请提交实现代码"

2.3 UI 开发迭代流程 ​ ​

对于前端开发：

# 1. 提供设计图

# 拖拽图片到 Claude Code 界面

# 2. 实现 UI

"请按照设计图实现界面"

# 3. 截图对比

"请截图当前实现，与设计图对比并改进"

# 4. 迭代优化

"请继续优化，直到效果满意"

3️⃣ 进阶功能和技巧 ​ ​

3.1 使用 MCP 扩展工具 ​ ​

Claude Code 支持 MCP（Model Context Protocol）来扩展功能：

Build Teams.ai Apps with Anthropic Claude

使用 @youdotcom-oss/teams-anthropic 将 Anthropic Claude 模型（Opus、Sonnet、Haiku）添加到 Microsoft Teams.ai 应用程序中。可选集成 You.com MCP 服务器以进行网页搜索和内容提取。

下载

> /issue 1234

3.3 上下文管理 ​ ​

Claude Code 的上下文窗口有限，且上下文过长会导致幻觉严重，需要合理管理：

管理策略： ​ ​

• 使用 @ 引用文件
• 任务切换时使用 /clear 清空上次任务信息
• 长时间会话定期压缩上下文
• 必要时从历史会话恢复
• 将重要信息通过 # <context></context> 记录到 CLAUDE.md 中

命令格式： ​ ​

# 使用文件引用

请参考 @src/components/UserProfile.tsx 的结构

# 压缩上下文

> /compact

# 清理上下文

> /clear

# 增加记忆

# <context>

# 恢复历史会话

/resume</context>

启动时恢复会话： ​ ​

# 续聊上次会话

claude --continue
claude --continue --print # 适合脚本调用

# 从历史会话中选择再继续

claude --resume

4️⃣ 项目组织和管理 ​ ​

4.1 使用 ROADMAP.md 管理项目 ​ ​

创建项目路线图：

# 创建新的工作树

git worktree add ../feature-branch feature/new-feature

# 在新工作树中启动 Claude Code

cd ../feature-branch
claude

# 管理多个工作树

git worktree list
git worktree remove ../feature-branch

5️⃣ 常用命令速查 ​ ​

基础命令 ​ ​

claude # 启动交互模式

claude "描述任务" # 一次性命令

claude --continue # 继续上次会话

claude --resume # 选择历史会话

交互命令 ​ ​

/init # 初始化项目配置

/permissions # 管理工具权限

/clear # 清空上下文

/compact # 压缩上下文

/resume # 恢复会话

文件操作 ​ ​

@filename # 引用文件

@folder/ # 引用目录

# <context> # 添加上下文标记</context>

自定义命令 ​ ​

/project:command-name # 项目级自定义命令

/user:command-name # 用户级自定义命令

6️⃣ 最佳实践总结 ​ ​

1. 项目初始化

   • 创建详细的 CLAUDE.md 配置文件
   • 设置合适的工具权限
   • 建立项目文档结构

2. 工作流程

   • 遵循探索-计划-编程-提交的标准流程
   • 对重要功能采用测试驱动开发
   • UI 开发采用设计图对比迭代

3. 上下文管理

   • 及时清理和压缩上下文
   • 合理使用文件引用
   • 重要信息记录到配置文件

4. 项目管理

   • 使用 ROADMAP.md 规划项目
   • 创建详细的任务模板
   • 利用 git worktree 并行开发

5. 效率提升

   • 创建常用的自定义命令
   • 配置 MCP 扩展工具
   • 结合 GitHub CLI 自动化流程

通过以上最佳实践，你将能够充分发挥 Claude Code 的强大功能，显著提升开发效率和代码质量。

---

? 提示：建议将本指南作为参考手册，在实际开发中根据项目特点调整和优化工作流程。