快速入门¶

本文你会学到：

• 🎯 安装与配置（安装方式、系统要求、认证流程）
• 💬 交互模式操作（REPL 对话、斜杠命令、快捷键、多行输入）
• ⌨️ CLI 命令速查（交互模式与非交互模式的常用写法）
• 🔍 隐藏技巧（/simplify、/insight、双击 ESC 等）

📥 怎么安装 Claude Code？¶

什么是 Claude Code？¶

打个比方：如果你用过 ChatGPT 的网页版，那 Claude Code 就是把「和 AI 对话」这件事搬到了终端（Terminal）里——但它不只是聊天，它还能直接读写你的项目文件、执行命令、操作 Git。你可以把它理解为一个**住在终端里的 AI 编程助手**。

系统要求¶

在安装之前，先确认你的环境满足以下条件：

安装方式¶

Claude Code 提供三种安装方式。对于大多数开发者来说，**原生安装**最简单——它自动更新，不需要 Node.js 等额外依赖。

1

irm https://claude.ai/install.ps1 | iex

1

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

1

winget install Anthropic.ClaudeCode

（v2.1.2 新增）

1

curl -fsSL https://claude.ai/install.sh | bash

1

brew install --cask claude-code

⚠️ 注意：如果你在 PowerShell 中执行 CMD 版的命令，会看到 The token '&&' is not a valid statement separator 错误——这是因为 PowerShell 不支持 &&。请改用 PowerShell 版的命令。判断方法很简单：命令行提示符显示 PS C:\ 就说明你在 PowerShell 中。

Windows 上的两个选项¶

Claude Code 在 Windows 上有两种运行方式：

• 原生 Windows + Git Bash：安装 Git for Windows 后，直接从 PowerShell 或 CMD 启动。Claude Code 内部通过 Git Bash 来执行 shell 命令。不需要管理员权限。支持 x64 和 ARM64 架构（v2.1.41 新增 ARM64 原生二进制）。
• WSL：如果你已经习惯使用 WSL（Windows Subsystem for Linux），Claude Code 在 WSL 1 和 WSL 2 中都可以运行。推荐 WSL 2，因为它支持沙箱（Sandbox）安全特性。

💡 如果 Claude Code 找不到 Git Bash，可以在 settings.json 中手动指定路径：

1
2
3
4
5

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

首次登录与认证¶

安装完成后，在终端输入 claude 就会启动交互模式。第一次使用时，系统会引导你登录。

1
2

claude
# 首次启动会自动弹出浏览器进行登录

支持的账户类型：

登录成功后，凭证会自动保存，后续不需要重复登录。如果需要切换账户，在交互模式中输入 /login 即可。

当浏览器回调无法到达 localhost（如 WSL2、SSH 远程会话或容器环境）时，claude auth login 现在支持在终端中粘贴 OAuth code 来完成认证（v2.1.126 新增），不再需要配置端口转发。

你也可以通过 claude auth 子命令预先认证（v2.1.41 新增）：

1
2
3
4
5

claude auth login              # 标准登录
claude auth login --console    # 使用 API Console 登录
claude auth login --sso        # 强制 SSO 认证
claude auth status --text      # 查看当前登录状态
claude auth logout             # 登出当前账户

更新与卸载¶

原生安装方式会**自动在后台更新**——Claude Code 启动时和运行期间都会检查新版本。你也可以手动触发更新：

1

claude update    # 立即更新到最新版

你还可以通过 /config 切换更新通道（Release Channel）：stable（稳定版）或 latest（最新版，可能包含实验性功能）。（v2.1.3 新增）

如果你需要完全阻止所有更新（包括手动 claude update），可以设置 DISABLE_UPDATES 环境变量（v2.1.118 新增）。它比 DISABLE_AUTOUPDATER 更严格，会阻止一切更新路径。

当你需要彻底清理某个项目的所有 Claude Code 状态时，可以使用 claude project purge（v2.1.126 新增）。它会删除项目的 transcripts、tasks、文件历史和配置条目，支持 --dry-run（预览将删除的内容）、-y/--yes（跳过确认）和 -i/--interactive（交互式选择删除项）等模式。适合清理不再维护的项目或回收磁盘空间。

如果需要卸载：

1
2
3

# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

常见安装问题¶

如果以上方法无法解决问题，运行 claude doctor 获取完整的诊断报告。

💬 怎么跟 Claude Code 对话？——交互模式¶

REPL 对话模式——像聊天一样写代码¶

在项目目录下输入 claude，你就进入了**交互模式**（也叫 REPL 模式）。这个名字来源于编程中的一个经典概念：Read-Eval-Print Loop（读取-求值-打印-循环）——就像对讲机对话：你说一句，对方回一句，来回循环。你输入一句话，Claude 思考后回复，如此往复。

