前言：什么是 Claude Code？
Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，基于 Claude 大模型开发，主打本地终端运行，可实现代码编写、项目重构、漏洞修复、文件编辑、自动化运维等功能。
相较于网页版 AI，它能够直接操控本地电脑文件、执行终端命令、管理 Git 仓库，深度赋能开发工作；同时支持自定义技能、插件、子代理，是目前综合能力极强的本地 AI 编程工具之一。
适用人群：编程初学者、独立开发者、全栈工程师、需要批量处理代码/文档的办公人员。
一、环境安装（Windows/Mac 通用）
1. 前置依赖
必须提前安装 Node.js（推荐 18.0 及以上稳定版本）。
2. 全局安装命令
npm install -g @anthropic-ai/claude-code
3. 验证是否安装成功
claude --version
终端输出版本号，即为安装成功。
二、大模型配置（密钥+中转）
1. 密钥获取方式
官方密钥：在 Anthropic 官网申请，收费且国内无法直连；
中转密钥：新手首选模型中转站，无需科学上网、成本低、运行稳定。
2. 配置工具
推荐使用 cc-swift 可视化配置工具，一键填入中转密钥、切换模型、配置代理，新手无需手动编写配置文件。
3. 新手建议
优先使用中转密钥，规避官方网络卡顿、无法访问等问题，降低使用门槛，无需复杂代理配置。
三、核心快捷键（必背·高频使用）
1. Shift + Tab｜模式切换
循环切换三种工作模式，当前模式会展示在输入框下方状态栏，具体模式说明如下：
（1）默认模式（Normal / Default）
运行规则：执行敏感工具操作时，弹出权限确认框，需手动逐次批准；
适用场景：日常常规使用，针对写入文件、删除文件、网络请求等高危操作，人工二次审核，保障安全。
（2）自动接受编辑模式（Auto-Accept Edits）
运行规则：自动放行文件编辑类操作，无需反复确认；Bash 等高危终端命令仍保留权限校验；
适用场景：确认任务方向无误，需要连续批量修改文件，避免频繁弹窗打断操作；
风险提示：会直接覆盖本地文件，建议提前提交 Git，方便随时回滚。
（3）计划模式（Plan Mode）
运行规则：仅读取文件、调研分析，禁止编辑文件、执行高危命令；分析完成后输出完整方案，等待用户确认再执行；
适用场景：复杂代码改动前对齐方案、代码评审、仅分析不修改的工作场景。
切换顺序：默认模式 → 自动接受编辑模式 → 计划模式 → 默认模式，循环切换。
2. Ctrl + Enter｜换行提交
在输入框内强制换行，同时可快捷提交指令，无需鼠标点击发送，大幅提升输入效率。
四、特殊符号语法（核心语法·新手必记）
1. 感叹号 ! 运行本地终端命令
语法格式：
! + 终端命令功能介绍：无需退出 Claude Code，在对话窗口直接执行本地终端命令，可实现查看文件、运行脚本、安装依赖、查询目录等操作；
使用示例：
!ls查看当前目录下所有文件。
2. @ 符号｜精准绑定文件
2.1 核心作用
精准指定目标文件，避免 AI 自主检索出错；
减少无效文件读取，节省 Token 消耗，提升响应速度；
可加载自定义规则文件，约束 AI 执行逻辑。
2.2 使用示例
输入指令：@1.txt，释义：强制读取当前目录下 1.txt 文件全部内容，作为上下文参考，完成分析、修改、解读等操作。
2.3 本质说明
为 AI 提供固定参考源，替代模糊的口语描述，提升代码编辑、文件分析的精准度。
五、斜杠命令 / ｜内置控制台指令
所有斜杠命令直接在终端输入，回车即可执行，是 Claude Code 内置快捷工具，以下为新手高频常用命令：
/clear：清空当前会话全部上下文，重置对话；
/rewind：会话回滚，撤销上一步操作；
/compact：智能压缩上下文，剔除无效信息，保留核心逻辑，解决上下文溢出、卡顿问题；
/context：查看当前上下文占用比例、剩余额度；
/resume：恢复历史中断的对话；
/memory：开启本地记忆功能；
/agent：手动创建子 Agent；
/plugins：打开插件管理面板；
/init：在项目根目录自动生成 CLAUDE.md 配置文件。
六、会话回滚（防改错、防误操作）
1. 简易回滚方式
连续按 两下 ESC：快速撤销最近一步操作；
输入 /rewind：精准回滚指定操作步骤。
2. 专业优化建议（重要）
简易回滚存在局限性，强烈搭配 Git 使用，依托 Git 版本库实现永久回滚，彻底规避改错无法恢复的风险，保障项目安全。
七、Git 自动化版本管控（新手必学）
Claude Code 可全自动操控 Git，无需手动输入复杂命令，完整自动化流程如下：
自动检测：识别本地是否安装 Git，未安装则自动下载安装；
本地提交：自动扫描项目改动文件，执行 add + commit 操作，保存本地版本；
远程推送：输入远程仓库地址+凭证，自动完成 push 云端推送。
补充说明
若电脑已配置过 Git 账号凭证，新项目无需重复输入账号密码，可直接推送；依托 Git 可随时回滚任意历史版本，大幅降低代码修改风险。
八、上下文窗口优化（解决卡顿、溢出）
1. 三大优化指令
/compact：智能压缩上下文，过滤无效聊天、冗余代码，保留核心逻辑，不中断当前任务；
/clear：彻底清空全部对话记录，风险较高，历史数据不可恢复；
/context：实时查看上下文占用百分比、剩余可用额度。
2. 状态栏实时监控（可选配置）
输入自定义指令：帮我配一个statusLine,能显示当前目录+模型+上下文剩余百分比的功能，重启 Claude 即可生效。
新手备注：该功能非刚需，软件默认自带上下文查询指令，无需额外配置脚本。
九、对话恢复（断点续聊）
1. 指令恢复
输入 /resume，自动恢复上一次中断的会话、任务进度、代码编辑记录。
2. 启动命令恢复
终端输入指令：claude -c，启动软件的同时，直接接续上一轮未完成的对话。
十、个性化配置 CLAUDE.md（永久规则）
CLAUDE.md 是 Claude Code 的专属规则配置文件，文件内写入的规则会被 AI 永久遵守，配置分为三个优先级层级，层级优先级：子文件夹 > 项目根目录 > 全局配置。
1. 全局配置（最高通用优先级）
文件路径：
~\.claude\CLAUDE.md功能作用：适配电脑内所有项目，统一通用规则；
配置示例：记得永远说中文，所有输出通俗易懂，禁止专业术语堆砌。
2. 项目根目录配置
在项目根目录输入 /init，自动生成 CLAUDE.md，仅对当前项目生效，可自定义项目专属编码规范、输出要求。
3. 子文件夹配置
在项目子目录中单独新建 CLAUDE.md，仅管控当前文件夹内的代码文件，适配局部特殊编码规则。
十一、Auto-memory 自动记忆功能
1. 开启方式
输入斜杠命令：/memory，一键开启自动记忆功能。
2. 记忆存储内容
自动保存用户使用习惯、个人身份信息、历史反馈记录、项目资料、参考文件等内容。
3. 权限限制说明
记忆数据仅留存于当前项目，不同项目记忆相互隔离，不会混淆、不会通用。
十二、规范文件联动配置（进阶技巧）
在项目同级目录新建规范文件（编码规范、接口文档、格式要求等），在 CLAUDE.md 中声明强制规则，要求 AI 执行任务时优先读取该规范文件。
配置示例：编写代码时强制读取 coding-standard.md，严格遵循文档内编码规范，统一项目代码风格。
十三、高级扩展（核心进阶功能）
13.1 Skill 技能库（新手重点掌握）
1、什么是 Skill？
Skill 是封装完成的专业技能包，以 SKILL.md 为核心组成文件，可为 AI 拓展专属能力，包含代码审查、文档生成、自动化运维、格式排版等功能，无需手动编写提示词，一键调用。
2、本地安装路径
手动创建文件夹：~\.claude\skills，将下载好的技能文件夹粘贴至该目录。
3、致命避坑要点（重点）
Skill 技能文件粘贴完成后，必须全新开启 Claude 会话；使用 claude -c、/resume 无法识别新技能，务必新建终端窗口。
4、Skill 使用方式
文字指令调用：直接输入指令，例如
使用代码审查skill分析当前项目；面板手动调用：在插件管理面板中手动选择启用对应 Skill。
5、高质量 GitHub 技能仓库（必收藏）
1）官方仓库（必装，稳定）
anthropics/skills
https://github.com/anthropics/skills
2）社区最强全能技能包（推荐）
obra/superpowers
https://github.com/obra/superpowers
3）中文精选 80+ 技能（国内好用）
laolaoshiren/claude-code-skills-zh
https://github.com/laolaoshiren/claude-code-skills-zh
4）Awesome 合集（找技能用）
ComposioHQ/awesome-claude-skills
https://github.com/ComposioHQ/awesome-claude-skills
travisvn/awesome-claude-skills
https://github.com/travisvn/awesome-claude-skills
6、智能技能工具
自带检索 Skill：自动全网搜索优质适配技能；
自带创建 Skill：零基础自定义封装专属技能包。
13.2 MCP 协议
MCP 是第三方工具对接协议，主要用于连接外部软件、API、本地服务，实现跨工具联动。
缺点提醒：该协议 Token 消耗极高，新手无特殊需求不建议使用。
13.3 CLI 命令行工具（OpenCLI）
1、工具作用
拓展 Claude Code 联网能力、第三方数据查询能力，可实现全网资讯采集、图片素材抓取、实时信息查询等功能。
2、安装教程
比如安装opencli，可以直接输入
帮我全局安装 @jackwener/opencli，执行：
npm install -g @jackwener/opencli
装完后执行 opencli —version 验证，成功就告诉我可以了
即可
3、使用示例
输入指令：请用opencli采集穿搭图片素材，即可调用工具完成联网素材采集。
十四、子 Agent（智能分工）
14.1 自动派生
遇到复杂任务时，主 Agent 自动拆分工作流程，生成多个子 Agent 并行处理，适配大型项目、批量代码处理等场景。
14.2 手动创建
输入斜杠命令：/agent，手动自定义子 Agent 的工作职责、操作权限、工作内容。
14.3 调用方式
主 Agent 智能自动调用；
用户手动输入指令触发；
提示主 Agent 自主生成专属子 Agent。
十五、Hook 钩子机制
1、什么是 Hook？
钩子是事件触发机制，自定义触发条件，满足条件后自动执行预设动作，无需人工输入指令。
2、核心作用
实现工具自动化联动，简化重复操作，适配固定流程的工作场景。
3、使用示例
代码编写完成后，自动播放提示音提醒；
任务执行结束，自动发送消息/邮件通知；
文件修改完成，自动备份保存副本。
十六、插件系统（整合全部高级功能）
1、插件定义
插件是 Claude Code 高级功能整合合集，囊括 Skill、MCP、CLI、子Agent、Hook 五大功能，支持一键安装、启用、管理，操作简单便捷。
2、使用方式
输入斜杠命令：/plugins，一键打开插件管理面板，可完成插件安装、卸载、启用、禁用、市场添加等操作。
3、插件市场安装示例（官方技能）
/plugin marketplace add anthropics/skills/plugin install document-skills@anthropic-agent-skills
十七、新手总结+避坑清单
1、必记快捷键
Shift+Tab（模式切换）、Ctrl+Enter（换行提交）、双击ESC（快速回滚）
2、核心特殊符号
!（执行本地命令）、@（精准绑定文件）、/（斜杠内置指令）
3、新手重大避坑要点
Skill 技能安装后必须新开终端会话，Resume 恢复会话无法识别新技能；
OpenCLI 工具务必安装 0.9.6 稳定版，高版本存在兼容报错；
谨慎使用 /clear 清空指令，日常优化上下文优先使用 /compact；
所有开发项目建议绑定 Git 仓库，防止代码改错无法回滚；
新手优先使用中转密钥，规避官方网络无法访问、卡顿问题。
4、最优学习顺序推荐
安装配置 → 快捷键+特殊符号 → 斜杠命令 → Git版本管控 → CLAUDE.md个性化配置 → Skill技能库 → OpenCLI工具 → 子Agent/插件系统
