Claude Code 基础用法与实战技巧全指南

Claude Code 是 Anthropic 官方推出的命令行界面（CLI）工具，它将 Claude 的强大能力直接集成到你的终端中。与传统的 IDE 插件不同，Claude Code 作为一个Agent（智能体），能够主动理解代码库、运行终端命令、编辑文件，并处理复杂的 Git 工作流。

Claude Code 提供了原生安装包，无需依赖 Node.js 环境（旧版 NPM 方式已不推荐）。

安装步骤

macOS 和 Linux:
在终端运行以下命令：

注：如果是 macOS，可以使用 Homebrew 管理（需先安装上述脚本，或手动配置 Tap），但官方脚本最为直接。

Windows:
使用 WinGet 安装：

更新 Claude Code:

• macOS/Linux: 通常会自动后台更新，或再次运行安装脚本。
• Windows:

权限配置

安装完成后，你可能需要根据提示将 添加到系统的 PATH 环境变量中，以便在任意目录下使用。

安装完成后，在终端输入以下命令启动：

首次运行流程：

1. 系统会引导你进行认证。按下 键，浏览器会自动打开认证页面。
2. 登录你的 Anthropic 账号（或 Google/GitHub 关联账号）。
3. 授权完成后，终端会自动检测并完成登录。
4. 如果是商业版用户（Enterprise），可能需要配置额外的环境变量或 SSO 登录。

启动 Claude Code 后，你将进入一个交互式的 REPL（Read-Eval-Print Loop）环境。

启动方式

在你的项目根目录下运行：

Claude 会自动索引当前目录下的文件，理解项目结构。

常用 Slash Commands (指令)

在交互模式下，使用 开头的指令来控制 Claude 的行为：

典型工作流

1. 提问/指令：直接用自然语言描述需求。
   

   “分析一下 中的错误处理逻辑，并重构它以支持异步操作。”

2. 执行计划：Claude 会列出它打算执行的步骤（读取文件 -> 分析 -> 编辑文件 -> 运行测试）。
3. 权限确认：默认情况下，Claude 在编辑文件或运行终端命令前会请求你的许可。
   • 按 批准执行。
   • 按 跳过当前操作。
   • 输入其他文本与 Claude 协商修改计划。

要想真正发挥 Claude Code 的威力，掌握以下技巧至关重要。

1. 上下文管理（省钱又高效）

Claude Code 的上下文窗口很大，但并非无限，且 Token 是计费的。

• 任务隔离：完成一个功能模块（Feature）后，养成习惯输入 。这能让 Claude “忘掉” 之前的杂音，专注于新任务。
• 精准投喂：虽然 Claude 能自己检索文件，但如果你明确知道涉及哪些文件，可以显式提到文件名，或者直接把报错日志粘贴进去。

2. 权限与自动化

默认的“步步确认”模式在进行大量重构时会很繁琐。

• 自动批准（慎用）：在 中或启动时可以使用参数减少确认频率（注意安全风险）。
• Sandbox 模式：官方文档建议在 Docker 等沙箱环境中使用，这样你可以更放心地给予 Claude 权限，让它自主完成整个重构任务。

3. 集成外部工具 (CLI Tools)

Claude Code 能够学习并使用其他命令行工具。

• GitHub 集成：
  

  “使用 CLI 查看分配给我的最新 Issue，并创建一个分支开始修复它。”
  如果 Claude 不会用某个工具，你可以告诉它：“Run to learn how to use it.”

• 运行测试：
  

  “修改完代码后࿼laude code 教程0c;请运行 确保所有测试通过。如果失败了，请自动修复。”

4. 使用 MCP (Model Context Protocol)

Claude Code 支持 MCP 协议，可以连接外部数据源。

• 连接数据库/文档：通过配置 MCP Server，你可以让 Claude 直接读取 Notion 文档、PostgreSQL 数据库结构，甚至 Linear/Jira 的任务详情，从而实现”读取需求 -> 编写代码”的闭环。

5. 自定义系统提示词 (System Prompt)

对于特定项目，你可能有一套编码规范。

• 项目级规范：在项目根目录创建一个 (具体路径参考官方文档或 ) 或使用 参数。
• 内容示例：

  这样 Claude 在生成代码时就会默认遵守这些规则。

1. Token 消耗：Claude 3.5/3.7 Sonnet 模型虽然性价比高，但长时间的 Agent 循环（读取-思考-修改-测试）会消耗大量 Token。定期使用 检查。
2. 安全风险：Claude Code 可以执行 等危险命令。务必保持警惕，不要在生产环境服务器上盲目开启”自动批准”模式。
3. 大文件处理：对于超大型项目，Claude 可能无法一次性读取所有文件索引。建议通过自然语言引导它关注特定的目录（例如 “Focus on the directory”）。

总结

Claude Code 是一个交互式、代理式的编程伙伴。它的核心优势在于“Agentic Workflow”——它不仅仅是补全代码，而是能够像人类工程师一样，执行”运行命令、查看报错、修改代码、再次验证”的完整循环。掌握好上下文管理和工具集成，它将极大提升你的开发效率。