Claude Code 的一个小小小教程
2026/6/3 1:48:30 网站建设 项目流程

目录

  • 基础交互
    • 常用斜杠命令
    • 常用快捷键
    • 提示词
  • CLAUDE.md
    • 三种创建方式
    • 工作流
    • 包含板块
  • SKILL
  • 权限管理
  • 工作流
  • Vibe Coding
  • 参考文章/视频

由于安装教程很多,这里就不再过多赘述

基础交互

claude --continue, -c # 继续上一次会话复制

常用斜杠命令

  • /help
    查看所有可用命令列表
  • /clear
    清除当前会话上下文,重新开始。
    上下文积累太多或跑偏时用这个,比退出重进快。
  • /status
    查看当前 token 使用量、模型信息、会话状态
  • /model
    切换模型,如 claude-sonnet-4-6 / claude-opus-4-6
  • /exit
    退出 CLI(也可以用 Ctrl+C 或 Ctrl+D)

常用快捷键

快捷键作用使用场景
Ctrl+C中断当前操作Claude 跑偏了,紧急刹车
Ctrl+D退出会话干完活了,下班
Esc Esc撤销最近的修改Claude 改出 Bug 了
Shift+Tab切换权限模式临时调整自动/手动
Ctrl+R搜索历史提示词复用之前输过的 prompt

提示词

提示词质量决定输出质量


  • “帮我优化这个方法”

  • “读一下 LinkService.getOriginalUrl(),这个方法在高并发下可能有缓存击穿问题,帮我用 Redisson 分布式锁解决,锁粒度到 shortCode 级别”

  • “帮我写测试”

  • “为 LinkService 写 JUnit5 单元测试,mock Redis 和 MySQL,覆盖缓存命中、缓存未命中、数据不存在三种路径”

提示词里要说清楚:读哪个文件 + 做什么 + 约束条件。越具体输出越精准,尤其是生成测试时把要覆盖的场景列出来,省得来回返工。

CLAUDE.md

三种创建方式

  • /init:Claude 自动生成初稿
  • 从零开始:适合不想引入自动生成冗余的人
  • #Memory 快捷添加:适合工作过程中随手补充

工作流

  1. 手动创建骨架(或用 /init 生成草稿后精修)
  2. 实际协作 3-5 次,发现遗漏
  3. 用 # 快速补充新规则
  4. 每隔一段时间回来整理一次

包含板块

CLAUDE.md 应该包含以下板块:

# ShanLink 短链接平台 ## 项目概述 Spring Boot 3.x + MyBatis-Plus + Redis + RocketMQ 的短链接服务。 Maven 多模块结构,主模块在 shanlink-web。 ## 技术栈约束 - Java 17,禁止使用过时 API - 缓存:Redisson,不要直接用 Jedis - ORM:MyBatis-Plus,不要写裸 SQL(复杂查询除外) - 消息队列:RocketMQ 5.2,已有 Docker Compose 环境 - 测试:JUnit5 + Mockito,测试类放在对应 test 目录 ## 常用命令 ```bash mvn compile # 编译 mvn test # 跑测试 mvn spring-boot:run # 启动服务(端口 8080) docker compose up -d # 启动 Redis + RocketMQ ## 包结构规范 com.shanlink. controller/ # 接口层,只做参数校验和结果封装 service/ # 业务逻辑层 mapper/ # 数据访问层 entity/ # 数据库实体 dto/ # 请求/响应对象 ## 代码规范 - 缓存 key 格式:link:short:{shortCode} - 所有接口返回统一的 Result 包装 - 异步操作用 @Async 或 RocketMQ,不要阻塞主线程 - 新增功能必须写单元测试

SKILL

把高频的复杂 Prompt 封装成 /命令名,一键触发。Claude 也可以根据 description 自动判断何时加载。

创建位置:.claude/skills/review-pr/SKILL.md

--- name: review-pr description: 审查 git diff,用于 PR 提交前的代码质量检查。 当用户说"帮我 review"或"检查代码"时自动加载。 --- 请对以下代码改动进行全面审查,分三个维度输出: **1. 正确性**:逻辑错误、边界条件、并发安全 **2. 性能**:N+1 查询、缓存使用是否合理、不必要的阻塞 **3. 规范**:命名、注释、是否符合项目约定 每个问题注明文件名和行号,给出修改建议。 代码改动: @git-diff

权限管理