1
2

cd /path/to/your/project
claude

进入后，你会看到欢迎界面，显示当前会话信息、最近对话和更新日志。现在可以直接用自然语言和 Claude 对话了。

💡 Claude Code 会根据你项目的 Git 历史自动生成**输入建议**（灰色提示文字）。按 Tab 或 右方向键 接受建议，也可以直接开始输入自己的内容。

第一次对话：了解你的项目¶

刚进入一个项目时，可以让 Claude 先帮你「摸底」：

1

这个项目是做什么的？

1

用了哪些技术栈？

1

主入口文件在哪里？

Claude 会分析你的项目文件，给出有针对性的回答。

第一次改代码¶

接下来让 Claude 做点实际的事：

1

在主文件里添加一个 hello world 函数

Claude Code 的执行流程是这样的：

1. 定位合适的文件
2. 展示拟修改的内容（Diff 视图）
3. 等待你确认（按 y 接受，或按 n 拒绝）
4. 应用修改

⚠️ 这就是 Claude Code 和普通 AI 聊天的核心区别——它不只是「说」，还会「做」，但每次操作都会征求你的同意。

Git 操作也能用自然语言¶

1

我改了哪些文件？

1

帮我提交代码，写个描述性的 commit message

1

创建一个叫 feature/login 的分支

快速命令前缀¶

除了自然语言对话，Claude Code 还支持几个特殊的前缀字符来快速切换模式：

! 前缀特别实用——当你只想快速跑一条 shell 命令，但又希望结果留在对话上下文中时，直接 ! 命令 即可，不需要 Claude 介入解释和审批。Bash 模式下支持 Tab 补全命令（v2.0.10 新增），还能根据历史命令进行智能补全（v2.1.14 改进）。

多行输入¶

写代码时经常需要输入多行内容。Claude Code 提供了几种方式：

💡 在 Claude Code 内部运行 /terminal-setup 可以自动为 VS Code、Alacritty、Zed、Kitty、Warp 等终端配置 Shift+Enter（v2.0.74 扩展了多终端支持）。

常用斜杠命令¶

在交互模式中输入 / 就能看到所有可用命令。以下是最常用的：

💡 斜杠命令支持在输入的**任意位置**触发自动补全，不限于行首输入 /（v2.1.0 改进）。原有的 /vim 命令已在 v2.1.92 移除，Vim 编辑模式现通过 /config → Editor mode 切换。

📌 /btw 是一个很巧妙的设计：它能看到当前对话的完整上下文，但回答后不会写入对话历史。适合在 Claude 正在忙的时候插一句「刚才那个配置文件叫什么来着？」。

会话恢复¶

Claude Code 的对话是**按项目目录**保存的。你可以随时恢复之前的对话：

1
2
3
4

claude -c                  # 继续当前目录最近一次对话
claude -r                  # 交互式选择要恢复的会话
claude -r "auth-refactor"  # 恢复名为 "auth-refactor" 的会话
claude -n "my-feature"     # 给当前会话命名，方便以后恢复

使用 /clear 清除当前对话后，之前的对话仍然保存在磁盘上，随时可以恢复。/resume 界面支持按分支过滤和搜索（v2.0.27 新增），快速定位目标会话。

键盘快捷键¶

掌握快捷键能大幅提升使用效率。以下是按使用频率整理的核心快捷键：

通用控制¶

文本编辑¶

💡 Ctrl+R 搜索历史命令时，按 Ctrl+R 可以在匹配结果中继续向前翻，按 Tab 接受当前匹配，按 Enter 直接执行。

自定义快捷键¶

如果你对默认快捷键不满意，可以通过配置文件自定义。运行 /keybindings 会创建或打开 ~/.claude/keybindings.json：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

将某个动作设为 null 即可解绑默认快捷键。配置支持多种上下文（Chat、Global、Autocomplete、Confirmation 等），每个上下文下有不同的可用动作。

⚠️ 以下三个快捷键**不能重新绑定**：Ctrl+C（中断）、Ctrl+D（退出）、Ctrl+M（等同于 Enter）。

终端配置建议¶

主题匹配¶

Claude Code 的界面主题通过 /config 命令设置。它无法控制终端本身的颜色方案，但你可以在 /config 中将 Claude Code 的主题调整为与终端一致。

可点击的文件路径¶

在支持 OSC 8 超链接协议的终端（如 iTerm2、Windows Terminal 等）中，Claude Code 输出的文件路径会自动变为可点击链接，点击即可在编辑器中打开。（v2.1.2 新增）

