Claude Code 完整使用教程
> **Claude Code** 是 Anthropic 推出的 AI 编程助手 CLI 工具，运行在你的终端中，可以帮你编写代码、调试、搜索代码库、代码审查等。
## 目录
1. [安装与环境配置](#1-安装与环境配置)
2. [基本交互方式](#2-基本交互方式)
3. [斜杠命令 (Slash Commands)](#3-斜杠命令-slash-commands)
4. [内置工具详解](#4-内置工具详解)
5. [技能系统 (Skills)](#5-技能系统-skills)
6. [权限管理](#6-权限管理)
7. [设置与配置文件](#7-设置与配置文件)
8. [工作区与项目](#8-工作区与项目)
9. [高级功能](#9-高级功能)
10. [实用技巧](#10-实用技巧)
## 1. 安装与环境配置
### 1.1 安装 Claude Code
Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | bash
npm 安装:
npm install -g @anthropic-ai/claude-code
### 1.2 首次启动
claude
首次启动会引导你完成认证（需要 Anthropic API Key 或登录 Anthropic 账号）。
### 1.3 更新
claude --update
## 2. 基本交互方式
### 2.1 直接对话
在终端中启动 claude 后，直接在提示符下输入你的需求即可：
> 帮我写一个 Python 脚本，读取 CSV 文件并计算每列的平均值
### 2.2 在指定目录下工作
cd /path/to/your/project
claude
Claude Code 会自动感知当前目录作为工作区。
### 2.3 单次执行模式
不进入交互式 REPL，直接执行一次任务：
claude "解释这个项目是做什么的"
claude -p "列出所有 TODO 注释" # -p 表示非交互模式
### 2.4 管道模式
cat error.log | claude "分析这些错误日志，找出原因"
git diff | claude "审查这些改动"
## 3. 斜杠命令 (Slash Commands)
在 Claude Code 交互界面中，输入 / 可以看到所有可用命令：
/help 显示帮助信息
/clear 清空当前对话
/compact 压缩对话上下文以节省 token
/config 查看和修改配置
/cost 查看当前会话的 token 消耗
/doctor 诊断安装问题
/init 为当前项目生成 CLAUDE.md 文档
/theme 切换主题（dark/light）
/model 切换使用的模型
/permissions 管理权限设置
/mcp 管理 MCP 服务器
/add-dir 添加额外的工作目录
/ide 查看 IDE 集成状态
/statusline 配置状态栏显示
/upgrade 升级 Claude Code
/logout 登出账号
/bug 报告 bug
/feedback 发送反馈
## 4. 内置工具详解
Claude Code 有一个强大的工具集，它能自动选择合适的工具来完成任务。你不需要记住这些工具，Claude 会自动调用。
### 4.1 文件操作
Read 读取文件内容（支持 PDF、图片、Jupyter Notebook）
Write 创建或覆写文件
Edit 精确替换文件中的文本
Glob 按通配符模式查找文件（如 **/*.js）
Grep 在文件内容中搜索正则表达式
### 4.2 执行操作
Bash 执行 shell 命令
示例用法：
你可以直接说：
- "读取 src/main.py 文件"
- "查找所有包含 TODO 的文件"
- "用 glob 找一下所有 .ts 文件"
- "运行 npm test"
### 4.3 智能代理 (Agent)
Claude 可以启动子代理来处理复杂任务：
你可以说：
- "用 agent 去搜索代码库中的认证逻辑"
- "启动一个 explore agent 去查看整个项目的结构"
### 4.4 网络工具
WebSearch 在网络上搜索信息
WebFetch 抓取网页内容并转换为 Markdown
示例：
- "搜索一下 React 18 的新特性"
- "查看这个 GitHub issue 的内容"
## 5. 技能系统 (Skills)
技能是专门化的功能模块。使用 /技能名 来调用：
### 5.1 可用技能
/init 为代码库生成 CLAUDE.md 文档
/code-review 代码审查（查找 bug、简化建议）
/simplify 简化代码（重组、优化、去重）
/review 审查 Pull Request
/security-review 安全审查
/deep-research 深度网络调研（多源搜索+验证+报告）
/run 启动并驱动应用，验证改动
/verify 验证代码改动是否按预期工作
/loop 定时循环执行任务（如每 5 分钟检查部署状态）
/claude-api Claude API 参考文档
/update-config 修改 settings.json 配置
/fewer-permission-prompts 自动分析并减少权限提示
### 5.2 使用示例
# 审查当前改动
/code-review
# 给 PR 添加评论
/code-review --comment
# 深度研究
/deep-research "Python 异步编程的最佳实践是什么？"
# 定时检查
/loop 5m /verify
## 6. 权限管理
Claude Code 在执行某些操作前会请求你的许可。
### 6.1 权限级别
Allow — 允许本次执行
Deny — 拒绝本次执行
Always Allow — 总是允许此类操作
Always Deny — 总是拒绝此类操作
### 6.2 管理权限
使用 /permissions 命令查看和管理所有权限规则。
权限配置存储在：
- 项目级: .claude/settings.json
- 用户级: ~/.claude/settings.json
### 6.3 减少权限弹窗
如果觉得权限弹窗太多，可以运行：
/fewer-permission-prompts
## 7. 设置与配置文件
### 7.1 配置文件位置
settings.json 项目 .claude/ 或 ~/.claude/ 权限、钩子、环境变量
CLAUDE.md 项目根目录 项目文档，Claude 每次启动都会读取
keybindings.json ~/.claude/ 键盘快捷键
scheduled_tasks.json .claude/ 定时任务
MEMORY.md 项目 .claude/memory/ 持久化记忆
### 7.2 CLAUDE.md
CLAUDE.md 是一个关键文件，它告诉 Claude Code 关于你项目的所有重要信息。使用 /init 自动生成：
/init
你也可以手动创建和维护它，内容包括：
- 项目架构说明
- 常用命令
- 编码规范
- 项目特定注意事项
### 7.3 钩子 (Hooks)
在 settings.json 中配置，可以在特定事件触发时自动执行操作：
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hook": "echo '即将执行命令'"
}
]
}
}
## 8. 工作区与项目
### 8.1 多目录工作区
# 添加额外目录
/add-dir /path/to/another/project
### 8.2 Git 集成
Claude Code 自动感知 Git 仓库：
- 自动检测当前分支
- 可以在工作树 (worktree) 中隔离工作
- 支持 gh CLI 进行 GitHub 操作
### 8.3 IDE 集成
Claude Code 可以与 VS Code 和 JetBrains IDE 集成：
/ide
## 9. 高级功能
### 9.1 计划模式 (Plan Mode)
对于复杂任务，Claude 会先制定计划再执行：
- 先探索代码库
- 设计实施方案
- 等你确认后再编写代码
你也可以主动要求：
> "帮我实现用户认证功能，先制定计划"
### 9.2 后台任务
耗时命令可以放到后台运行：
# Claude 会自动将长时间任务放到后台
> "运行完整的测试套件"
# 你可以在测试运行时继续其他工作
### 9.3 定时任务
/loop 10m "检查 CI 状态"
### 9.4 MCP 服务器
Model Context Protocol 允许 Claude 连接外部工具：
/mcp
### 9.5 Token 预算控制
你可以在消息后追加 token 预算来限制消耗：
> 全面审查代码库中的安全问题 +50k
> 深入分析所有 API 端点 +200k
### 9.6 记忆系统
Claude Code 有持久化记忆功能，存储在 .claude/memory/ 目录。你可以说：
- "记住这个项目使用 PostgreSQL 数据库"
- "记住我喜欢用 TypeScript 而不是 JavaScript"
## 10. 实用技巧
### 10.1 有效的提问方式
好的提问：
> 在 src/services/auth.ts 中实现 JWT 令牌刷新逻辑，使用现有的 apiClient，
> 参考 src/utils/token.ts 中的 token 存储方式
不太好的提问：
> 加个登录
技巧：
- 明确指定文件路径
- 引用现有代码作为参考
- 描述预期行为
- 分步骤处理大任务
### 10.2 高效的文件操作
# 不用手动 grep
> 找出所有调用 deprecatedFunction 的地方并替换为 newFunction
# 不用手动 find
> 找到所有没有测试文件的 .ts 模块
### 10.3 代码审查流程
# 1. 审查当前未提交的改动
/code-review
# 2. 审查特定文件
> "审查 src/auth/ 目录下的所有文件"
# 3. 审查 PR
gh pr checkout 42
/review
### 10.4 调试技巧
# 粘贴错误信息
> 我在运行 npm run build 时遇到这个错误：
> [粘贴错误日志]
> 帮我分析和修复
# 让 Claude 添加调试日志
> 在 router.ts 的关键位置添加 console.log 来追踪请求流
### 10.5 学习代码库
# 快速了解项目
/init
# 提问
> 这个项目的入口文件是什么？
> 认证系统是怎么工作的？画个流程图
> 有哪些 API 端点？
### 10.6 节省 Token
# 清理上下文
/compact
# 查看消耗
/cost
# 切换更便宜的模型
/model claude-sonnet-4-6
### 10.7 快捷键参考
Ctrl+C 中断当前操作
Ctrl+D 退出 Claude Code
Ctrl+R 搜索历史命令
↑/↓ 浏览历史命令
Tab 自动补全路径
可以在 ~/.claude/keybindings.json 中自定义快捷键。
## 附录 A: 常见问题
Q: Claude Code 和 GitHub Copilot 有什么区别？
A: Claude Code 是完整的终端内 AI 编程助手，不仅能补全代码，还能理解整个项目、执行命令、管理文件、进行代码审查等。Copilot 更侧重于编辑器内的代码补全。
Q: 如何控制花费？
A: 使用 /cost 查看消耗，使用 +50k 等 token 预算限制，或切换到更便宜的模型。
Q: Claude Code 能访问网络吗？
A: 可以。它可以使用 WebSearch 和 WebFetch 工具访问网络（需你授权）。
Q: 我的代码安全吗？
A: Claude Code 在本地运行，代码不会上传到 Anthropic 服务器存储。每次对话的上下文会发送到 API 进行处理。详见 Anthropic 的隐私政策。
## 附录 B: 快速参考卡
# 最常用的命令
claude # 启动交互式 REPL
claude "任务描述" # 单次执行
claude -p "任务" # 非交互模式
git diff | claude "审查" # 管道模式
# 最常用的斜杠命令
/init # 生成项目文档
/code-review # 代码审查
/clear # 清空对话
/compact # 压缩上下文
/cost # 查看消耗
/help # 帮助
# 实用技巧
> "读取 src/main.py" # 读文件
> "搜索所有 TODO 注释" # 搜索
> "运行 npm test" # 执行命令
> "这个项目的架构是什么样的？" # 理解项目
> "审查我的改动" 或 /code-review # 代码审查
本教程基于 Claude Code 2026 年版本编写，功能可能随版本更新而变化。使用 /help 查看最新文档。
汇聚全球AI编程工具，助力开发者即刻编程。
更多推荐
2
0- 0
已为社区贡献1条内容
所有评论(0)