Claude Code是什么？如何使用Claude Code｜Claude Code使用教程与完整指南

关键词导航：claude code 是什么，claude code 如何使用，claude code 怎么用，claude code 使用，如何使用 claude code，claude 教程

Claude Code 是近期热度最高的 AI 编程工具，特别在海外社区获得了大量讨论。它是 Anthropic 开发的一款智能编程工具 (agentic coding tool)，能够在你的终端中运行，帮助你比以往任何时候都更快地将想法转化为代码。

许多开发者将其视为 AI 结对编程伙伴，它远不只是一个写代码的 AI，而是能够主动搜索、读取代码、编辑文件、运行测试、甚至提交代码到 GitHub 的 Agentic 系统。

本文将尽可能全面、详尽、准确的为你提供一份可实操的 Claude Code 完整教程，助你精通这一强大的开发工具。

一、Claude Code 是什么？核心优势与设计哲学

Claude Code 运行在你的终端中，利用自然语言指令帮助开发者高效编写代码。它能够理解你的代码库内容，并自动化繁琐任务，大幅缩短开发周期。

1. Claude Code 的能力边界

Claude Code 提供以下核心功能，帮助开发者提高效率：

• 从描述构建功能：用简单的英语告诉 Claude 你想要构建什么，它会制定计划、编写代码并确保其正常工作。
• 编辑文件并修复代码中的错误：能够在代码库中跨文件进行编辑，并自动修复 bug。
• 调试和修复问题：描述一个错误或粘贴错误消息，Claude Code 将分析你的代码库，识别问题并实施修复。
• 导航任何代码库：询问关于代码架构和逻辑的问题，Claude Code 保持对你整个项目结构的感知。
• 自动化繁琐任务：执行测试、修复代码、进行质量检查、解决合并冲突并编写发布说明。
• Git 历史记录搜索、创建提交和 PR：简化版本控制操作。

2. 为什么是终端（黑框）？

Claude Code 选择了“黑框”终端界面，这在一些用户看来过于原始简陋，但实际上是 Anthropic 经过深思熟虑的设计，它代表了“反璞归真”的设计哲学。

终端界面的三大优势在于：

1. 自由度最大：AI 可以调用一切系统能力，不受 UI 框架的限制。
2. 认知负担最小：你只需要说出你想要什么，无需学习复杂的界面操作。
3. 天然集成工具链：所有的开发工具（如 Git、npm 等）本来就是命令行（CLI）的，终端是最好的集成环境。

这使得 Claude Code 能更好地专注于 Agentic Coding 的核心循环：感知、规划、行动。

二、如何安装与配置 Claude Code（claude 教程/claude code 如何使用）

1. 系统要求

在使用 Claude Code 之前，请确保你的系统满足以下要求：

2. 标准安装步骤

Claude Code 的标准安装推荐使用 NPM，或使用原生二进制安装（Beta 版）。

NPM 安装

确保你的 Node.js 版本在 18.0 以上。

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

注意： 不要使用 sudo npm install -g，因为它可能导致权限问题和安全风险。

原生安装（Beta）

安装完成后，运行 claude doctor 检查安装类型和版本。

3. 身份认证与登录

Claude Code 需要账户才能使用。在项目目录下运行 claude 命令，首次使用会提示你登录。

# 进入项目目录
cd your-awesome-project

# 开始使用Claude Code
claude
# 首次使用会要求先登录

• Claude Console：使用 Claude Console 账户登录，完成 OAuth 流程。首次认证会创建一个名为 “Claude Code” 的工作区，用于成本跟踪和管理。
• Claude App（Pro 或 Max 计划）：订阅 Claude 的 Pro 或 Max 计划，使用 Claude.ai 账户登录。

如果你需要重新登录或切换账户，请在 Claude Code 中使用 /login 命令根据提示登录即可，登录后就可以开始正式使用了，在终端中输出你的任务描述让 Claude Code 开始干活吧！

Claude Code 是你的 AI 结对编程助手。把它当作一位值得信赖的同事——只需告诉它你想实现的功能，它就会帮你完成。

注意，使用 Claude 需要科学上网，相关阅读： Claude.ai 支持哪些国家和地区

