Claude Code

终端命令使用指南

完整版 | 详细说明

2026 年 6 月 1 日

────────────────────────────────────────────────────────────

第一章 Claude Code 简介

1.1 什么是 Claude Code

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它让你在终端中直接与 Claude AI 对话，进行代码编写、调试、重构、分析等软件工程任务。

不同于网页版的 ChatGPT 或 Claude.ai，Claude Code 深度集成在你的开发环境中，能直接读写你的项目文件、执行命令、操作 Git，是一个真正能帮你干活的 AI 工具。

1.2 Claude Code 的核心能力

• 直接读取和编辑项目中的文件
• 执行 shell 命令（git、npm、mvn 等）
• 搜索代码库（按文件名、内容、正则）
• 创建和管理 Git 提交、分支、PR
• 支持多种 AI 模型（Claude、GPT、自定义模型）
• 流式输出，实时看到 AI 的思考和操作
• 对话历史自动压缩，长对话不会丢失上下文

1.3 安装方式

方式一：npm 全局安装（推荐）

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

方式二：桌面应用

从 https://claude.ai/download 下载安装

方式三：IDE 插件

VS Code 扩展商店搜索 Claude Code

JetBrains 插件市场搜索 Claude Code

1.4 启动与登录

进入你的项目目录，输入 claude 启动：

cd /path/to/your/project

claude

首次使用需要登录 Anthropic 账号或配置 API Key：

claude auth login

第二章 基础对话命令

2.1 直接提问

在 Claude Code 提示符后直接输入文字，即可与 AI 对话：

claude> 这个项目是做什么的？

claude> 帮我解释一下 main.py 里的 init_database 函数

claude> 找到所有未使用的 import 并清理掉

2.2 使用 / 命令（斜杠命令）

斜杠命令是 Claude Code 的内置快捷操作，以 / 开头：

命令	全称	作用
/help	help	显示帮助信息，列出所有可用命令
/config	config	打开设置对话框，配置模型、权限等
/model	model	查看和切换当前使用的 AI 模型
/clear	clear	清除当前对话历史，重新开始
/compact	compact	手动压缩对话上下文，释放 token 空间
/cost	cost	查看本次会话的 token 消耗和费用
/doctor	doctor	诊断 Claude Code 环境问题
/init	init	在项目中创建 CLAUDE.md 文件
/login	login	登录 Anthropic 账号
/logout	logout	退出登录
/mcp	mcp	管理 MCP 服务器连接
/memory	memory	查看和管理持久化记忆
/permissions	permissions	查看和管理权限设置
/pr_comments	pr_comments	查看当前 PR 的评论
/review	review	审查代码变更
/status	status	查看当前会话状态
/terminal-setup	terminal-setup	配置终端快捷键
/vim	vim	切换 vim 编辑模式
/fast	fast	切换快速模式（使用更快的模型）

2.3 使用 ! 前缀执行 Shell 命令

在对话中用 ! 前缀可以直接执行 shell 命令，输出会进入对话上下文：

claude> ! git status

claude> ! npm run build

claude> ! ls -la src/

claude> ! mvn clean package

这比让 AI 帮你执行更快，适合你确认要跑的命令。

2.4 多行输入

输入时按 Shift + Enter 可以换行，不会触发发送。适合写多行指令或粘贴代码：

claude> 帮我写一个 Python 函数，要求：

  1. 接收一个列表

  2. 去重

  3. 按字母排序

  4. 返回新列表

第三章 文件与代码操作

3.1 让 AI 读取文件

直接告诉 AI 你想看什么文件，它会自动读取：

claude> 读一下 src/main.py

claude> 看看 pom.xml 里用了什么依赖

claude> 帮我看看 config/ 目录下有哪些文件

AI 会使用内置的 Read、Glob、Grep 工具来查找和读取文件。

3.2 让 AI 编辑文件

告诉 AI 你想改什么，它会自动编辑：

claude> 在 main.py 第 10 行加一个日志输出

claude> 把 UserService.java 里的 findAll 方法改成支持分页

claude> 把所有文件里的 TODO 注释找出来列个表

AI 会使用 Edit 工具精确修改文件，或用 Write 工具创建新文件。

3.3 让 AI 搜索代码

用自然语言描述你要找的内容：

claude> 找到所有调用 getUserById 方法的地方

claude> 搜索包含 password 的配置文件

