让Claude code教你一键学会Claude code

Hello，朋友们，又见面了。

很多身边的朋友在学Claude code，但是官方文档其实很多人不怎么看。

放在以前，我也不看，谁没事去看英文文档啊~

但是现在，CC的开发辅助能力比较强大，所以我也大概翻了一下，操作了其中的案例，希望对大家有所帮助。

接下来我会带着大家边实操+案例，逐步掌握Claude code的使用流程。

实际上操作Claude code过程中，需要遵循代码开发的流程，有一些提问的技巧。

本部分包括：每个阶段的任务说明、指令示范、最佳实践等。

第一阶段：入门与代码库理解

理解新的代码库/项目代码

CC新用户在接触一个新的项目时候，通常都很懵逼。

这玩意一个黑窗口，我咋用？？？

所以很多朋友就弃用CC了，其实并不难，掌握正确的使用方法即可。

比如，刚刚入职某节的员工，加入一个新项目组，需要快速了解现有代码库时，可以利用 Claude Code 的概览和探索功能。

提示：

• 从宽泛的问题开始，然后缩小到特定领域
• 询问项目中使用的编码约定和模式
• 请求项目特定术语的词汇表

1. 导航到项目根目录

cd /path/to/project 

1. 启动 Claude Code

claude 

1. 请求高层次概览

这部分主要是了解新的代码库主要是干嘛的，包括核心功能、技术架构、项目结构等。

> give me an overview of this codebase 

以GitHub代码库 https://github.com/hanshuaikang/AI-Media2Doc 为例，首先预览整个代码库

1. 深入了解特定组件

如上涉及的特定组件如何深挖？

比如你想快速了解这个项目架构是怎么样的，数据模型是怎么做的，登陆验证是怎么做的，只要涉及整个项目的，都可以提问。

示例提问：

> explain the main architecture patterns used here 

> what are the key data models?

> how is authentication handled?

针对我们选择的GitHub项目，进行深入了解特定组件，可以这样问：音视频转文档的这部分功能设计是怎么样的？

查找相关代码

接手一个新项目过程中，其中一个模块我不太懂，于是就需要定位与特定功能或功能相关的代码。

提示：

• 对要查找的内容要具体（涉及到概念名词，需要准确）
• 使用项目中的领域语言（前端、后端、数据库、登陆验证等）

1. 可以用自然语言命令，让 Claude帮你查找相关文件

> find the files that handle user authentication 

前面已经介绍了，音视频转文档分为三层，前端、音视频处理、后端服务，小白都可以看懂。

接下来我想找到处理ASR服务和LLM文档生成的文件

1. 找到了相关的组件，接下来了解组件是如何交互

> how do these authentication files work together? 

1. 想要理解一个流程是怎么跑起来的，这样问

> trace the login process from front-end to database 

第二阶段：日常开发任务

高效修复错误

新手在run项目的时候，往往会遇到各种error，要么是环境问题，要么是网络bug等等，如果遇到了错误消息，就需要找到并修复其源头。

放在以前，还得打开浏览器，搜CSDN和各种帖子去看怎么解决，运气好能一下子找到，运气不好就难说。

现在其实就能用CC直接帮你解决错误问题。

提示：

• 告诉 Claude 重现问题的命令并获取堆栈跟踪
• 提及重现错误的任何步骤
• 让 Claude 知道错误是间歇性的还是一致的

1. 与 Claude 分享错误

> I'm seeing an error when I run npm test 

1. 请求修复建议

> suggest a few ways to fix the @ts-ignore in user.ts

1. 应用修复

> update user.ts to add the null check you suggested

重构代码

一些传统的国企央企，会用旧的Java框架以及老掉牙的版本，迭代更新是大问题，并且还不能完全更新，更新旧代码过程中，使用现代模式和实践往往会遇到很多问题。

现在倒是可以使用CC解决这类问题，有一些技巧：

• 让 Claude 解释现代方法的好处
• 在需要时请求更改保持向后兼容性
• 以小的、可测试的增量进行重构

1. 识别需要重构的遗留代码

> find deprecated API usage in our codebase 

1. 获取重构建议

> suggest how to refactor utils.js to use modern JavaScript features

1. 安全地应用更改

> refactor utils.js to use ES2024 features while maintaining the same behavior 

1. 验证重构

> run tests for the refactored code

处理测试

测试这块，严格来说是测试工程师干的话，但是目前大环境下，实习生都得干，毕竟你不干有的是人干。