4. 国内用户替代安装与配置（GAC Code 镜像站）

鉴于国内网络环境和官方 API 访问的限制，社区中流行通过中转服务实现免费使用。

注意： 这种方法通过第三方中转服务实现，可能涉及信息安全和隐私问题，不建议用于敏感项目。

步骤 (以 GAC Claude Code 镜像站为例)

1. 注册 AnyRouter/GAC Code 镜像站账号：注册账号并生成 API Key（通常以 sk- 开头）。建议勾选“设为无限额度”，以防单次任务超限。
2. 卸载官方版本：如果你先前安装过 Claude Code，务必先卸载以避免镜像冲突：

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

3. 安装镜像站版本：在终端执行：

   npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com
   

4. 配置环境变量：将 API Key 和中转 URL 配置为环境变量：

   export ANTHROPIC_AUTH_TOKEN=sk-your-Key
   export ANTHROPIC_BASE_URL=https://anyrouter.top
   # 或者配置为永久环境变量到 ~/.bashrc 或 ~/.zshrc
   

5. 启动与授权：进入项目目录，运行 claude，根据提示到镜像站上进行授权。

5. Windows WSL 设置

Windows 用户推荐使用 WSL (Windows Subsystem for Linux) 部署 Claude Code。

• WSL 安装：在终端运行 wsl --install。
• Node.js 安装：在 WSL 环境中，通过 Linux 发行版的包管理器或 nvm 安装 Node.js。
• 集成 VS Code (推荐)：为了解决 Windows 文件系统路径不一致的问题，推荐使用 VS Code 的集成终端。在 VS Code 中打开项目，通过下拉菜单选择 Ubuntu/WSL 终端，确保 Claude Code 启动位置确定在项目文件夹内。

三、Claude Code 基础使用：命令行与交互模式（claude code 怎么用）

Claude Code 提供了 CLI 命令和交互模式（REPL）两种主要使用方式。

1. Claude Code 常用 CLI 命令参考

2. Claude Code 交互模式与斜杠命令 (Slash Commands)

在交互模式下（运行 claude 后），通过斜杠命令 (/) 可以快速执行各种操作和配置设置。

核心斜杠命令

键盘快捷键

新手进阶技巧

1. 使用 Claude Code 时描述要具体

不要只说：

“修复这个 bug”

可以改成更明确的：

“修复登录 bug —— 当用户输入错误凭证时，会出现空白页面”

2. 使用分步骤指令

将复杂任务拆解成多个步骤：

示例：

1. 新建一个用于用户资料的数据库表
2. 创建一个 API 接口，用于获取和更新用户资料
3. 开发一个网页，支持用户查看和编辑自己的信息

3. 先让 Claude 了解代码

在做改动前，可以先让 Claude 熟悉代码结构：

示例：

分析数据库的 schema
构建一个仪表盘，展示英国用户退货最多的产品

4. 善用快捷操作节省时间

• 使用 Tab 自动补全命令
• 按 ↑ 查看历史命令
• 输入 / 查看所有斜杠命令

相关阅读： Claude Code 最佳实践教程——使用方法详解

四、Claude Code 上下文与内存管理

Claude Code 的强大之处在于它能感知和理解整个项目，这依赖于其强大的上下文和内存管理机制。

1. CLAUDE.md 文件：项目指令

CLAUDE.md 文件是项目的指导原则，规定了 AI 如何生成代码，类似于 Cursor 的 Rules 文件。

Claude Code 会分层读取内存文件：

Claude Code 在启动时会通读整个文件夹下的所有文件，并将学到的项目知识保存到 CLAUDE.md 文件中。后续对话都会带上该文件作为上下文，帮助 AI 更快地理解项目。

• 手动补充：你也可以手动修改此文件，补充重要信息，例如关于 CSS 框架的知识。
• 快速添加：在对话中，输入 # 字符即可快速将内容添加为内存，系统会提示你选择存储位置。

2. 上下文压缩与清除

长时间的对话会积累无关键要的内容，消耗大量 Token，并降低 AI 的专注力。

