Claude Code命令大全与实战工作流(收藏版)

2026-06-27阅读 0热度 0
Claude

Claude Code 是一款运行于终端环境的 AI 辅助编码工具,能够直接在项目目录中解析代码结构、修改文件、执行命令、推进开发计划,并具备持久化记忆、上下文压缩、多模型切换等专业能力,可显著提升日常开发、项目维护、代码重构与审查的效率。本文将从命令体系、基础配置、核心功能、实战工作流到常见问题排查,提供一份零门槛的全流程指南,覆盖新手入门与进阶使用,帮助开发者快速掌握并高效运用 Claude Code。

一、Claude Code 基础入门:安装与启动

1. 安装与环境准备

Claude Code 支持 Windows、macOS 与 Linux 多平台,安装前需确保系统已配置好终端环境(如 macOS 的 iTerm2、Windows 的 PowerShell、Linux 的 Bash)。安装过程十分简便,从官方渠道获取安装包,解压后即可使用,无需复杂的依赖配置。首次启动时,工具会引导完成基础设置,包括选择运行环境(本地/远程)、指定项目文件夹、配置权限模式等,新手按提示操作即可完成初始化。

???? 小提示:如果遇到权限问题,请确保终端对项目目录拥有读写权限。macOS/Linux 用户可执行 chmod -R 755 . 调整目录权限。

阿里云部署AI Agent:OpenClaw/Hermes Agent全网最简单,只需两步,详情访问阿里云OpenClaw/Hermes一键部署专题页面 了解。

Token Plan Token最便宜/支持多模型切换:访问订阅阿里云百炼Token Plan AI大模型服务。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。

2. 启动方式与基础参数

  • 基础启动:进入项目根目录,在终端输入 claude 命令,直接启动 Claude Code 并加载当前项目。
  • 续接会话:输入 claude -c,可继续最近一次的会话,保留之前的上下文与记忆。
  • 单次查询:输入 claude --print "你的问题",执行单次查询后自动退出,适合快速获取代码片段。
  • 跳过权限确认:输入 claude --dangerously-skip-permissions,启动时跳过所有权限确认弹窗,适合熟悉操作的开发者,但需注意操作风险。

⚠️ 注意:--dangerously-skip-permissions 会跳过所有文件读写和执行命令的确认,请仅在充分信任 AI 的情况下使用,建议先在测试项目中尝试。

二、核心命令体系:三大类型全解析

Claude Code 的命令体系分为 CLI 启动命令、交互式斜杠命令、键盘快捷键三类,覆盖从启动到会话控制的全流程操作,以下是高频核心命令详解。

1. CLI 启动命令(终端启动时使用)

  • claude:在当前目录启动 Claude Code,加载项目文件。
  • claude -c:继续最近一次会话,恢复上下文与记忆。
  • claude --agent <名称>:启动指定自定义 Agent,适配不同开发场景。
  • claude --print "指令":单次执行指令,不进入交互式会话。

2. 交互式斜杠命令(会话内使用,核心控制指令)

斜杠命令是 Claude Code 的核心,决定 AI 行为、上下文与配置,以下是最常用命令:

  • /init:项目初始化,自动扫描代码结构,生成 CLAUDE.md 项目知识库,包含项目概述、技术栈、目录结构、开发规范等,实现持久项目记忆。
  • /help:查看所有可用命令列表及说明,新手快速上手必备。
  • /clear:清空当前对话历史,重启会话但不退出工具,适合切换任务或上下文混乱时使用。
  • /compact:压缩过长对话,自动总结历史保留关键信息,释放上下文空间,避免 Token 上限问题。
  • /memory:打开并编辑 CLAUDE.md 记忆文件,支持项目记忆与用户全局记忆配置,自定义编码习惯、提交规范等。
  • /model:切换 AI 模型,/model list 可查看可用模型列表,适配不同代码生成需求。
  • /cost:查看当前会话 Token 使用量与预估成本,控制开发成本。
  • /permissions:配置 AI 操作权限,设置文件读写、命令执行的权限范围,保障项目安全。
  • /plan:生成开发计划,拆解任务步骤,辅助复杂功能开发。
  • /btw:查看对话详情,支持复制原始 Markdown 内容,方便代码导出。