claude> 找到所有 TODO 和 FIXME 注释

AI 会使用 Grep（正则搜索）和 Glob（文件名匹配）来查找。

3.4 让 AI 创建文件

告诉 AI 你想创建什么：

claude> 在 src/ 下创建一个 utils.py，包含常用的字符串处理函数

claude> 帮我创建一个 Dockerfile

claude> 生成一个 .gitignore 文件

第四章 Git 操作

4.1 查看状态和差异

claude> 帮我看看当前有什么改动

claude> git diff 显示一下我改了什么

claude> 看看最近 5 次提交

4.2 创建提交

告诉 AI 要提交什么，它会自动 stage + commit：

claude> 把我改的文件提交一下，消息写：修复用户登录 bug

AI 会执行：

git add <changed-files>

git commit -m "修复用户登录 bug"

4.3 创建分支和 PR

claude> 创建一个新分支 feature/user-profile

claude> 帮我创建一个 Pull Request

AI 会使用 gh CLI（GitHub CLI）来创建 PR，自动生成标题和描述。

4.4 解决冲突

claude> 帮我解决 merge 冲突

AI 会读取冲突文件，分析两边的改动，帮你合并。

第五章 项目分析与理解

5.1 快速了解项目

claude> 这个项目是做什么的？帮我总结一下

claude> 这个项目的目录结构是什么样的？

claude> 用了哪些技术栈？

claude> 入口文件在哪里？

5.2 代码审查

claude> 帮我审查一下最近的改动，有没有 bug

claude> 看看这个函数有没有性能问题

claude> 检查一下有没有安全漏洞

5.3 架构分析

claude> 这个项目的架构是怎么设计的？

claude> 画一下核心模块的调用关系

claude> 这个项目有哪些设计模式？

第六章 高级功能

6.1 Plan 模式（规划模式）

在做复杂任务前，AI 会先进入 Plan 模式，制定计划让你确认后再执行：

claude> 帮我重构认证模块

AI 会先分析代码，列出重构计划，你确认后才开始改代码。

你也可以主动让 AI 做规划：

claude> 先帮我规划一下怎么做，不要直接改代码

6.2 Worktree 隔离工作区

让 AI 在独立的 git worktree 中工作，不影响你的主分支：

claude> 在 worktree 里帮我实验一下新的实现方式

好处：AI 的改动完全隔离，不满意直接删除 worktree 即可。

6.3 Agent 子任务

AI 可以启动子 Agent 并行处理复杂任务：

claude> 帮我同时检查前端和后端的代码质量问题

AI 会启动多个 Agent，分别处理前端和后端，最后汇总结果。

6.4 定时任务（Cron）

AI 可以设置定时任务，在特定时间执行操作：

claude> 每 5 分钟检查一下 CI 构建状态

claude> 明天早上 9 点提醒我检查部署

6.5 Web 搜索和抓取

AI 可以搜索网页和抓取内容：

claude> 搜索一下 Spring Boot 3 最佳实践

claude> 帮我看看这个 URL 的内容：https://example.com/docs

6.6 记忆系统

Claude Code 有持久化记忆，跨会话保留重要信息：

claude> 记住：这个项目用 MySQL 8.0，编码用 UTF-8

claude> 记住：我偏好函数式编程风格

claude> 你还记得我之前说的项目规范吗？

记忆保存在 ~/.claude/projects/<project>/memory/ 目录下。

第七章 权限管理

7.1 权限模式

Claude Code 有多种权限模式，控制 AI 能自动执行哪些操作：

模式	说明
默认模式	文件读取自动允许，文件修改和命令执行需要确认
信任模式	所有操作自动允许（包括文件修改和命令执行）
只读模式	只能读取文件，不能修改任何内容

7.2 配置自动允许的操作

通过 /config 命令或 settings.json 文件配置：

// settings.json

{

  "permissions": {

    "allow": [

      "Read",

      "Write",

      "Edit",

      "Glob",

      "Grep",

      "Bash(git *)"

    ]

  }

}

settings.json 位置：

• 项目级：.claude/settings.json（只对当前项目生效）
• 用户级：~/.claude/settings.json（对所有项目生效）

7.3 敏感操作确认

以下操作默认需要你手动确认：

• 删除文件（rm、del）
• Git 推送（git push）
• 创建 PR 或 Issue
• 发送消息到外部服务
• force push（git push --force）