用 Claude Code 超过三天的人,一定经历过这种崩溃:
“我要读一下 package.json,可以吗?”——同意。
“我要读一下 tsconfig.json,可以吗?”——同意。
“我要读一下 src/app/page.tsx,可以吗?”——同意。
“我要读一下 src/app/layout.tsx,可以吗?”——……
点到第 15 次"同意"的时候,你的内心已经在咆哮了:能不能别问了!全部同意行不行!
然后你可能真的去搜了"Claude Code 怎么跳过权限",找到一个叫 --dangerously-skip-permissions 的参数,从名字就能看出来——这玩意儿名字里就写着"危险"

其实你不需要走极端。权限系统不是 Claude Code 的缺陷,而是它最精妙的设计之一。只是你还没学会怎么调它。

先来看下 CLUADE 的五种权限模式(前三种可通过快捷键shift + tab循环切换):

  • default:读写命令都问
  • acceptEdits:改文件自动过,跑命令还是问
  • plan:只分析出方案,不动手
  • dontAsk:全自动,不询问(在~/.claude/settings.json中配置)
  • bypassPermissions:完全跳过,仅限容器内用
    日常开发推荐 acceptEdits,按 Shift+Tab 切换。(claude --dangerously-skip-permissions)


以下是全局模板,能省去很多时间:

"permissions":{"defaultMode":"acceptEdits","allow":["Read","Bash(ls *)","Bash(cat *)","Bash(head *)","Bash(tail *)","Bash(wc *)","Bash(find *)","Bash(grep *)","Bash(echo *)","Bash(mkdir *)","Bash(git status)","Bash(git log *)","Bash(git diff *)","Bash(git branch *)","Bash(git show *)","Bash(node --version)","Bash(npm --version)","Bash(npx tsc --noEmit)"],"deny":["Bash(rm -rf *)","Bash(sudo *)","Bash(curl *)","Bash(wget *)","Read(./.env*)","Read(./secrets/**)","Read(./**/credentials*)","Edit(./.env*)","Edit(./secrets/**)",]}

相关斜杠命令:

  • /permisson
    显示当前哪些操作被允许、哪些被拒绝,也可以用来添加规则。比如允许某个目录的写操作、禁止执行某类命令等。
  • /fewer-permission-prompts
    专门用来降低「是否允许此操作?」的提示频率。适合你已经跑顺了一个项目、信任 Claude 的操作范围之后使用。

工作流

  1. PLAN
    Shift tab 切换至Plan 模式
    做大改动前先让 Claude 出方案,确认没问题再写入磁盘。避免一步走错满盘皆输。
  2. 上下文管理 Claude 的上下文窗口有限,长时间开发后上下文积累过多会影响响应质量。可以用以下命令管理:
    • /compact:压缩当前上下文,保留关键信息,清除过期对话
    • /clear:彻底清空上下文,任务完全切换时使用
    • /btw:临时问一个小问题,适合查文档
    • /resume:从历史会话列表中恢复

Vibe Coding

  1. 先写 CLAUDE.md
    把项目的项目目标、技术栈、目录结构、代码规范、命名习惯全部写清楚
  2. 用自然语言描述架构,让 Claude 画蓝图
    不要上来就让它写业务代码,先用一段话描述你要什么,让它输出文件结构、模块划分、数据流,你审完蓝图再开工,返工率降低 80%
  3. 模块化推进
    一次只做一件事,千万不要一口气让它写整个 feature,拆成小任务,每个任务控制在一个文件或一个函数级别
  4. TDD 测试驱动
    先写测试再写实现,先根据需求生成测试用例,然后再让它写实现代码,这样它自己就有了验收标准,生成的代码通过率高很多
  5. Code Review
    养成习惯:每次生成完,花两分钟扫一遍关键逻辑。这两分钟能帮你省两小时 debug
  6. 善用 MCP 和 Skills 扩展能力边界
    把你项目的 best practice 封装成 MCP 或 Skills,Claude 调用时就不会凭空瞎写,这也是 ShipSwift 在做的事——不是教你写代码,是教 AI 写代码,db 设计,数据安全,auth,payment 等生产级模块全覆盖
  7. 重置上下文的时机
    如果你发现 Claude 开始输出不相关的内容,或者忘记了之前的约束,不要硬撑,果断重置,一个干净的上下文比一个冗长的对话有效 10 倍

参考文章/视频

Claude Code Tutorial: Beginner to Advanced in 20 Minutes
Claude Code • Permission Modes - Stop Being a Button (Ep 03)
Claude Code 通关手册(二):权限系统搞明白,效率直接翻倍

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询