• /compact [instructions]：用于压缩对话的上下文。Claude Code 会排除掉之前对话的一些无关键要的内容，有效提高 AI 的专注力，并显著降低 Token 消耗。你可以输入指令告诉 AI 应该如何进行压缩。
  • Claude 默认在上下文超过 95% 容量时使用自动紧凑。
  • 你可以通过将 Summary instructions 添加到 CLAUDE.md 来自定义紧凑的焦点。
• /clear：用于清除 AI 的对话记录。每当要开启一个新任务时，应使用 /clear 来保持一个干净的上下文。

3. 长效记忆：用户级与项目级

Claude Code 提供了记忆模式，可以将信息作为文件形式记录下来，变成 AI 的长期记忆。

• 输入一个警号 #，即可进入记忆模式。
• 项目级记忆：直接保存在当前项目的 CLAUDE.md 文件中。
• 用户级记忆：保存在 Claude Code 的配置文件目录中（Windows 电脑上通常在 C:\Users\<用户名>\.claude\cloud.MD）。用户级记忆对所有的项目都可生效，类似于 Claude Code 的系统提示词。

五、Claude Code 高阶使用技巧与工作流实战

1. Agentic 编程哲学：“谋、定、动”

资深用户总结了一套提升 AI 编程效率的“谋、定、动”三字诀。这套技巧不仅适用于 Claude Code，对其他 AI 编程工具也同样有效。

• 谋（聊透需求）：将需求书面化，不断与 AI 聊，确保思路清晰，让 AI 完全理解意图。
  • 切换到 Opus 模型（如果可用），因为它处理复杂需求更可靠。
  • 让 AI 复述一遍需求，确保理解对齐。
• 定（规划任务）：需求聊透后，将任务拆分并定下来。
  • 要求 Claude Code 列出步骤，并标明哪些任务可以并行。
  • 在执行前，始终使用 计划模式 (plan mode) 或 --permission-mode plan 规划复杂更改。
• 动（快速执行）：开启狂飙模式，快速执行。
  • 速度拉满，因为有 Git 帮助你版本回退。
  • 在执行出错时，可以按 ESC 中断任务。
  • 执行多任务后，如果 Claude Code 显得不聪明，可以 /clear 或 /compact 清除记忆。

2. 强制深度思考与提示词技巧

对于复杂的推理任务，Claude Code 提供了官方支持的深度思考模式 (Extended Thinking)。

• 思考提示词：这不是写死的提示词技巧，而是官方支持的控制模型思考长度的方法。
  • 在开始困难的推理任务之前，可以加上 think、think harder、ultrathink、step-by-step reasoning 或 think a lot 等强化短语 来加大 AI 的思考长度。
  • Opusplan 模型别名会自动在计划模式下使用 opus 进行复杂推理，然后在执行时切换到 sonnet。
• 正面表达：在写提示词时，尽量使用正面表达，告诉 AI 应该做什么，而不是不做什么。
  • 例如，应说“提取公共逻辑为函数”，而不是“不要写重复代码”。
• 结构化提示：Claude 对结构化语言（如 XML 标签）比较敏感，使用分块格式（如 XML 标签结构化提示）可以提升清晰度与可控性。
• 长文本优化：如果粘贴很长的日志或文档，遵循内容在前，指令在后的法则。

3. 多任务与子 Agent (Subagents)

Subagent 很像编程中的子线程，可以让 Claude Code 在后台开启任务并并行执行，以加快执行效率。

• 创建 Subagent：输入 /agents，然后选择 create。
  • 需要描述 Subagent 可执行的任务和期望达成的结果（例如，“代码审阅大师” Subagent）。
  • 可以赋予 Subagent 特定的工具权限。
  • 配置可以存放到项目级或用户级。
• 并行执行：Claude Code 拿到一个任务后，会根据 Subagent 配置自动拆分出子任务，分配给不同的 Subagent 执。
  • 子任务之间是并行运行的。
  • 每个 Subagent 都会获取一份执行自身子任务所需的最简版上下文，提高了专注力。
  • 最后由主 Agent 整合所有结果。
• 用途：拆解复杂任务，提高成功率。例如，让一个 Subagent review 分支，另一个 Subagent 查询天气。

4. 自定义斜杠命令

