Claude Code的使用
本文最后更新于 2026年1月8日 晚上
本文主要分享了Claude Code的使用流程和技巧,主要摘自Claude官方文档。
Claude Code
快速开始
-
安装:
-
macOS, Linux, WSL:
1
curl -fsSL https://claude.ai/install.sh | bash -
Windows PowerShell:
1
irm https://claude.ai/install.ps1 | iex -
Windows CMD:
1
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
-
-
登录:
1
2
3
4claude
# You'll be prompted to log in on first use
/login
# Follow the prompts to log in with your account登录后,您的登录凭证将被保存,无需再次登录。
首次使用 Claude Console 帐户验证 Claude Code 时,系统会自动创建一个名为“Claude Code”的工作区。该工作区可集中跟踪和管理您组织内所有 Claude Code 使用情况的成本。
您可以使用同一个邮箱地址注册两种类型的账户。如果您需要重新登录或切换账户,请在 Claude Code 中使用
/login命令。 -
开始:
1
2cd /path/to/your/project
claude您将看到 Claude Code 欢迎界面,其中包含您的会话信息、最近的对话和最新更新。输入
/help查看可用命令,或/resume继续之前的对话。 -
(可选)启动 Claude Code 时,您可以恢复之前的会话:
claude --continue继续当前目录中的最新对话claude --resume打开对话选择器或按姓名选择对话- 在当前会话中,使用
/resume切换到不同的对话。
在会话期间使用
/rename为其指定一个易于记忆的名称:1
> /rename auth-refactor -
配置:
-
提出问题:
1
2
3what can Claude Code do?
what does this project do?
add a hello world function to the main fileClaude Code 会根据需要读取您的文件,无需您手动添加上下文。Claude 还拥有自己的文档,可以解答有关其功能和特性的问题。
Claude Code 在修改文件前始终会征求您的许可。您可以批准单个更改,也可以为当前会话启用“全部接受”模式。
-
完成。
终端命令
claude: 启动交互模式claude -v: 输出版本号exitorCtrl+C: 退出claude -c: 继续最近的对话claude -r: 继续之前的对话claude update: 更新至最新版本claude --add-dir ../apps ../lib: 为 Claude 添加其他可访问的工作目录(验证每个路径是否存在于目录中)
键盘快捷键
-
按“
?查看所有可用的键盘快捷键 -
使用
Tab键完成命令。 -
按
↑键查看命令历史记录 -
输入
/查看所有斜杠命令 -
Ctrl+C: 取消当前输入或生成 -
Ctrl+L: 清除终端屏幕(保留对话记录) -
Ctrl+O: 切换详细输出(详细展示了工具的使用和执行过程) -
Ctrl+R: 反向搜索命令历史记录 -
Esc+Esc: 将代码和/或对话恢复到之前的状态 -
Shift+Tab或Alt+M(某些配置): 在自动接受(Auto-Accept)模式、计划(Plan)模式和普通(normal)模式之间切换 -
Option+P(macOS) orAlt+P(Windows/Linux): 切换模型(无需清除提示) -
\ + Enter: Quick escape -
Shift+Enter: 多行输入在终端设置中配置您偏好的换行行为。运行
/terminal-setup为 iTerm2 和 VS Code 终端安装 Shift+Enter 快捷键绑定。 -
!at start: 直接运行命令并将执行输出添加到会话中 -
@: 触发文件路径自动补全1
2
3
4
5
6
7
8
9
10
11# Reference a specific file
> Review the implementation in @src/utils/helpers.js
# Reference multiple files
> Compare @src/old-version.js with @src/new-version.js
# Reference a directory
> What's the structure of @src/components?
# Reference MCP resources
> Show me the data from @github:repos/owner/repo/issues -
等等。
斜杠命令
/help: 查看可用命令/login: 登录/logout: 登出/config: 打开设置界面(配置选项卡)/status: 打开设置界面(状态选项卡),显示版本、型号、帐户和连接状态/statusline: 设置 Claude Code 的状态栏 UI/terminal-setup: 安装 Shift+Enter 键绑定以输入换行符(仅限 iTerm2 和 VSCode)/model: 选择或更改AI模型/rename <name>: 重命名当前会话以便于识别/resume: 继续之前的对话/resume [session]: 通过 ID 或名称继续对话,或打开会话选择器/clear: 清除对话历史/export [filename]: 将当前对话导出到文件或剪贴板/exit: 退出REPL(交互式编程环境)/add-dir: 添加其他工作目录/agents: 管理用于特定任务的自定义 AI 子代理/compact [instructions]: 简短对话,可选重点说明/context: 将当前上下文使用情况可视化为彩色网格/cost: 显示代币使用统计信息/stats: 可视化每日使用情况、会话历史记录、连续使用天数和型号偏好/usage: 仅限订阅计划:显示计划使用限制和速率限制状态/doctor: 检查您的 Claude Code 安装的健康状况/review: 请求代码审查/rewind: 回溯对话和/或代码/todos: 列出当前待办事项
/resume
| Shortcut | Action |
|---|---|
↑ / ↓ |
在会话之间导航 |
→ / ← |
展开或折叠分组会话 |
Enter |
选择并继续执行高亮显示的会话 |
P |
预览会话内容 |
R |
重命名突出显示的会话 |
/ |
搜索以筛选会话 |
A |
在当前目录和所有项目之间切换 |
B |
筛选当前 Git 分支中的会话 |
Esc |
退出选择器或搜索模式 |
检查点Checkpoint
Claude Code 会在您工作时自动跟踪 Claude 的文件编辑,让您可以快速撤销更改并回滚到之前的状态,以防出现任何问题。
Claude Code 会跟踪其文件编辑工具所做的所有更改:
- 每个用户提示都会创建一个新的检查点
- 检查点会在会话之间保留,因此您可以在恢复的对话中访问它们。
- 30天后自动清理会话数据(可配置)
按两次 Esc ( Esc + Esc )或使用 /rewind 命令打开回退菜单。您可以选择恢复:
- 仅对话(Conversation only) :回溯到用户消息,同时保留代码更改
- 仅代码(Code only) :还原文件更改,同时保持对话不变
- 代码和对话(Both code and conversation) :将两者都恢复到会话中的先前状态。
配置
配置文件
- 用户:
~/.claude/ - 项目:
.claude/
模型配置
可选型号
在 Claude Code 中,您可以配置 model 设置中的以下两种方式之一:
- 模型别名
- 模型名称
- Anthropic API:完整的**模型名称**
- Bedrock: an inference profile ARN
- Foundry: a deployment name
- Vertex: a version name
模型别名
| 模型别名 | 行为 |
|---|---|
default |
根据您的账户类型,推荐的模型设置 |
sonnet |
日常编码任务使用最新的 Sonnet 模型(目前为 Sonnet 4.5)。 |
opus |
使用 Opus 模型(目前为 Opus 4.5)处理专门的复杂推理任务 |
haiku |
使用快速高效的俳句模型来完成简单的任务 |
sonnet[1m] |
使用 Sonnet,并配备 100 万个令牌的上下文窗口,以支持长时间会话。 |
opusplan |
特殊模式:在计划模式下使用 opus ,然后切换到 sonnet 执行。 |
设置模型
您可以通过多种方式配置模型,以下按优先级排序:
-
会话期间 - 使用
/model <alias|name>在会话中切换模型1
2# Switch to Sonnet during session
/model sonnet -
启动时 - 使用
claude --model <alias|name>启动1
2# Start with Opus
claude --model opus -
环境变量 - 设置
ANTHROPIC_MODEL=<alias|name> -
Settings - Configure permanently in your settings file using the
modelfield.1
2
3
4
5
6{
"permissions": {
...
},
"model": "opus"
} -
完成。
使用 [1m]扩展上下文
对于控制台/API 用户,可以在完整的模型名称后添加 [1m] 后缀。 启用 100 万个令牌上下文窗口 。
1 | |
注意:扩展上下文模型具有 不同的定价方式 。
检查您当前的型号
您可以通过以下几种方式查看您当前使用的型号:
- 在状态栏中(如果已配置)
- 在
/status中,还会显示您的帐户信息。
计划模式
计划模式指示 Claude 通过只读操作分析代码库来创建计划,非常适合探索代码库、规划复杂的更改或安全地审查代码。
何时使用计划模式:
- 多步骤实现:当你的功能需要编辑多个文件时
- 代码探索:在进行任何更改之前,想要彻底研究代码库。
- 交互式开发:当你想要与克劳德一起迭代开发方向时
1 | |
Work with images
假设你需要在代码库中处理图像,并且你想让 Claude 帮助你分析图像内容。
在对话中添加图片
您可以使用以下任何一种方法:
- 将图像拖放到 Claude Code 窗口中
- 复制图片并使用 Ctrl+V 将其粘贴到命令行界面 (不要使用 Cmd+V)
- 请向 Claude 提供图像路径。例如:“分析此图像:/path/to/your/image.png”
请克劳德分析这张图片
1 | |
Tips
- 当文字描述不够清晰或过于冗长时,请使用图片。
- 请提供errors截图、用户界面设计图或图表,以便更好地说明情况。
- 您可以在对话中使用多张图片。
使用扩展思维(思考模式)
扩展思维模式会预留一部分总输出代币预算,供克劳德逐步推理解决复杂问题。这种推理过程在详细模式下可见,您可以使用 Ctrl+O 切换该模式。、
扩展思维对于复杂的架构决策、棘手的 bug、多步骤实施计划以及评估不同方法之间的权衡尤为重要。它为探索多种解决方案、分析极端情况和自我纠正错误提供了更多空间。
Sonnet 4.5 和 Opus 4.5 默认启用“思考”功能。其他所有型号默认禁用“思考”功能。使用
/model查看或切换当前型号。
你可以通过以下几种方式配置 Claude Code 的思考模式:
| 范围 | 如何启用 | 细节 |
|---|---|---|
| 切换快捷方式 | 按 Option+T (macOS)或 Alt+T (Windows/Linux) |
切换思考模式开启/关闭。可能需要在终端中进行配置以启用 Option 键快捷键。 |
| 全局默认 | 使用 /config 切换思考模式 |
设置所有项目的默认值。将 alwaysThinkingEnabled 保存到 ~/.claude/settings.json |
| 环境变量覆盖 | 设置 MAX_THINKING_TOKENS 环境变量 |
设置后,将自定义令牌预算应用于所有请求,覆盖您的思考模式配置。例如: export MAX_THINKING_TOKENS=1024 |
您可以在消息中包含 ultrathink 作为关键词,以便针对单个请求启用思考功能:
1 | |
仅当未设置
MAX_THINKING_TOKENS时,ultrathink关键字才有效。如果配置了MAX_THINKING_TOKENS,则该关键字具有更高的优先级,并控制所有请求的思考预算。
“think”, “think hard”, and “think more”等其他短语被解释为常规提示指令,不分配thinking tokens。
要查看克劳德的思考过程,请按
Ctrl+O切换到详细模式,即可看到以灰色斜体文本显示的内部推理。
将 Git 与 Claude Code 结合使用
1 | |
小技巧
-
将复杂任务分解成若干步骤。
-
在进行任何修改之前,请先让 Claude 理解你的代码:
1
2analyze the database schema
build a dashboard showing products that are most frequently returned by our UK customers -
等等。
Claude Code for VS Code
VS Code 扩展为 Claude Code 提供了一个原生图形界面,并直接集成到您的 IDE 中。这是在 VS Code 中使用 Claude Code 的推荐方式。
您需要一个 Anthropic 帐户(首次打开扩展程序时需要登录)。如果您使用的是 Amazon Bedrock 或 Google Vertex AI 等第三方提供商,请参阅 “改用第三方提供商” 部分。
您无需事先安装 Claude Code CLI。但是,某些功能(例如 MCP 服务器配置)需要 CLI。有关详细信息,请参阅 VS Code 扩展与 Claude Code CLI 的比较 。
Claude Code + VSCode
我的想法是,使用CLI 版 Claude Code 编写代码,使用VSCode配合Git实现对代码的审查和微调,你觉得怎么样?
这个组合很合理,让 CLI 版 Claude Code 负责“推进任务与批量改动”,让 VSCode+Git 负责“可视化审查、逐块微调、拆分提交”。
我建议你把流程稍微工程化一下,效果会更稳定。
推荐工作流(CLI 主写 + VSCode 审查微调)
- 先建分支
git checkout -b feature/<name>
- 用 Claude Code 做“计划→第一版落地”
给它明确约束:
- 先输出:要改/新增哪些文件、每个文件改什么、风险点
- 再开始写代码
- 每一轮改动控制在“能编译通过/能跑最小 demo”的范围
- 本地构建与最小验证(每轮必做)
cmake/make -j或你项目的标准构建方式- 跑一个最小数据集/示例(哪怕只验证程序启动、配置读取、关键模块初始化不崩)
把完整编译错误/运行日志贴回给 Claude Code 让它迭代修复(C++ 这是效率关键)。
- VSCode 打开 diff 做审查与微调
在 VSCode 里重点看:
- 头文件/实现的一致性、include 依赖、命名空间、
const/引用/移动语义 - Eigen/OpenCV 对齐与拷贝(如
EIGEN_MAKE_ALIGNED_OPERATOR_NEW、cv::Mat传参) - 线程安全(ORB_SLAM3 的 Tracking/LocalMapping/LoopClosing 多线程边界)
- 日志与错误处理(不要 silent fail)
- 风格:clang-format、命名、注释、TODO
- 拆分 commit(强烈建议)
500 行很容易“一个 commit 糊一坨”,后期回滚/审阅痛苦。建议至少拆成:
- commit 1:基础骨架/接口/新文件/CMake 接入(可编译)
- commit 2:核心功能实现(可运行)
- commit 3:参数/配置/文档/示例与清理(可复现)
CLI 让它改大块,VSCode 负责把改动拆干净。
这样做的主要好处
- 效率:CLI agent 擅长跨文件铺开与反复修编译错误。
- 质量可控:VSCode diff + 你亲自把关,避免 agent 引入“看起来对但不稳”的改动。
- 可追溯:合理拆 commit,后续你自己或社区 review 都更容易。
两个容易踩的坑(提前规避)
-
让 agent 一次改太多
建议你在提示里限定“每轮最多改 N 个文件/一个子模块”,并要求它先列计划、你确认后再动手。 -
只靠静态推理不跑程序
ORB_SLAM3 这种工程不跑就会留下链接错误、竞态、配置不一致等问题。至少要把“编译通过 + demo 启动”作为每轮门槛。