Claude Code的使用

本文最后更新于 2026年1月8日 晚上

本文主要分享了Claude Code的使用流程和技巧,主要摘自Claude官方文档。

Claude Code

Claude Code 主页

Claude Code 帮助文档

快速开始

  1. 安装:

    • 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
  2. 登录:

    1
    2
    3
    4
    claude
    # 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 命令。

  3. 开始:

    1
    2
    cd /path/to/your/project
    claude

    您将看到 Claude Code 欢迎界面,其中包含您的会话信息、最近的对话和最新更新。输入 /help 查看可用命令,或 /resume 继续之前的对话。

  4. (可选)启动 Claude Code 时,您可以恢复之前的会话:

    • claude --continue 继续当前目录中的最新对话
    • claude --resume 打开对话选择器或按姓名选择对话
    • 在当前会话中,使用 /resume 切换到不同的对话。

    在会话期间使用 /rename 为其指定一个易于记忆的名称:

    1
    > /rename auth-refactor
  5. 配置:

  6. 提出问题:

    1
    2
    3
    what can Claude Code do?
    what does this project do?
    add a hello world function to the main file

    Claude Code 会根据需要读取您的文件,无需您手动添加上下文。Claude 还拥有自己的文档,可以解答有关其功能和特性的问题。

    Claude Code 在修改文件前始终会征求您的许可。您可以批准单个更改,也可以为当前会话启用“全部接受”模式。

    面对不同需求时常用的工作流程

  7. 完成。

终端命令

  • claude: 启动交互模式
  • claude -v: 输出版本号
  • exit or Ctrl+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+TabAlt+M (某些配置): 在自动接受(Auto-Accept)模式、计划(Plan)模式和普通(normal)模式之间切换

  • Option+P (macOS) or Alt+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天后自动清理会话数据(可配置)

按两次 EscEsc + 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 执行。

设置模型

您可以通过多种方式配置模型,以下按优先级排序:

  1. 会话期间 - 使用 /model <alias|name> 在会话中切换模型

    1
    2
    # Switch to Sonnet during session
    /model sonnet
  2. 启动时 - 使用 claude --model <alias|name> 启动

    1
    2
    # Start with Opus
    claude --model opus
  3. 环境变量 - 设置 ANTHROPIC_MODEL=<alias|name>

  4. Settings - Configure permanently in your settings file using the model field.

    1
    2
    3
    4
    5
    6
    {
    "permissions": {
    ...
    },
    "model": "opus"
    }
  5. 完成。

使用 [1m]扩展上下文

对于控制台/API 用户,可以在完整的模型名称后添加 [1m] 后缀。 启用 100 万个令牌上下文窗口

1
2
# Example of using a full model name with the [1m] suffix
/model anthropic.claude-sonnet-4-5-20250929-v1:0[1m]

注意:扩展上下文模型具有 不同的定价方式

检查您当前的型号

您可以通过以下几种方式查看您当前使用的型号:

  1. 状态栏中(如果已配置)
  2. /status 中,还会显示您的帐户信息。

计划模式

计划模式指示 Claude 通过只读操作分析代码库来创建计划,非常适合探索代码库、规划复杂的更改或安全地审查代码。

何时使用计划模式:

  • 多步骤实现:当你的功能需要编辑多个文件时
  • 代码探索:在进行任何更改之前,想要彻底研究代码库。
  • 交互式开发:当你想要与克劳德一起迭代开发方向时
1
> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

Work with images

假设你需要在代码库中处理图像,并且你想让 Claude 帮助你分析图像内容。

在对话中添加图片

您可以使用以下任何一种方法:

  1. 将图像拖放到 Claude Code 窗口中
  2. 复制图片并使用 Ctrl+V 将其粘贴到命令行界面 (不要使用 Cmd+V)
  3. 请向 Claude 提供图像路径。例如:“分析此图像:/path/to/your/image.png”

请克劳德分析这张图片

1
2
3
> What does this image show?
> Here's a screenshot of the error. What's causing it?
> Generate CSS to match this design mockup

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
> ultrathink: design a caching layer for our API

仅当未设置 MAX_THINKING_TOKENS 时, ultrathink 关键字才有效。如果配置了 MAX_THINKING_TOKENS ,则该关键字具有更高的优先级,并控制所有请求的思考预算。

“think”, “think hard”, and “think more”等其他短语被解释为常规提示指令,不分配thinking tokens。

要查看克劳德的思考过程,请按 Ctrl+O 切换到详细模式,即可看到以灰色斜体文本显示的内部推理。

将 Git 与 Claude Code 结合使用

1
2
3
4
what files have I changed?
commit my changes with a descriptive message
create a new branch called feature/quickstart
help me resolve merge conflicts

小技巧

  • 将复杂任务分解成若干步骤。

  • 在进行任何修改之前,请先让 Claude 理解你的代码:

    1
    2
    analyze 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 审查微调)

  1. 先建分支
  • git checkout -b feature/<name>
  1. 用 Claude Code 做“计划→第一版落地”
    给它明确约束:
  • 先输出:要改/新增哪些文件、每个文件改什么、风险点
  • 再开始写代码
  • 每一轮改动控制在“能编译通过/能跑最小 demo”的范围
  1. 本地构建与最小验证(每轮必做)
  • cmake / make -j 或你项目的标准构建方式
  • 跑一个最小数据集/示例(哪怕只验证程序启动、配置读取、关键模块初始化不崩)

完整编译错误/运行日志贴回给 Claude Code 让它迭代修复(C++ 这是效率关键)。

  1. VSCode 打开 diff 做审查与微调
    在 VSCode 里重点看:
  • 头文件/实现的一致性、include 依赖、命名空间、const/引用/移动语义
  • Eigen/OpenCV 对齐与拷贝(如 EIGEN_MAKE_ALIGNED_OPERATOR_NEWcv::Mat 传参)
  • 线程安全(ORB_SLAM3 的 Tracking/LocalMapping/LoopClosing 多线程边界)
  • 日志与错误处理(不要 silent fail)
  • 风格:clang-format、命名、注释、TODO
  1. 拆分 commit(强烈建议)

500 行很容易“一个 commit 糊一坨”,后期回滚/审阅痛苦。建议至少拆成:

  • commit 1:基础骨架/接口/新文件/CMake 接入(可编译)
  • commit 2:核心功能实现(可运行)
  • commit 3:参数/配置/文档/示例与清理(可复现)

CLI 让它改大块,VSCode 负责把改动拆干净。

这样做的主要好处

  • 效率:CLI agent 擅长跨文件铺开与反复修编译错误。
  • 质量可控:VSCode diff + 你亲自把关,避免 agent 引入“看起来对但不稳”的改动。
  • 可追溯:合理拆 commit,后续你自己或社区 review 都更容易。

两个容易踩的坑(提前规避)

  1. 让 agent 一次改太多
    建议你在提示里限定“每轮最多改 N 个文件/一个子模块”,并要求它先列计划、你确认后再动手。

  2. 只靠静态推理不跑程序
    ORB_SLAM3 这种工程不跑就会留下链接错误、竞态、配置不一致等问题。至少要把“编译通过 + demo 启动”作为每轮门槛。


Claude Code的使用
http://zeyulong.com/posts/87fd2580/
作者
龙泽雨
发布于
2026年1月8日
许可协议