适合先读

第一次使用 Claude Code，先看这一页就够了。

安装

Claude Code 通常通过 npm 安装：

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

安装后确认命令可用：

claude --version

如果只是临时试用，也可以用 npx：

npx @anthropic-ai/claude-code

登录

第一次运行时，Claude Code 会引导你登录 Anthropic 账号。通常直接执行：

claude

然后按终端提示完成浏览器登录。

在项目中启动

先进入你的项目目录：

cd path/to/your-project

再启动 Claude Code：

claude

进入后，你可以直接用自然语言提问：

先帮我了解这个项目的结构，不要修改文件。

一次性提问

如果你不想进入交互界面，也可以直接问一个问题：

claude "这个项目怎么启动？"

适合问简单问题；如果要连续讨论、改代码或检查多处文件，建议直接运行 claude 进入交互模式。

退出和重新开始

常用操作：

操作	用法
查看帮助	/help
清空当前上下文	/clear
退出 Claude Code	/exit

当一次对话已经聊了很多、Claude 开始混淆旧任务时，可以用 /clear 开一个干净上下文。

恢复中断的对话

如果你不小心用 Ctrl + C 或 Command + C 退出了对话，不用慌，对话记录会自动保存。

恢复最近一次对话（最常用）：

claude --continue
# 或简写
claude -c

执行后会直接加载上一次的会话，包括中断前的所有上下文。

从历史列表中选择恢复：

claude --resume

会打开一个交互式列表，用方向键选择要恢复的会话，按回车即可。

对话存储位置： 所有对话记录明文存储在 ~/.claude/projects/ 目录下。

可视化工具浏览历史： 如果想更方便地浏览和搜索所有历史对话，可以使用社区工具：

npx @ibootz/claude-code-viewer@latest

启动后会在浏览器中打开界面，支持按项目浏览、关键词搜索，找到目标会话后可直接复制恢复命令。

小技巧

下次如果想中断任务但不想丢失上下文，可以用 Esc 暂停 Claude，或 Esc + Esc 回退到之前的步骤，这些操作不会丢失上下文。

IDE 中使用

除了终端，Claude Code 也支持在 IDE 中使用：

IDE	方式
VS Code	安装 Claude Code 扩展，在侧边栏打开
JetBrains (IntelliJ、WebStorm 等)	安装 Claude Code 插件

IDE 中的体验和终端类似，但更方便在编辑器中查看和对比代码改动。如果日常主要用 IDE 开发，推荐直接在 IDE 里使用。

排障

遇到安装或登录异常时，可以先用 /doctor 检查：

/doctor

它会检查常见问题（Node 版本、网络、登录状态等），并给出修复建议。

如果 claude 命令找不到，确认安装路径在 PATH 中：

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

第一次可以这样问

请先阅读项目结构，告诉我这个项目的技术栈、启动方式和主要目录。暂时不要改代码。

我想熟悉这个项目，请按新同事入职的方式带我过一遍关键文件。

帮我找一下页面入口在哪里，并说明从入口到主要页面组件的调用链路。