1. 引言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，能够在终端中直接理解代码仓库、执行命令、读写文件，帮助开发者高效完成编码任务。本文总结 Claude Code 的常用操作，帮助新手快速上手，也方便老手随时查阅。

2. 安装与启动

2.1 安装

方式一：官方源安装

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

方式二：使用国内镜像安装

由于网络原因，直接从官方源安装可能较慢或失败，推荐使用国内镜像源。以淘宝镜像（npmmirror）为例：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

也可以先永久设置 npm 镜像源，再执行安装：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

其他常用国内镜像源：

镜像源	地址
淘宝（npmmirror）	https://registry.npmmirror.com
腾讯云	https://mirrors.cloud.tencent.com/npm/
华为云	https://repo.huaweicloud.com/repository/npm/

安装完成后，在终端输入 claude 即可启动交互式会话。

2.2 首次启动

首次启动时，Claude Code 会引导你完成登录授权。登录后即可在项目目录中直接使用。

免密码登录

Claude Code 支持通过 API Key 实现免密码登录，无需每次输入账号密码。推荐使用环境变量方式配置：

export ANTHROPIC_API_KEY=你的_API_Key

也可以将 API Key 写入 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc），实现永久生效：

echo 'export ANTHROPIC_API_KEY=你的_API_Key' >> ~/.bashrc
source ~/.bashrc

配置完成后，直接运行 claude 即可免登录进入会话，无需再走浏览器授权流程。

3. 常用交互操作

3.1 基础对话

在终端直接输入自然语言指令即可与 Claude Code 对话，例如：

帮我看看这个项目的结构

3.2 常用斜杠命令

命令	作用
/help	查看帮助文档
/clear	清空当前会话上下文
/compact	压缩对话历史，节省上下文空间
/cost	查看当前会话的 Token 消耗
/init	在项目中初始化 Claude Code 配置
/review	让 Claude Code 审查最近的代码改动
/doctor	检查环境配置是否正常
/login	重新登录账号
/logout	退出登录
/status	查看当前会话状态

3.3 快捷键

快捷键	作用
Ctrl+C	中断当前操作
Ctrl+D	退出 Claude Code
Esc	取消当前输入
↑ / ↓	浏览历史输入

4. 文件与代码操作

4.1 读取文件

读取 src/main.py 的内容

4.2 编辑文件

在 utils.py 中新增一个函数，用于计算两个数的和

4.3 创建新文件

创建一个 README.md，介绍这个项目的用途

4.4 搜索代码

在项目中搜索所有使用了 requests 库的地方

4.5 运行命令

运行 npm test 看看测试是否通过

5. 代码审查与调试

5.1 代码审查

审查我最近的改动，指出潜在问题

5.2 解释代码

解释一下 src/auth.py 中 login 函数的逻辑

5.3 生成测试

为 calculator.py 中的 add 函数编写单元测试

5.4 修复 Bug

运行测试后报错了，帮我分析并修复

6. 进阶用法

6.1 使用 CLAUDE.md 定义项目规范

在项目根目录创建 CLAUDE.md 文件，写入项目说明、代码风格、常用命令等，Claude Code 会自动读取并遵循这些规范。

# 项目规范

- 使用 TypeScript 编写代码
- 使用 pnpm 作为包管理器
- 测试文件放在 __tests__ 目录下

6.2 使用 --continue 继续上次会话

claude --continue

6.3 使用 -p 模式执行一次性任务

claude -p "总结一下 CHANGELOG.md 中的更新内容"

6.4 切换大模型

Claude Code 支持在启动时或会话中切换不同的大模型，常用方式如下。

启动时指定模型

使用 --model 参数指定本次会话使用的模型：

claude --model claude-sonnet-4-5

常用模型标识示例：

模型标识	说明
claude-opus-4-1	最强推理模型，适合复杂任务
claude-sonnet-4-5	性能与速度均衡，日常推荐
claude-haiku-4-5	轻量快速，适合简单任务

使用 DeepSeek 大模型

Claude Code 也支持接入 DeepSeek 等第三方模型。通过环境变量指定 DeepSeek 的 API 地址与 Key 即可：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=你的_DeepSeek_API_Key
export ANTHROPIC_MODEL=deepseek-chat

配置完成后，启动 Claude Code 便会默认使用 DeepSeek 模型。也可以在启动时临时指定：

claude --model deepseek-chat

提示：DeepSeek 提供 Anthropic 兼容接口，因此可直接复用 Claude Code 的调用方式，无需额外插件。

会话中切换模型

在交互式会话中，使用 /model 命令即可随时切换模型：

/model

执行后会弹出模型选择列表，用方向键选择目标模型并回车确认即可。

通过环境变量指定默认模型

在 shell 配置文件中设置环境变量，可让每次启动都默认使用指定模型：

export ANTHROPIC_MODEL=claude-sonnet-4-5

查看当前模型

使用 /status 命令可以查看当前会话正在使用的模型及其他状态信息。

7. 实用技巧

7.1 善用 /compact 节省上下文

当对话较长时，使用 /compact 压缩历史，避免上下文溢出。

7.2 明确指定文件路径

提问时尽量带上具体文件路径，能让 Claude Code 更精准地定位问题。

7.3 分步执行复杂任务

对于复杂任务，拆分成多个小步骤逐步完成，效果更好。

7.4 使用 @ 引用文件

在对话中输入 @ 可以快速引用项目中的文件，让 Claude Code 直接读取。

8. 总结

Claude Code 的核心价值在于把 AI 能力无缝融入终端工作流。掌握上述常用操作后，你就能在日常开发中高效使用它完成代码编写、审查、调试等任务。建议从简单的对话和文件操作开始，逐步尝试进阶功能，找到最适合自己的使用方式。