平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“claude code基础用法总结”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。
一、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 校验运行情况。
# 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 项目目录结构如下所示
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自动判断是否调用，也能手动运行；
my-skill/ ├── SKILL.md # 必需：指令 + 元数据 ├── scripts/ # 可选：可执行代码 ├── references/ # 可选：文档资料 └── assets/ # 可选：模板、资源
通用SKILL.md典型内容如下所示（Claude SKILL有更多关键字 如 是否兼容自动触发等）：
参考
官方文档：（链接已移除）
CLI 命令参考（官方文档）：（链接已移除）
斜杠命令大全（官方文档）：（链接已移除）
5分钟安装ClaudeCode同时接入DeepSeek：（链接已移除）
Claude Code 入门教程：（链接已移除）
learn-claude-code项目：（链接已移除）
开源地址：（链接已移除）
手把手教你在Claude Code中熟练采用SKILL技能！：（链接已移除）
从实现思路看，总的来说，claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。