Claude Code 支持自定义斜杠命令，你可以创建这些命令来快速执行特定提示或任务。

• 创建项目命令：存储在项目目录的 .claude/commands/ 文件夹内。
  • 文件名为命令名（例如，codereview.md 创建命令 /codereview）。
  • 项目命令对克隆仓库的每个人都可用。
• 创建个人命令：存储在 ~/.claude/commands/ 文件夹内，对所有项目生效。
• 使用参数：自定义命令支持传递参数，使用 $ARGUMENTS 作为传入参数的占位符。
  • 例如，在命令文件中写 比较与 $ARGUMENTS 分支的差异，然后输入 /codereview feature-branch。
• 前置元数据 (Frontmatter)：命令文件支持前置元数据，可以指定 allowed-tools、description 和 model。
• Bash 执行：在命令文件中使用 ! 前缀执行 Bash 命令，其输出会包含在上下文中。

5. Git 与版本控制

Claude Code 使 Git 操作变得对话化。

• 对话式 Git：你可以自然语言描述 Git 操作：用描述性消息提交我的更改，创建新的修复分支。
• 集成 GitHub/GitLab：通过安装 GitHub Actions 或 GitLab CI/CD 集成，Claude 可以在 PR 或 Issue 中被提及 (@claude)，自动分析代码、创建拉取请求、实现功能和修复错误。
• 恢复历史会话：
  • /resume：找回之前的历史话题。
  • claude --continue (-c)：自动继续最近的对话。
• Git worktrees：使用 Git worktrees 可以在同一仓库的多个分支中运行并行 Claude Code 会话，确保每个实例彼此完全隔离。

6. IDE 集成（VSCode/JetBrains）

尽管 Claude Code 是命令行工具，但它提供了强大的 IDE 插件，实现了 IDE 和 Claude Code 的协同工作。

• 安装集成：在你常用的 IDE 中（如 VSCode）安装插件。在 VSCode 中，运行 claude 即可自动安装扩展。对于 JetBrains IDE，需要从市场安装插件。
• 连接 IDE：输入斜杠命令 /ide。
• 功能：
  • 选择上下文：在 IDE 中选中的代码，Claude Code 可以感知并解释其功能。
  • 差异查看：当 Claude Code 进行代码修改时，它会在 IDE 中弹出页面，对比修改前后的差异，你可以直观地在 IDE 中选择是否接受这些修改。
  • 快捷键：使用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）快速启动 Claude Code。

7. 模型上下文协议 (MCP) 与外部集成

MCP (Model Context Protocol) 是一种开放的协议，允许 Claude Code 连接到数百个外部工具和数据源。

• MCP Server：作为 AI 与外部工具的中间层，代替人类访问并操作外部工具。
• 安装 MCP：使用 claude mcp add 命令安装 MCP Server。
  • 项目级安装：只在当前项目下生效。
  • 用户级安装：对所有文件和项目生效。
• 使用 MCP：通过 MCP，Claude Code 可以查询数据库、分析监控数据、集成设计或自动化工作流程。
  • 例如，安装 CEX MCP Server 可以帮助 AI 查找最新的代码文档。
• MCP 工具命名：MCP 工具遵循模式 mcp____，例如 mcp__github__search_repositories。
• 引用 MCP 资源：使用 @ 提及格式 @server:protocol://resource/path 来引用资源。例如，@github:issue://123。

六、权限、安全与成本控制

1. 权限管理与模式

Claude Code 采用分层权限系统来平衡功能和安全性。

权限模式

你可以使用 /permissions 命令查看和管理权限。

2. 钩子 (Hooks) 机制

Hooks 允许 Claude Code 在工作过程中的某个特定节点执行某些特定操作。

• 配置：在你的设置文件（例如 .claude/settings.json）中配置 hooks。
• 触发事件：Hooks 在工具执行前 (PreToolUse)、工具执行后 (PostToolUse)、用户提交提示时 (UserPromptSubmit) 等多种事件下触发。
• 用途：实现自动化，例如在 Claude Code 完成代码修改后，自动执行 npx prettier --check 来检查代码格式是否正确。如果格式错误，Claude Code 会意识到问题并自动进行修复。

