欢迎来到 Claude Code CLI 的世界！作为一款强大的交互式编程助手，它可以极大地提升您的软件开发效率。本指南将为您介绍一些核心的使用技巧，帮助您快速从入门到熟练。

1. 核心理念：像与真人同事协作一样

使用 Claude Code 时，最好的方式是把它当作一位聪明的初级开发同事。您需要：

  • 提供清晰的目标：明确告知它您想完成什么任务。
  • 给予上下文信息：它能自动感知您的项目结构，但关键文件的路径、代码片段等信息能让它更快定位问题。
  • 循序渐进地引导：对于复杂任务，先让它制定计划 (使用 Todo 工具)，然后一步步执行。

2. 常用命令集合

Claude Code 常用命令

  • /init：使用CLAUDE.md指南初始化项目
  • /compact [instructions]： 压缩对话，可选的焦点说明
  • /clear： 压缩对话，可选的焦点说明
  • “think” < “think hard” < “think harder” < “ultrathink”: 每个级别会逐步分配更多的思考预算供 Claude 使用.
  • !：输入!就是单独的命令行模式
  • #：输入#会把命令写入记忆中,后续Claude Code就回使用

3. 必须掌握的核心工具

Claude Code 的强大之处在于其丰富的工具集。以下是您最需要掌握的几个：

文件操作：Read, Edit, Write

  • Read: 读取文件内容。
    • 技巧：当您不确定文件具体内容时，先用 Read 查看，再进行后续操作。例如：“帮我读一下 hugo.yaml 这个文件。”
  • Write: 创建或覆盖整个文件。
    • 技巧：适用于创建新文件或内容完全重构。如果您只想修改部分内容，请优先使用 Edit。例如：“创建一个名为 new-feature.js 的文件，并写入初始代码。”
  • Edit: 对文件进行精准修改。
    • 技巧：这是最常用的工具之一。为了让它精确修改，最好先用 Read 读取文件，然后告诉它：“把第 10 行的 let 改成 const。” 或者直接提供要被替换的旧代码和新代码。

代码搜索与定位：Glob, Grep

  • Glob: 按文件名模式查找文件。
    • 技巧：当您想找某一类型或命名模式的文件时非常有用。例如：“查找所有在 src/components 目录下的 .tsx 文件。”
  • Grep: 在文件内容中搜索代码片段或文本。
    • 技巧：这是定位函数定义、变量使用或特定错误信息的利器。支持正则表达式。例如：“在整个项目中搜索 API_ENDPOINT 这个变量在哪里被定义了。”

终端命令：Bash

  • 功能：执行任意终端命令，如 git status, npm install, hugo server 等。
    • 技巧：在执行 git 操作或运行项目命令时非常方便。例如：“帮我运行 hugo server 启动开发服务器。” 或 “查看一下当前的 git 状态。”

4. 任务规划与代码探索

TodoWrite：您的任务管家

这是 Claude Code 进行复杂任务规划的核心工具。

  • 何时使用：当您的需求超过一两个步骤时，就应该让它创建一个 Todo 列表。
  • 技巧：
    • 主动要求：“我们来规划一下这个任务，请创建一个 Todo 列表。”
    • 检查进度：它会在执行过程中实时更新任务状态（pending, in_progress, completed），让您对进度一目了然。

Task (Explore Agent)：您的代码领航员

当您对项目结构不熟，或需要理解某块复杂逻辑时，Explore 子代理是最佳选择。

  • 何时使用：
    • 需要理解代码库的整体结构。
    • 想知道某个功能是如何实现的。
    • 寻找处理特定逻辑（如错误处理、API 请求）的相关代码。
  • 技巧：提出开放性问题。例如：“帮我探索一下这个项目是如何处理用户认证的？” 它会自动进行多轮的搜索、读取和分析，最后给您一个总结报告。

5. 高效提问的艺术

您的提问方式直接决定了 Claude Code 的表现。

  • 提供明确的上下文：
    • 不好：“代码坏了，帮我修好。”
    • 好：“我运行 npm start 后在浏览器控制台看到了一个 TypeError，错误信息是 ...，相关的代码在 src/utils/auth.js 文件的第 42 行。”
  • 设定角色和目标：
    • “假设你是一名资深前端工程师，请帮我重构这个 React 组件，目标是提升其性能。”
  • 利用文件路径：
    • 当您在 IDE 中打开了某个文件时，可以直接 @ 文件名提问，例如：“@content/posts/cctips.md 这篇文章的格式有什么问题吗？”

总结

快速上手 Claude Code 的秘诀在于实践和清晰沟通。把它当作您的编程伙伴，多利用它的规划和探索能力，您会发现编码过程变得前所未有的流畅和高效。祝您使用愉快！