claude code基础用法总结

个人claude code使用记录，持续更新

文章目录

- [一、claude code相关基础背景概念](#一、claude code相关基础背景概念)
- - [1、claude code诞生背景---AI 模型能力已远超 "代码补全" 产品形态](#1、claude code诞生背景---AI 模型能力已远超 "代码补全" 产品形态)
  - [2、claude code是什么？---Anthropic推出面向开发者AI编程Agent](#2、claude code是什么？---Anthropic推出面向开发者AI编程Agent)
  - [3、claude code同类型对比与适用场景---更工程化适合大型项目构建&重构&问题排查](#3、claude code同类型对比与适用场景---更工程化适合大型项目构建&重构&问题排查)
- [二、Claude Code基础使用](#二、Claude Code基础使用)
- - [1、Claude code常用基础命令](#1、Claude code常用基础命令)
  - [2、Claude Code 项目目录结构](#2、Claude Code 项目目录结构)
  - 3、扩展机制之SKILL---特定任务按固定流程做事操作说明书
- 参考

一、claude code相关基础背景概念

1、claude code诞生背景---AI 模型能力已远超 "代码补全" 产品形态

Claude Code 并非 Anthropic 规划已久的大项目，而是由工程师Boris Cherny在 2024 年 9 月启动的个人实验。他最初只是想做一个简单的 API 测试工具，帮助自己处理音乐播放列表，却意外发现大模型能力远超当时的 "代码补全" 产品形态。Anthropic团队敏锐发现：AI 模型能力已超越现有产品形态，具备直接编写完整代码、处理复杂工程任务的潜力。

2、claude code是什么？---Anthropic推出面向开发者AI编程Agent

Claude Code是 Anthropic 于 2025 年推出的终端原生 AI 编程智能体，核心定位是全链路工程助手，而非简单的代码补全工具，Claude Code 的核心目标是理解你的整个项目，并参与到真实的编码、修改和重构过程中。Claude Code 代表了 AI 编程工具的下一代范式------ 从 "被动补全" 到 "主动执行"，从 "代码片段" 到 "项目全局"。它的核心优势在于超长上下文理解、终端原生体验和自主执行能力，使其在处理复杂工程任务时远超同类产品。

3、claude code同类型对比与适用场景---更工程化适合大型项目构建&重构&问题排查

claude code相对同类型产品比较：1）定位从从 "补全工具" 到 "工程伙伴"，能完成从需求到部署的全流程工作；2）超长上下文100 万 token 的 "全景视角"（一次性处理数十万行代码，自动构建完整项目地图）；3）在复杂问题解决能力上领先其他工具4-14 个百分点（SWE-bench Verified），尤其擅长处理需要深度逻辑推理和架构理解的任务。

简单来说，优势：大型项目重构、复杂 BUG 排查、工程级自动化、全局架构理解，目前全球第一；劣势：轻量化日常补全、图形化交互、国内原生网络体验、上手门槛不如传统工具。

二、Claude Code基础使用

安装了 Claude Code 及配置好 API 后，在任何目录打开cmd输入claude登陆claude code：

1、Claude code常用基础命令

一个项目的典型开发流程，进入项目执行 /init 完成初始化；开发新功能时启用 EnterPlanMode，先探索代码、输出设计方案，审批通过后再进行功能实现；通过 TaskCreate 拆解为用户登录、表单验证、编写测试等细分任务；代码提交前执行安全审查，并使用 simplify 工具优化代码质量；随后执行 git 暂存提交，创建 GitHub PR；最后定时每 3 分钟查看 PR 状态，监控 CI 校验运行情况。

bash 复制代码

# 1. 项目启动
/init              # 分析项目结构，自动生成 CLAUDE.md

# 2. 日常会话管理
/clear            # 清空当前对话历史，重新开始
/compact          # 压缩上下文，释放 token 空间并保留关键摘要
! <shell命令>      # 在终端直接执行命令，结果返回到对话中

# 3. 编码辅助
/mention          # 引用文件或目录到对话上下文中
/todos            # 查看/管理当前会话的任务列表
EnterPlanMode     # 进入计划模式：探索代码库→设计方案→等待审批后实现
TaskCreate        # 拆解复杂任务为步骤，跟踪执行进度
/fast             # 切换快速模式（Opus 4.6 独占，输出提速）

# 4. 代码审查
/review           # 审查当前分支 PR
/security-review  # 对当前分支变更做安全审查
simplify(skill)   # 代码质量审查，自动修复复用性、效率类问题

# 5. 自动化与定时任务
/loop <间隔> <命令>  # 定时重复执行命令，例：/loop 5m /review
CronCreate        # 创建一次性/可重复持久化 cron 定时任务
CronList          # 列出所有定时任务
CronDelete        # 删除指定定时任务

# 6. Git 与分支管理
/worktree         # 创建隔离 git worktree，临时分支安全实验
gh pr create      # 通过 GitHub CLI 创建 Pull Request
gh pr view        # 查看 PR 详情
gh api            # 调用 GitHub API，操作 issues、评论等

# 7. 配置与个性化
/config                 # 交互式修改主题、默认模型等设置
/statusline             # 配置终端状态栏展示内容
/permissions            # 管理工具权限策略，允许/拒绝指定操作
update-config(skill)    # 直接编辑 settings.json 配置环境与权限
keybindings-help(skill) # 自定义键盘快捷键及和弦绑定
/upgrade                # 升级 Claude Code 至最新版本

# 8. 特定领域，技能通过 `/skill-name` 调用，扩展 Claude Code 的能力。
claude-api(skill)          # Claude API 开发、模型版本迁移适配
fewer-permission-prompts(skill) # 生成权限白名单，减少授权弹窗

# 9. Shell 快捷技巧
拖拽文件到终端  # 自动填充文件路径，供 Claude Code 读取
管道输入        # echo "问题描述" | claude 管道交互式调用

2、Claude Code 项目目录结构

一个典型的 Claude Code 项目目录结构如下

bash 复制代码

your-project/
├── CLAUDE.md                    ← 团队共享指令，提交到 git
├── CLAUDE.local.md              ← 个人覆盖，被 git 忽略
└── .claude/
    ├── settings.json            ← 权限 + 配置，提交到 git
    ├── settings.local.json      ← 个人权限，被 git 忽略
    ├── commands/                ← 自定义斜杠命令
    │   ├── review.md            →  /project:review
    │   ├── fix-issue.md         →  /project:fix-issue
    │   └── deploy.md            →  /project:deploy
    ├── rules/                   ← 模块化指令文件（全局生效）
    │   ├── code-style.md
    │   ├── testing.md
    │   └── api-conventions.md
    ├── skills/                  ← 自动调用的工作流
    │   ├── security-review/
    │   │   └── SKILL.md
    │   └── deploy/
    │       └── SKILL.md
    └── agents/                  ← 子代理角色定义
        ├── code-reviewer.md
        └── security-auditor.md

3、扩展机制之SKILL---特定任务按固定流程做事操作说明书

skill是Anthropic于25年推出的Claude扩展机制，并快速被其他厂商跟进。Agent Skills 本质上是一个模块化的 Markdown 文件，能教会 AI 工具（如 Claude、GitHub Copilot等）执行特定任务，且支持自动触发、团队共享与工程化管理，彻底告别重复的提示词输入。核心形式：一个 Skill 就是一个文件夹，里面必须有一个 SKILL.md 文件（包含说明和元数据），可选其他资源文件（如脚本、示例、参考文档）。

SKILL的优势：1）可复用，流程固话可以重复稳定使用；2）可分享，相互传递安装SKILL包；3）可自动触发，Claude可以根据description自动判断是否调用，也能手动运行；

bash 复制代码

my-skill/
├── SKILL.md      # 必需：指令 + 元数据
├── scripts/      # 可选：可执行代码
├── references/   # 可选：文档资料
└── assets/       # 可选：模板、资源

通用SKILL.md典型内容如下（Claude SKILL有更多关键字如是否支持自动触发等）：

参考

官方文档：https://code.claude.com/docs/zh-CN/overview

CLI 命令参考（官方文档）：https://code.claude.com/docs/en/cli-reference

斜杠命令大全（官方文档）：https://code.claude.com/docs/en/commands

5分钟安装ClaudeCode并接入DeepSeek：https://www.bilibili.com/video/BV1KjoxBoEQJ

Claude Code 入门教程：https://www.runoob.com/claude-code/claude-code-tutorial.html

learn-claude-code项目：https://github.com/shareAI-lab/learn-claude-code/blob/main/README-zh.md

开源地址：https://github.com/anthropics/claude-code

手把手教你在Claude Code中熟练使用SKILL技能！：https://www.bilibili.com/video/BV1BFouBYERu/