1. 引言Claude Code 是 Anthropic 推出的命令行 AI 编程助手能够在终端中直接理解代码仓库、执行命令、读写文件帮助开发者高效完成编码任务。本文总结 Claude Code 的常用操作帮助新手快速上手也方便老手随时查阅。2. 安装与启动2.1 安装方式一官方源安装npminstall-ganthropic-ai/claude-code方式二使用国内镜像安装由于网络原因直接从官方源安装可能较慢或失败推荐使用国内镜像源。以淘宝镜像npmmirror为例npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com也可以先永久设置 npm 镜像源再执行安装npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-code其他常用国内镜像源镜像源地址淘宝npmmirrorhttps://registry.npmmirror.com腾讯云https://mirrors.cloud.tencent.com/npm/华为云https://repo.huaweicloud.com/repository/npm/安装完成后在终端输入claude即可启动交互式会话。2.2 首次启动首次启动时Claude Code 会引导你完成登录授权。登录后即可在项目目录中直接使用。免密码登录Claude Code 支持通过 API Key 实现免密码登录无需每次输入账号密码。推荐使用环境变量方式配置exportANTHROPIC_API_KEY你的_API_Key也可以将 API Key 写入 shell 配置文件如~/.bashrc或~/.zshrc实现永久生效echoexport ANTHROPIC_API_KEY你的_API_Key~/.bashrcsource~/.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 快捷键快捷键作用CtrlC中断当前操作CtrlD退出 Claude CodeEsc取消当前输入↑/↓浏览历史输入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--continue6.3 使用-p模式执行一次性任务claude-p总结一下 CHANGELOG.md 中的更新内容6.4 切换大模型Claude Code 支持在启动时或会话中切换不同的大模型常用方式如下。启动时指定模型使用--model参数指定本次会话使用的模型claude--modelclaude-sonnet-4-5常用模型标识示例模型标识说明claude-opus-4-1最强推理模型适合复杂任务claude-sonnet-4-5性能与速度均衡日常推荐claude-haiku-4-5轻量快速适合简单任务使用 DeepSeek 大模型Claude Code 也支持接入 DeepSeek 等第三方模型。通过环境变量指定 DeepSeek 的 API 地址与 Key 即可exportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKEN你的_DeepSeek_API_KeyexportANTHROPIC_MODELdeepseek-chat配置完成后启动 Claude Code 便会默认使用 DeepSeek 模型。也可以在启动时临时指定claude--modeldeepseek-chat提示DeepSeek 提供 Anthropic 兼容接口因此可直接复用 Claude Code 的调用方式无需额外插件。会话中切换模型在交互式会话中使用/model命令即可随时切换模型/model执行后会弹出模型选择列表用方向键选择目标模型并回车确认即可。通过环境变量指定默认模型在 shell 配置文件中设置环境变量可让每次启动都默认使用指定模型exportANTHROPIC_MODELclaude-sonnet-4-5查看当前模型使用/status命令可以查看当前会话正在使用的模型及其他状态信息。7. 实用技巧7.1 善用/compact节省上下文当对话较长时使用/compact压缩历史避免上下文溢出。7.2 明确指定文件路径提问时尽量带上具体文件路径能让 Claude Code 更精准地定位问题。7.3 分步执行复杂任务对于复杂任务拆分成多个小步骤逐步完成效果更好。7.4 使用引用文件在对话中输入可以快速引用项目中的文件让 Claude Code 直接读取。8. 总结Claude Code 的核心价值在于把 AI 能力无缝融入终端工作流。掌握上述常用操作后你就能在日常开发中高效使用它完成代码编写、审查、调试等任务。建议从简单的对话和文件操作开始逐步尝试进阶功能找到最适合自己的使用方式。
1. 引言Claude Code 是 Anthropic 推出的命令行 AI 编程助手能够在终端中直接理解代码仓库、执行命令、读写文件帮助开发者高效完成编码任务。本文总结 Claude Code 的常用操作帮助新手快速上手也方便老手随时查阅。2. 安装与启动2.1 安装方式一官方源安装npminstall-ganthropic-ai/claude-code方式二使用国内镜像安装由于网络原因直接从官方源安装可能较慢或失败推荐使用国内镜像源。以淘宝镜像npmmirror为例npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com也可以先永久设置 npm 镜像源再执行安装npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-code其他常用国内镜像源镜像源地址淘宝npmmirrorhttps://registry.npmmirror.com腾讯云https://mirrors.cloud.tencent.com/npm/华为云https://repo.huaweicloud.com/repository/npm/安装完成后在终端输入claude即可启动交互式会话。2.2 首次启动首次启动时Claude Code 会引导你完成登录授权。登录后即可在项目目录中直接使用。免密码登录Claude Code 支持通过 API Key 实现免密码登录无需每次输入账号密码。推荐使用环境变量方式配置exportANTHROPIC_API_KEY你的_API_Key也可以将 API Key 写入 shell 配置文件如~/.bashrc或~/.zshrc实现永久生效echoexport ANTHROPIC_API_KEY你的_API_Key~/.bashrcsource~/.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 快捷键快捷键作用CtrlC中断当前操作CtrlD退出 Claude CodeEsc取消当前输入↑/↓浏览历史输入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--continue6.3 使用-p模式执行一次性任务claude-p总结一下 CHANGELOG.md 中的更新内容6.4 切换大模型Claude Code 支持在启动时或会话中切换不同的大模型常用方式如下。启动时指定模型使用--model参数指定本次会话使用的模型claude--modelclaude-sonnet-4-5常用模型标识示例模型标识说明claude-opus-4-1最强推理模型适合复杂任务claude-sonnet-4-5性能与速度均衡日常推荐claude-haiku-4-5轻量快速适合简单任务使用 DeepSeek 大模型Claude Code 也支持接入 DeepSeek 等第三方模型。通过环境变量指定 DeepSeek 的 API 地址与 Key 即可exportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKEN你的_DeepSeek_API_KeyexportANTHROPIC_MODELdeepseek-chat配置完成后启动 Claude Code 便会默认使用 DeepSeek 模型。也可以在启动时临时指定claude--modeldeepseek-chat提示DeepSeek 提供 Anthropic 兼容接口因此可直接复用 Claude Code 的调用方式无需额外插件。会话中切换模型在交互式会话中使用/model命令即可随时切换模型/model执行后会弹出模型选择列表用方向键选择目标模型并回车确认即可。通过环境变量指定默认模型在 shell 配置文件中设置环境变量可让每次启动都默认使用指定模型exportANTHROPIC_MODELclaude-sonnet-4-5查看当前模型使用/status命令可以查看当前会话正在使用的模型及其他状态信息。7. 实用技巧7.1 善用/compact节省上下文当对话较长时使用/compact压缩历史避免上下文溢出。7.2 明确指定文件路径提问时尽量带上具体文件路径能让 Claude Code 更精准地定位问题。7.3 分步执行复杂任务对于复杂任务拆分成多个小步骤逐步完成效果更好。7.4 使用引用文件在对话中输入可以快速引用项目中的文件让 Claude Code 直接读取。8. 总结Claude Code 的核心价值在于把 AI 能力无缝融入终端工作流。掌握上述常用操作后你就能在日常开发中高效使用它完成代码编写、审查、调试等任务。建议从简单的对话和文件操作开始逐步尝试进阶功能找到最适合自己的使用方式。