???? 小提示:如果你在长会话中感觉 AI 回答开始偏离主题,先尝试执行 /compact 压缩上下文,再执行 /clear 清空历史(后两者顺序不可颠倒),然后重新描述需求。

3. 键盘快捷键(提升操作效率)

  • Ctrl+C:中断当前 AI 执行的操作,紧急停止修改或命令执行。
  • Option+Enter(macOS)/ Alt+Enter(Windows/Linux):插入换行,避免误发未完成指令,适合编写长 Prompt。
  • c:复制当前对话的原始 Markdown 内容,快速导出代码或说明。

三、核心功能详解:记忆、权限与模型配置

1. 记忆体系:项目记忆 + 用户记忆 + 自动记忆

Claude Code 的记忆机制是高效开发的关键,分为三类:

  • 项目记忆:存储在 CLAUDE.md 文件中,仅对当前项目生效,记录项目规范、禁止修改目录、接口约定等,通过 /init 生成、/memory 编辑。
  • 用户记忆:保存在用户目录,全局生效,记录个人编码习惯、注释风格、提交信息格式等,AI 自动适配个人开发偏好。
  • 自动记忆:AI 自动抓取关键规则写入记忆,无需手动维护,持续优化对项目与开发者的理解。

❓ 常见问题:为什么 AI 记不住我上次设定的规则?
答:请确认 CLAUDE.md 文件已正确生成且位于项目根目录。执行 /memory 查看当前记忆内容,如果为空,执行 /init 重新扫描。另外,每个新会话都会重新加载记忆文件,但不会自动保存会话中的新规则,你需要在编辑记忆文件后保存。

2. 权限模式:安全控制 AI 操作

为保障项目安全,Claude Code 提供多级权限模式,可通过 /permissions 配置:

  • 询问模式:默认模式,AI 执行文件修改、命令执行前需用户确认,适合新手。
  • 受限模式:仅允许读取文件,禁止修改与执行命令,适合代码审查场景。
  • 自由模式:跳过部分确认,快速执行操作,适合熟悉项目的开发者。
  • 危险模式--dangerously-skip-permissions 启动,跳过所有确认,需谨慎使用。

⚠️ 注意:从受限模式切换到自由模式需要输入 /permissions 并选择确认,不能直接通过启动参数覆盖。

3. 模型切换:适配不同开发需求

通过 /model 命令可在会话中切换模型,不同模型适配不同场景:

  • 轻量模型:适合快速生成简单代码、代码注释,响应速度快。
  • 进阶模型:适合复杂代码生成、架构设计、问题排查,理解能力更强。
  • 多模态模型:支持图片输入,可分析 UI 截图、报错信息、架构图,辅助可视化开发。

???? 小提示:切换模型后,之前的上下文会被保留,但部分模型可能对历史长度有限制,建议切换后立即执行 /compact 压缩上下文。

四、实战工作流:从项目初始化到功能开发

以“接手新项目 + 开发新功能”为例,最稳定高效的工作流如下:

第一步:项目初始化,构建记忆体系

  1. 进入项目根目录,执行 /init,自动生成 CLAUDE.md,完成项目结构扫描。
  2. 执行 /memory,编辑 CLAUDE.md,补充项目规范:禁止修改的目录、代码提交格式、测试/构建命令、接口约定等。
  3. 配置权限模式,选择适合的权限级别,保障开发安全。

第二步:需求拆解,生成开发计划

  1. 向 Claude Code 描述开发需求,如“基于 Python Flask 开发用户登录接口,包含数据库连接与密码加密”。
  2. 执行 /plan,让 AI 拆解任务步骤,生成清晰的开发计划,明确每个步骤的操作与文件修改点。
  3. 确认计划后,按步骤推进开发,遇到问题随时调整。