如果用CC的话，参考：

• 请求涵盖边缘情况和错误条件的测试
• 在适当时请求单元测试和集成测试
• 让 Claude 解释测试策略

1. 识别未测试的代码

> find functions in NotificationsService.swift that are not covered by tests 

2生成测试脚手架

> add tests for the notification service 

3添加有意义的测试用例

> add test cases for edge conditions in the notification service 

4运行并验证测试

> run the new tests and fix any failures 

处理文档

在与CC交互过程中，可能会引用相关文档，或者为项目添加或更新文档，

不同于cursor，在cursor里面还有快捷指令提供选择，很方便就能在整个项目里面搜索到文件。

这里的CC使用技巧值得一看：

• 指定您想要的文档样式（JSDoc、docstrings 等）
• 在文档中请求示例
• 为公共 API、接口和复杂逻辑请求文档

1. 识别未文档化的代码

> find functions without proper JSDoc comments in the auth module 

1. 生成文档

> add JSDoc comments to the undocumented functions in auth.js 

1. 审查和增强

> improve the generated documentation with more context and examples 

1. 验证文档

> check if the documentation follows our project standards 

第三阶段：高级功能与协作

使用专门的子Agent

其实很多任务单靠一个agent解决不了实际大的问题。

所以cc里面支持了subagent，就是你可以拉起一个AI开发团队，里面成员的功能职责全是有你来定，然后你的领导给你来了任务，交给他，不同AI员工进行响应，直接互相协同，这样你摸鱼的时间更长了，效率提高，年终奖更多了。

如果想使用专门的 AI 子agent来更有效地处理特定任务。

参考如下使用方法：

• 在 .claude/agents/ 中创建项目特定的子代理以供团队共享
• 使用描述性的 description 字段来启用自动委托
• 将工具访问限制为每个子代理实际需要的内容
• 查看子代理文档获取详细示例

1. 查看可用的子代理

> /agents

这显示所有可用的子代理并让您创建新的子代理。 2. 自动使用子代理 Claude Code 将自动将适当的任务委托给专门的子代理：

> review my recent code changes for security issues
> run all tests and fix any failures

1. 明确请求特定子代理

> use the code-reviewer subagent to check the auth module
> have the debugger subagent investigate why users can't log in

1. 为您的工作流程创建自定义子代理

> /agents

然后选择”Create New subagent”并按照提示定义：

• 子代理类型（例如，api-designer、performance-optimizer）
• 何时使用它
• 它可以访问哪些工具
• 其专门的系统提示

创建拉取请求

什么是拉取请求？

其实是代码测试&合并方面的知识，就是你以及修改了代码的部分，需要将其合并到项目组的分支里面（一般大厂里面会有git的不同链路，比如dev、test这种）

可以参考如下的使用方法。

1. 总结您的更改

> summarize the changes I've made to the authentication module 

1. 使用 Claude 生成 PR

> create a pr 

1. 审查和完善

> enhance the PR description with more context about the security improvements 

1. 添加测试详情

> add information about how these changes were tested 

处理图像

这里需要注意的是，Claude code原生是Claude系列模型，原本是多模态的，如果使用kimi-k2或者GLM-4.5等其他夺舍版，处理图像功能不可用。

如果需要在代码库中处理图像，并希望 Claude 帮助分析图像内容，可以使用这个方法。

使用技巧：

• 当文本描述不清楚或繁琐时使用图像
• 包含错误截图、UI 设计或图表以获得更好的上下文
• 您可以在对话中处理多个图像
• 图像分析适用于图表、截图、模型等 注意：claude是多模态模型，截止8月6日，kimi-k2和GLM-4.5目前均不支持多模态

1. 向对话怎么添加图像

• 你可以将图像拖放到 Claude Code 窗口中
• 或者复制图像并使用 ctrl+v 粘贴到 CLI 中（不要使用 cmd+v）
• 向 Claude 提供图像路径。例如，“Analyze this image: /path/to/your/image.png”

1. 让 Claude 分析图像

> What does this image show?

> Describe the UI elements in this screenshot

1. 使用图像作为上下文

> This is our current database schema. How should we modify it for the new feature?

1. 从视觉内容获取代码建议

> Generate CSS to match this design mockup

> What HTML structure would recreate this component?

引用文件和目录

这里提一下cursor的引用文件和目录功能，

在CC里面，可以使用 @ 快速唤起文件或目录，不需要等待 Claude 读取它们。