3. 排除敏感文件

要防止 Claude Code 访问敏感信息（例如 API 密钥、.env 文件），请在你的 .claude/settings.json 文件中使用 permissions.deny 设置：

{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

匹配这些模式的文件将对 Claude Code 完全不可见。

4. 成本管理与优化

每次 Claude Code 交互都会消耗 Token。平均而言，使用 Sonnet 4 的 Claude Code 每个开发者每月成本约为 $100-200，但使用量差异很大。

• /cost 命令：显示当前会话详细的 Token 使用统计信息和总花费。
• 紧凑对话：定期使用 /compact 来减少上下文大小，以降低 Token 使用量。
• 清除历史记录：使用 /clear 重置上下文，避免累积过多历史信息影响效率和成本。
• 分解复杂任务：将大型任务拆分为专注的交互。
• 配置最大轮数：在非交互模式下，通过 claude_args: --max-turns 10 来配置适当的最大对话轮数，以防止过度迭代。

七、故障排除与进阶配置

1. 常见安装和权限问题

2. 优化终端设置

• 换行设置：在 Claude Code 中运行 /terminal-setup 可为 iTerm2 和 VS Code 终端自动配置 Shift+Enter 绑定。
• 通知设置：通过 /config 或设置环境变量 preferredNotifChannel 为 terminal_bell，可以在任务完成时启用声音警报。
• Vim 模式：Claude Code 支持 Vim 键绑定的子集，可以通过 /vim 启用。

3. 模型配置与切换

你可以通过多种方式配置 Claude Code 使用的模型：

• 会话期间：使用 /model <别名> 切换。
• 启动时：使用 claude --model <别名> 启动。

模型别名

4. 自定义状态栏

你可以为 Claude Code 创建自定义状态栏，显示在界面底部，类似于终端提示符（PS1）。

• 运行 /statusline 让 Claude Code 帮助你设置。
• 状态栏通过 stdin 接收关于当前会话的 JSON 格式上下文信息（模型、目录、成本等）。
• 支持 ANSI 颜色代码来设置状态栏样式。

常见问题

如何开始使用 Claude？

你可以通过以下方式访问 Claude Code：

• Claude Pro 或 Max 订阅
• Team 或 Enterprise 计划的高级席位
• Claude Console 账号

下载 Claude Code，并使用相应的 Claude 或 Console 凭证登录即可。

Claude Code 可以处理哪些任务？

Claude Code 擅长：

• 常规开发任务：修复 Bug、编写测试等
• 复杂开发工作：大型重构、功能实现、对代码库的深度理解与修改

Claude Code 如何与现有工具配合？

Claude Code 在本地终端运行，无需改变你的工作流：

• 可与常用的 IDE 和开发工具并行使用
• 能调用命令行工具（如 Git）
• 可通过 MCP 服务器（如 GitHub）扩展功能，利用你已有的工具完成更多操作

Claude Code 安全吗？

是的：

• Claude Code 在本地终端运行，直接与模型 API 通信
• 不依赖远程服务器或代码索引
• 在修改文件或运行命令前会先征得你的同意

Claude Code 使用哪些模型？

Claude Code 支持以下模型：

• Opus 4.1
• Sonnet 4
• Haiku 3.5

企业用户还可通过 Amazon Bedrock 或 Google Cloud Vertex AI 上的现有实例运行 Claude Code。

Claude Code 的系统要求是什么？

Claude Code 支持以下操作系统：

• macOS
• Linux
• Windows

详细的系统要求请查看官方说明。

Claude Code 的费用是多少？

当你使用 Claude Console 账号时，Claude Code 会按照 <strong>标准 API 定价</strong> 消耗 API tokens。

总结

通过这篇Claude Code 完全指南，我们深入了解了 Claude Code 的用法，包括claude code 是什么、claude code 如何使用、安装配置到高级 Agentic 工作流。

Claude Code 凭借其强大的 Agentic 能力和在终端的无缝集成，成为了程序员的“超级助手”。认清 AI 的边界，并结合本文提供的Claude 教程和实战技巧，你就能充分释放 Claude Code 的潜力，让 AI 编程效率翻倍！