减少闪烁¶

如果长时间使用时出现画面闪烁或滚动位置跳动，可以启用全屏渲染模式：

1
2

# 设置环境变量
export CLAUDE_CODE_NO_FLICKER=1

或者在 settings.json 中配置：

1
2
3
4
5

{
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

大段内容处理¶

当需要让 Claude 处理大段代码或长文本时：

• 避免直接粘贴很长的内容——Claude Code 可能处理困难
• 把内容写到文件里，然后让 Claude 读取文件
• 注意 VS Code 内置终端对长粘贴内容的截断问题更严重

⌨️ 有哪些常用命令？——CLI 参考¶

常用命令速查表格¶

Claude Code 的命令可以分为两类：**启动交互模式**的命令和**执行一次性任务**的命令。

启动类命令¶

一次性任务命令（非交互模式）¶

认证与诊断¶

非交互模式——管道与脚本¶

-p（--print）标志是 Claude Code 的非交互模式。它在自动化场景中非常实用，因为你可以把输出通过管道传递给其他工具。

管道处理¶

最经典的用法是把文件内容通过管道传给 Claude 分析：

1
2
3
4
5
6
7
8

# 分析日志文件
cat error.log | claude -p "分析这些错误日志，找出根本原因"

# 代码审查
git diff | claude -p "审查这次变更，提出改进建议"

# 生成 commit message
git diff --staged | claude -p "根据这些变更生成一个规范的 commit message"

结构化输出¶

-p 模式支持多种输出格式，适合在脚本中进一步处理：

1
2
3
4
5
6
7
8

# JSON 格式输出
claude -p "列出项目中所有 TODO 注释" --output-format json

# 流式 JSON（适合程序实时处理）
claude -p "分析代码结构" --output-format stream-json

# 指定 JSON Schema（获取结构化数据）
claude -p "分析依赖版本" --json-schema '{"type":"object","properties":{...}}'

脚本中的常用标志¶

💡 --bare 模式特别适合 CI/CD 场景——它会跳过 Hooks、Skills、Plugins、MCP 服务器、自动记忆和 CLAUDE.md 的加载，让 Claude 只保留基础的 Bash、文件读取和编辑能力，启动速度更快。

📝 小结：日常开发中，用 claude 进入交互模式进行探索式工作，用 claude -p 在脚本和管道中进行自动化操作。两者配合使用，能覆盖绝大多数场景。

🎯 还有哪些隐藏技巧？¶

除了前面介绍的核心命令，Claude Code 还有一些不太显眼但非常实用的功能。

/simplify：三维代码质量检查¶

对刚改完的代码做三维检查——代码复用、质量和效率，发现问题直接修掉。特别适合改完一段逻辑后立刻跑一遍，代替手动 review。

典型用法：

1
2

# 刚写完一段新逻辑后，跑一遍质量检查
/simplify

Claude 会检查当前对话中修改过的文件，找出重复代码、低效实现和潜在问题，然后直接给出修复建议。你也可以指定关注点：

1
2

# 只关注性能问题
/simplify focus on performance

/btw：不打断主任务的旁路问答¶

在不打断主任务的前提下快速问一个侧问题。适合"两个命令有什么区别"这类单轮旁路问答，不适合需要读仓库或调用工具的问题。

/insight：提炼会话中的沉淀¶

让 Claude 分析当前会话，提炼出哪些内容值得沉淀到 CLAUDE.md。用法是会话做了一段之后跑一次，它会指出「这个约定你们反复提到，但没有写进契约」之类的盲点，是迭代优化 CLAUDE.md 的好手段。

适合在以下场景使用：

• 一次较长的调试会话后，提炼出发现的编码规范和注意事项
• 完成新功能开发后，把项目结构和架构决策的共识写入 CLAUDE.md
• 多轮对话中反复纠正 Claude 的同一类错误时，用 /insight 把规则固化下来

双击 ESC：编辑上一条消息¶

按两次 ESC 可以回到上一条输入重新编辑，不用重新手打。Claude 走偏了、或者上一句话没说清楚，双击 ESC 修改后重发，比重新开会话省事得多。

会话历史：所有对话都在本地¶

所有会话记录存放在 ~/.claude/projects/ 下，文件夹名按项目路径命名（斜杠变横杠），每个会话是一个 .jsonl 文件。

1
2
3
4
5

# 找某个话题的历史讨论
grep -rl "关键词" ~/.claude/projects/

# 或者直接让 Claude 帮你搜
# "帮我搜一下之前关于认证配置的讨论"

💡 这意味着你的对话历史不会被上传到云端，完全在本地，隐私有保障。