使用必须要注意：

• 文件路径可以是相对的或绝对路径
• @ 文件引用将文件目录和父目录中的 CLAUDE.md 添加到上下文中
• 目录引用显示文件列表，而不是内容
• 可以在单个消息中引用多个文件（例如，“@file1.js and @file2.js”）

1. 引用单个文件

> Explain the logic in @src/utils/auth.js

这将文件的完整内容包含在对话中。 2. 引用目录

> What's the structure of @src/components?

这提供带有文件信息的目录列表。 3. 引用 MCP 资源

> Show me the data from @github:repos/owner/repo/issues

这使用格式 @server:resource 从连接的 MCP 服务器获取数据。 实例：

 Explain the logic in @xxx

What's the structure of @xxx

使用扩展思考

一般简单的问题CC可以轻松解决，遇到复杂的问题，也不能怪CC不够智能，还是需要一定的方法，这种处理复杂的架构决策、具有挑战性的错误或需要深度推理的多步骤实现规划。

扩展思考对复杂任务最有价值，例如：

• 规划复杂的架构更改
• 调试复杂问题
• 为新功能创建实现计划
• 理解复杂的代码库
• 评估不同方法之间的权衡

提示思考的方式会导致不同深度的思考：

• “think” 触发基本扩展思考
• 强化短语如 “think more”、“think a lot”、“think harder” 或 “think longer” 触发更深层的思考

1. 提供上下文并让 Claude 思考

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase.

Claude 将从代码库收集相关信息并使用扩展思考，这将在界面中可见。

1. 通过后续提示完善思考

> think about potential security vulnerabilities in this approach 
> think harder about edge cases we should handle 

恢复之前的对话

最常见的情况是，昨天晚上你刚用完Claude code,第二天需要重新启动，怎么找回之前的聊天记录？？？

Claude Code 就提供两个恢复之前对话的选项：

提示：

• 对话历史存储在机器本地，使用 --continue 快速访问最近的对话

# 继续最近的对话
claude --continue

# 使用特定提示继续最近的对话
claude --continue --print "Show me our progress"

# 在非交互模式下继续最近的对话
claude --continue --print "Run the tests again"

• 需要选择特定的过去对话时使用 --resume

# 显示对话选择器
claude --resume

这显示一个交互式对话选择器，显示：对话开始时间、初始提示或对话摘要、消息计数。使用箭头键导航并按 Enter 选择对话。

• 恢复时，将在继续之前看到整个对话历史；恢复的对话以与原始对话相同的模型和配置开始

工作原理：

1. 对话存储：所有对话都自动保存在本地，包含完整的消息历史
2. 消息反序列化：恢复时，整个消息历史被恢复以保持上下文
3. 工具状态：之前对话中的工具使用和结果得到保留
4. 上下文恢复：对话恢复时保持所有之前的上下文完整

使用 Git 运行并行 Claude Code 会话

如果用户需要同时处理多个任务，并在 Claude Code 实例之间完全隔离代码，互补产生交集，这部分值得一看。

1. 了解 Git worktrees

Git worktrees 允许将同一存储库的多个分支检出到单独的目录中。每个 worktree 都有自己的工作目录和隔离的文件，同时共享相同的 Git 历史。

1. 创建新的 worktre

# 使用新分支创建新的 worktree
git worktree add ../project-feature-a -b feature-a
# 或使用现有分支创建 worktree
git worktree add ../project-bugfix bugfix-123

这创建一个新目录，其中包含您存储库的单独工作副本。

1. 在每个 worktree 中运行 Claude Code

# 导航到您的 worktree
cd ../project-feature-a
# 在这个隔离环境中运行 Claude Code
claude

1. 在另一个 worktree 中运行 Claude

cd ../project-bugfixclaude

1. 管理所有的 worktrees

# 列出所有 
worktreesgit worktree list
# 完成后删除 
worktreegit worktree remove ../project-feature-a

第四阶段：集成与自定义

将 Claude 添加到验证过程

这部分其实是最终代码提交过程时候，需要进行代码审查，防止出现注入等漏洞，就可以将 Claude Code 用作 linter 或代码审查器。

你可以这样使用：

• 在 CI/CD 管道中使用 Claude 进行自动化代码审查
• 自定义提示以检查与您的项目相关的特定问题
• 考虑为不同类型的验证创建多个脚本

将 Claude 添加到构建脚本：

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

管道输入，管道输出

