Claude Code 常用操作总结

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 能力无缝融入终端工作流。掌握上述常用操作后,你就能在日常开发中高效使用它完成代码编写、审查、调试等任务。建议从简单的对话和文件操作开始,逐步尝试进阶功能,找到最适合自己的使用方式。

相关推荐
daemon.qiang7 天前
国内虚拟机对接 Freedesktop:Fork xserver、自建 Runner 与提交 MR 实战
linux·ubuntu·centos·gitlab·开源软件
snow@li11 天前
服务器运维:K3S 下 Jenkins ↔ GitLab 的 CI/CD 闭环 / 访问成功
运维·gitlab·jenkins
旧梦星轨13 天前
Git Flow 工作流实践
git·gitee·gitlab·github
旧梦星轨13 天前
Github Flow 与 Gitlab Flow工作流实践解读
gitlab·github
极小狐16 天前
干掉流水线里的长期密钥:用 OIDC 让 CI/CD 与云以临时凭证对接
microsoft·ci/cd·gitlab·devops·ci·cd·oidc
snow@li16 天前
服务器运维:阿里云安装软件gitlab/智能体协助安装/智能体协同运维
运维·gitlab
极小狐17 天前
CI 流水线提速实战:缓存设计与依赖代理的工程实践
缓存·ci/cd·gitlab·devops
DevOps老兵18 天前
AI Infra实战11:模型部署Pipeline——CI/CD自动化
人工智能·ci/cd·ai·自动化·gitlab
极小狐18 天前
从复制粘贴到可复用组件:极狐GitLab CI/CD 组件目录实战
java·ci/cd·gitlab·devops·组件化
极小狐18 天前
用 Flow 编排 Agent 智能体:极狐GitLab Duo 自定义工作流实战
ai·gitlab·agent·devops·flow·duo