关键词导航：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 之前，请确保你的系统满足以下要求：

类别	要求
操作系统	macOS 10.15+、Ubuntu 20.04+/Debian 10+，或 Windows 10+（使用 WSL 1 或 WSL 2）
硬件	4GB+ 内存
软件	Node.js 18+
网络	稳定的互联网连接
Shell	在 Bash、Zsh 或 Fish 中效果最佳
额外依赖	git 2.23+（可选）、ripgrep (rg)（用于增强文件搜索，通常包含在 Claude Code 中）

2. 标准安装步骤

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

NPM 安装

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

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

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

原生安装（Beta）

平台	命令
macOS、Linux、WSL	curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell	irm https://claude.ai/install.ps1 | iex
Windows CMD	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后，运行 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 支持哪些国家和地区

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

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

1. Claude Code 常用 CLI 命令参考

命令	作用	示例	描述
claude	启动交互模式（REPL）	claude	启动 Claude Code 会话，进入交互式环境。
claude "task"	运行一次性任务	claude "修复编译错误"	使用初始提示启动 REPL。
claude -p "query"	运行一次性查询并退出	claude -p "解释这个函数"	适用于需要一次性获取结果且不保持会话状态的情况。
claude -c	继续最近的对话	claude -c	立即恢复你最近的对话。
claude -r	恢复之前的对话	claude -r	显示交互式对话选择器，选择历史话题继续工作。
claude commit	创建一个 Git 提交	claude commit	-
claude update	更新到最新版本	claude update	保证使用最新功能和安全修复。
cat file | claude -p "query"	处理管道内容	cat logs.txt | claude -p "explain"	将文件内容通过管道传递给 Claude Code。

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

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

核心斜杠命令

命令	用途
/init	使用 CLAUDE.md 指南初始化项目
/clear	清除对话历史，重置会话上下文
/help	显示可用命令，帮助内容
/compact [instructions]	压缩对话，只保留上下文摘要，可选择性地提供重点指令
/config	查看/修改配置
/cost	显示 Token 使用统计
/mcp	管理 MCP 服务器连接和 OAuth 身份验证
/memory	编辑 CLAUDE.md 内存文件
/model	选择或更改 AI 模型
/permissions	查看或更新权限规则
/review	请求代码审查
/resume	恢复历史话题
/doctor	检查安装健康状况
/bug	报告错误（将对话发送给 Anthropic）

键盘快捷键

快捷键	描述	上下文
Ctrl+C 或 exit	退出/取消当前输入或生成	标准中断。
Esc	中断当前 AI 任务	立即停止 AI 的执行。
Esc + Esc	编辑上一条消息	双击 Escape 进行修改。
上/下箭头	导航命令历史	回调之前的输入。
Shift+Tab	切换权限模式	在自动接受模式、计划模式和正常模式之间循环切换。
\ + Enter	快速转义换行	创建新行，在所有终端中有效。
开头的 !	Bash 模式	直接运行命令并将执行输出添加到会话中。
开头的 #	内存快捷键	快速添加到 CLAUDE.md。

新手进阶技巧

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

不要只说：

“修复这个 bug”

可以改成更明确的：

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

2. 使用分步骤指令

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

示例：

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

3. 先让 Claude 了解代码

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

示例：

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

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

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