程序员可以很方便的将CC与终端命令进行结合，比如用户可以将数据管道输入 Claude，并以结构化格式获取数据。

你可以这样使用：

• 使用管道将 Claude 集成到现有的 shell 脚本中
• 与其他 Unix 工具结合使用以实现强大的工作流程
• 考虑使用 —output-format 进行结构化输出

通过 Claude 管道数据：

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

控制输出格式

如果像让Claude 的输出采用特定格式，特别是在将 Claude Code 集成到脚本或其他工具中时。

参考如下使用方法：

• 对于只需要 Claude 响应的简单集成，使用 --output-format text
• 当您需要完整的对话日志时，使用 --output-format json
• 对于每个对话轮次的实时输出，使用 --output-format stream-json

1. 使用文本格式（默认）

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

只输出 Claude 的纯文本响应（默认行为）。

1. 使用 JSON 格式

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

这输出一个包含元数据（包括成本和持续时间）的消息 JSON 数组。

1. 使用流式 JSON 格式

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

这在 Claude 处理请求时实时输出一系列 JSON 对象。每个消息都是有效的 JSON 对象，但如果连接，整个输出不是有效的 JSON。

创建自定义斜杠命令

Claude Code 对于高级用户来说，支持自定义斜杠命令，可以创建这些命令来快速执行特定提示或任务。

创建项目特定的命令

假设你想为项目创建可重用的斜杠命令，所有团队成员都可以使用。

参考使用方法：

• 命令名称来自文件名（例如，optimize.md 变成 /optimize）
• 您可以在子目录中组织命令（例如，.claude/commands/frontend/component.md 创建 /component，描述中显示”(project:frontend)”）
• 项目命令对克隆存储库的每个人都可用
• Markdown 文件内容成为调用命令时发送给 Claude 的提示

1. 在项目中创建命令目录

mkdir -p .claude/commands

1. 为每个命令创建 Markdown 文件

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md 

1. 在 Claude Code 中使用您的自定义命令

> /optimize 

使用 $ARGUMENTS 添加命令参数

假设你想创建可以接受用户额外输入的灵活斜杠命令。

提示：

• $ARGUMENTS 占位符会被命令后面的任何文本替换
• 您可以在命令模板中的任何位置放置 $ARGUMENTS
• 其他应用：为特定函数生成测试用例、为组件创建文档、审查特定文件中的代码，或将内容翻译为指定语言

1. 使用 $ARGUMENTS 占位符创建命令文件

echo "Find and fix issue #$ARGUMENTS. Follow these steps: 1.Understand the issue described in the ticket 2. Locate the relevant code inour codebase 3. Implement a solution that addresses the root cause 4. Addappropriate tests 5. Prepare a concise PR description" >.claude/commands/fix-issue.md 

1. 使用带有问题编号的命令 在 Claude 会话中，使用带有参数的命令。

> /fix-issue 123

这将在提示中将 $ARGUMENTS 替换为”123”。

创建个人斜杠命令

高级用户可以创建在所有项目中都有效的个人斜杠命令，你可以自定义，把经常使用的命令放到一起。

使用技巧：

• 个人命令在使用 /help 列出时在其描述中显示”(user)”
• 个人命令只对用户可用，不与团队共享
• 个人命令在个人所有项目中都有效
• 您可以将这些用于跨不同代码库的一致工作流程

1. 在主文件夹中创建命令目录

mkdir -p ~/.claude/commands 

1. 为每个命令创建 Markdown 文件

echo "Review this code for security vulnerabilities, focusing on:" >~/.claude/commands/security-review.md

1. 使用个人自定义命令

> /security-review 

题外话：了解 Claude 自身能力

询问 Claude 关于其功能

Claude 里面内置了CC使用文档，可以回答关于其自身功能和限制的问题。

但是在使用过程中需要注意：

• Claude 始终可以访问最新的 Claude Code 文档
• 只需要提出明确、具体的问题以获得详细答案
• Claude 可以解释复杂功能，如 MCP 集成、企业配置和工作流程

> how do I use MCP with Claude Code?

> how do I configure Claude Code for Amazon Bedrock?

> what are the limitations of Claude Code?

写在最后

有一些基础的代码能力，对CC上手还是比较轻松一点的。

但是到了高级阶段，做各种大型项目，还是程序员的天下，高级程序员还没有到被淘汰的阶段，只能说，越老越吃香（35岁之前）.

国内的模型能力还是得能力，啥时候能都支持多模态啊。