第八章 模型与配置

8.1 切换模型

使用 /model 命令切换 AI 模型：

claude> /model

可用的模型包括：

模型	说明
Claude Opus 4.7	最强模型，适合复杂推理和代码生成
Claude Sonnet 4.6	平衡性能和速度
Claude Haiku 4.5	最快模型，适合简单任务
自定义模型	可配置使用其他模型（如 DeepSeek、GPT 等）

8.2 快速模式

使用 /fast 命令切换到快速模式，输出速度更快但可能略微降低质量：

claude> /fast

8.3 环境变量配置

通过环境变量配置 Claude Code：

变量名	作用
ANTHROPIC_API_KEY	设置 API Key
CLAUDE_MODEL	设置默认模型
CLAUDE_MAX_TOKENS	设置最大输出 token 数
HTTP_PROXY	设置 HTTP 代理
HTTPS_PROXY	设置 HTTPS 代理

第九章 常见场景示例

9.1 场景一：快速修复 Bug

claude> 用户反馈登录后显示空白页面，帮我排查并修复

AI 会：读取相关文件 → 分析代码逻辑 → 定位问题 → 修改代码 → 建议测试

9.2 场景二：代码重构

claude> 把 UserService 里的数据库查询逻辑抽到 UserRepository 里

AI 会：分析现有代码 → 制定重构计划 → 逐个方法迁移 → 确保不破坏功能

9.3 场景三：写测试

claude> 给 OrderService 写单元测试，覆盖核心业务逻辑

AI 会：分析 OrderService → 识别关键路径 → 生成测试用例 → 运行测试确认通过

9.4 场景四：项目初始化

claude> 帮我创建一个 Spring Boot 项目，需要用户管理、JWT 认证、MySQL

AI 会：创建项目结构 → 生成 pom.xml → 写配置文件 → 实现基础功能

9.5 场景五：文档生成

claude> 给这个项目生成 API 文档

claude> 帮我写 README.md

claude> 给核心模块写注释

9.6 场景六：性能优化

claude> 这个接口响应很慢，帮我分析并优化

AI 会：分析代码 → 找到瓶颈 → 提出优化方案 → 实施修改

第十章 最佳实践与技巧

10.1 写好提示词

好的提示词能让 AI 更准确地完成任务：

不好的写法	好的写法
帮我改一下代码	把 UserService.java 里的 findAll 方法改成支持分页，参数是 page 和 size
这个有 bug	登录接口在密码错误时返回 500 而不是 401，帮我修复
优化一下	这个查询用了 N+1 查询，帮我改成 JOIN FETCH
写个函数	写一个 Java 函数，接收 List<String>，返回去重后按字母排序的新列表

10.2 分步骤做复杂任务

不要一次性让 AI 做太大的事情，分步骤更可控：

第一步：claude> 先帮我分析一下认证模块的代码结构

第二步：claude> 现在把 token 验证逻辑抽到单独的类里

第三步：claude> 加上 token 过期检查

第四步：claude> 写一下单元测试

10.3 善用 Plan 模式

复杂任务让 AI 先规划再执行，你确认方案后再动手：

claude> 先帮我分析一下怎么重构，列出步骤，不要直接改代码

10.4 利用 ! 执行确认命令

AI 执行命令前，你可以用 ! 先手动跑一下确认结果：

claude> ! npm test

claude> 测试通过了，继续

10.5 使用 /compact 释放上下文

长对话会消耗大量 token，适时压缩：

claude> /compact

AI 会把之前的对话总结成摘要，释放 token 空间。

10.6 创建 CLAUDE.md 项目规范

在项目根目录创建 CLAUDE.md 文件，告诉 AI 项目规范：

# CLAUDE.md

这个项目使用 Spring Boot 3 + Java 17

代码规范：使用 Google Java Style

提交规范：遵循 Conventional Commits

测试：所有 Service 必须有单元测试

AI 每次启动都会读取这个文件，按规范工作。

附录：快捷键速查

快捷键	作用
Enter	发送消息
Shift + Enter	换行（不发送）
Ctrl + C	中断当前 AI 输出
Ctrl + L	清屏
上下方向键	翻看历史输入
Tab	自动补全命令
Ctrl + D	退出 Claude Code

────────────────────────────────────────────────────────────

— 文档结束 —