第三步:代码生成与修改,实时调试

  1. 根据开发计划,逐步向 AI 下达指令,如“创建 app.py 文件,初始化 Flask 应用”“编写用户模型与数据库连接代码”。
  2. AI 自动生成代码并修改文件,实时查看修改内容,确认无误后继续下一步。
  3. 遇到报错时,直接粘贴报错信息到终端,AI 自动分析并提供修复方案。

❓ 常见问题:AI 生成的代码与项目风格不一致怎么办?
答:检查 CLAUDE.md 中是否已定义编码规范(如缩进风格、命名规则)。如果没有,通过 /memory 补充规则,然后要求 AI 重新生成修改。例如:“请根据 CLAUDE.md 中的编码规范重写 user.py。”

第四步:代码审查与优化,确保质量

  1. 开发完成后,执行 /review,让 AI 审查代码,检查语法错误、逻辑漏洞、性能问题。
  2. 根据审查结果,优化代码,如简化逻辑、添加注释、提升性能。
  3. 执行测试命令,验证功能正常运行,确保代码符合项目规范。

???? 小提示:如果项目没有测试用例,可以先让 AI 生成单元测试框架,再执行 /review 会更有针对性。

第五步:会话收尾,保存记忆与上下文

  1. 开发完成后,执行 /compact,压缩对话历史,保留关键信息。
  2. 确认 CLAUDE.md 已更新,保存项目记忆,方便后续开发。
  3. 输入 exit 退出会话,或直接关闭终端,记忆文件会自动保存。

五、进阶技巧:提升开发效率

1. 自定义 Agent,适配场景需求

.claude/agents/ 目录下创建自定义 Agent 文件(如 code-architect.md),配置名称、颜色、工具集、权限与模型,通过 claude --agent <名称> 启动,适配代码架构、代码简化、验证等不同场景。

???? 小提示:自定义 Agent 的配置文件中可以使用 tools: 字段限制 AI 可调用的工具(如只允许“读取文件”和“写入文件”),进一步精细化权限。

2. 终端配置优化,避免误操作

  • 执行 /terminal-setup,调整回车换行逻辑,将 Enter 设为发送,Option+Enter 设为换行,防止误发未完成指令。
  • 配置别名简化命令,如在 ~/.zshrc 中添加 alias cc="claude --dangerously-skip-permissions",执行 source ~/.zshrc 生效,后续输入 cc 即可快速启动。

3. 图片输入,辅助可视化开发

直接截图粘贴到终端,或输入指令让 AI 读取本地图片路径,AI 可分析 UI、报错信息、架构图,辅助可视化开发。图片仅临时缓存,会话结束后自动清理,保障数据安全。

六、常见问题排查

  1. AI 无法读取项目文件:检查是否在项目根目录启动,权限是否配置正确,CLAUDE.md 是否生成。
    解决:执行 pwd 确认目录,执行 ls -la .claude/ 查看隐藏文件,若无则重新 /init
  2. 上下文混乱,回答跑偏:执行 /clear 清空历史,或 /compact 压缩上下文,重新描述需求。
    解决:优先使用 /compact,如果问题依然存在,再用 /clear
  3. 模型调用失败:检查网络连接,切换模型,确认账户额度充足。
    解决:执行 /model list 查看可用模型,切换至轻量模型尝试,若提示配额不足,升级 Token Plan 或联系服务商。
  4. 权限不足,无法修改文件:调整权限模式,或使用 --dangerously-skip-permissions 启动(谨慎使用)。
    解决:执行 /permissions 查看当前模式,选择“自由模式”或更高权限。
  5. 命令不生效:输入 /help 查看命令列表,确认命令格式正确,斜杠命令需在会话内使用。
    解决:检查命令是否以 / 开头且无多余空格,如 /clear 是正确格式,/ clear 会无效。

七、总结

Claude Code 凭借强大的命令体系、记忆机制与实战工作流,成为开发者高效编码的得力助手。从基础安装启动,到核心命令掌握,再到完整实战流程,新手可通过本文快速上手,进阶用户可利用自定义 Agent、权限配置等技巧提升效率。合理运用 /init/memory/plan 等核心命令,结合高效工作流,能大幅减少手动操作,让 AI 成为开发的核心助力,轻松应对各类编码场景。

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策