1. 引言
Claude Code 是 Anthropic 推出的命令行 AI 编程助手,能够在终端中直接理解代码仓库、执行命令、读写文件,帮助开发者高效完成编码任务。本文总结 Claude Code 的常用操作,帮助新手快速上手,也方便老手随时查阅。
2. 安装与启动
2.1 安装
方式一:官方源安装
bash
npm install -g @anthropic-ai/claude-code
方式二:使用国内镜像安装
由于网络原因,直接从官方源安装可能较慢或失败,推荐使用国内镜像源。以淘宝镜像(npmmirror)为例:
bash
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
也可以先永久设置 npm 镜像源,再执行安装:
bash
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 实现免密码登录,无需每次输入账号密码。推荐使用环境变量方式配置:
bash
export ANTHROPIC_API_KEY=你的_API_Key
也可以将 API Key 写入 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc),实现永久生效:
bash
echo 'export ANTHROPIC_API_KEY=你的_API_Key' >> ~/.bashrc
source ~/.bashrc
配置完成后,直接运行 claude 即可免登录进入会话,无需再走浏览器授权流程。
3. 常用交互操作
3.1 基础对话
在终端直接输入自然语言指令即可与 Claude Code 对话,例如:
text
帮我看看这个项目的结构
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 读取文件
text
读取 src/main.py 的内容
4.2 编辑文件
text
在 utils.py 中新增一个函数,用于计算两个数的和
4.3 创建新文件
text
创建一个 README.md,介绍这个项目的用途
4.4 搜索代码
text
在项目中搜索所有使用了 requests 库的地方
4.5 运行命令
text
运行 npm test 看看测试是否通过
5. 代码审查与调试
5.1 代码审查
text
审查我最近的改动,指出潜在问题
5.2 解释代码
text
解释一下 src/auth.py 中 login 函数的逻辑
5.3 生成测试
text
为 calculator.py 中的 add 函数编写单元测试
5.4 修复 Bug
text
运行测试后报错了,帮我分析并修复
6. 进阶用法
6.1 使用 CLAUDE.md 定义项目规范
在项目根目录创建 CLAUDE.md 文件,写入项目说明、代码风格、常用命令等,Claude Code 会自动读取并遵循这些规范。
markdown
# 项目规范
- 使用 TypeScript 编写代码
- 使用 pnpm 作为包管理器
- 测试文件放在 __tests__ 目录下
6.2 使用 --continue 继续上次会话
bash
claude --continue
6.3 使用 -p 模式执行一次性任务
bash
claude -p "总结一下 CHANGELOG.md 中的更新内容"
6.4 切换大模型
Claude Code 支持在启动时或会话中切换不同的大模型,常用方式如下。
启动时指定模型
使用 --model 参数指定本次会话使用的模型:
bash
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 即可:
bash
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=你的_DeepSeek_API_Key
export ANTHROPIC_MODEL=deepseek-chat
配置完成后,启动 Claude Code 便会默认使用 DeepSeek 模型。也可以在启动时临时指定:
bash
claude --model deepseek-chat
提示:DeepSeek 提供 Anthropic 兼容接口,因此可直接复用 Claude Code 的调用方式,无需额外插件。
会话中切换模型
在交互式会话中,使用 /model 命令即可随时切换模型:
text
/model
执行后会弹出模型选择列表,用方向键选择目标模型并回车确认即可。
通过环境变量指定默认模型
在 shell 配置文件中设置环境变量,可让每次启动都默认使用指定模型:
bash
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 能力无缝融入终端工作流。掌握上述常用操作后,你就能在日常开发中高效使用它完成代码编写、审查、调试等任务。建议从简单的对话和文件操作开始,逐步尝试进阶功能,找到最适合自己的使用方式。