Claude Code 是 Anthropic 官方推出的 AI 原生编码工具，将大语言模型能力深度集成至终端，支持通过自然语言完成代码生成、重构、调试、文档编写等全栈开发任务。区别于传统补全工具，它可理解项目上下文，实现真正意义上的智能协作编程。
Claude Code 基于 Node.js 构建，安装前请确保系统已安装 Node.js 18 或更高版本。安装过程简洁，通常仅需数分钟。
为什么需要 Claude Code？
传统开发需在编辑器、终端、浏览器与文档间频繁切换。Claude Code 将多工作流整合于统一终端界面：可同步编写代码、运行测试、查阅文档、协同开发。其核心优势在于理解项目结构、记忆编码习惯，成为真正懂项目的编程助手。
安装方法
方法一：手动安装
适用于希望掌控全流程的开发者。
# 全局安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version安装过程中 npm 会自动下载依赖并配置环境变量。如遇权限问题，macOS/Linux 用户可在命令前加 sudo，Windows 用户请以管理员身份运行终端。
方法二：AI Agent 协助安装
若已使用 Cursor、Windsurf 等 AI 编程助手，可交由其自动完成安装。AI 将检测环境、处理依赖冲突，并按系统配置选择最优安装路径。
输入指令示例：
帮我装 anthropic 的 claude code或更明确地指定：
安装 claude code cli，并检查 Node.js 版本是否兼容AI Agent 将自动执行以下操作：
- 检查当前 Node.js 版本
- 提示升级（如版本不兼容）
- 执行安装命令
- 验证安装结果
- 异常时尝试自动修复
首次启动与初始化
安装完成后，进入项目目录启动：
# 进入项目目录
cd /path/to/your/project
# 启动 Claude Code
claude首次启动将引导完成关键初始化步骤，包括登录 Anthropic 账户（无账户者系统将提示注册）。
快速开始：做点小实验
建议先通过三个渐进式实验熟悉核心能力：自然语言理解、内容生成与代码执行。
实验 1：对话 —— 感受 AI 的理解能力
体验 Claude Code 的上下文感知与多轮对话能力。
可尝试以下提问：
你好，你是谁？
什么是闭包？太长不看版本
JavaScript 和 TypeScript 有什么区别？观察其“倒金字塔”式回答风格：先给核心结论，再展开细节，便于快速获取关键信息。
实验 2：生成 Markdown 文档 —— 体验内容创作
输入指令：
帮我写一份 Git 常用命令的 Markdown 文档
要求：包含命令、说明、示例Claude Code 将自动分析需求、规划结构（按初始化、日常开发、分支管理等场景分类）、生成规范 Markdown 内容，并输出表格化速查表。可追加“添加中文注释”“按使用频率排序”等要求进一步优化输出。
核心技巧
技巧 1：双击 Esc 回退对话 —— 撤销误操作
最常用快捷键，用于高效修正交互失误：
按一次 Esc → 清除当前输入（类似 Ctrl+C）
按两次 Esc → 回退至上一轮对话状态
按三次 Esc → 清空全部对话历史适用场景：
- 误发指令后快速撤回执行
- 对回复不满意，重新组织提问
- 多轮对话导致上下文混乱，一键重置
注意：双击 Esc 仅撤销对话状态，不撤销已执行的代码修改。建议高风险操作前先执行 git commit 或 git stash。
技巧 2：@ 引用文件 —— 精准指定上下文
显式引用提升理解准确性，避免无关文件占用 Token：
推荐写法：
@src/utils.ts 解释这个文件高级用法：
@src/app.tsx @src/components/Header.tsx 这两个文件的关系是什么？
@src/components/ 总结一下这个目录下的所有组件
@src/utils.ts:45-60 解释这段代码的作用
技巧 3：! 执行命令 —— 终端集成
无需切换窗口即可运行终端命令：
!npm test # 运行测试
!git status # 查看 Git 状态
!ls -la # 列出文件典型场景：
!npm test→ 测试失败后让 Claude 分析原因并修复!git diff→ 让 Claude 解读变更内容!npm run build→ 构建报错时自动诊断修复
安全提示：对 rm -rf、sudo 等敏感命令，Claude Code 会强制二次确认。
技巧 4：/plan 先规划后编码 —— 复杂任务的正确打开方式
对耗时超 30 分钟的任务，优先使用 /plan 制定分阶段实施计划。
/plan
我想添加用户认证功能，请帮我制定实施计划
输出为带进度标记的结构化方案（数据库设计→API 开发→前端集成→测试），支持逐阶段执行与动态调整。
技巧 5：/init 自动生成配置 —— 快速初始化项目
/init 命令自动扫描项目，生成 CLAUDE.md 配置文件，作为 Claude Code 的“项目记忆”。
/init生成内容涵盖技术栈（Next.js、TypeScript 等）、常用命令、代码规范等。新项目初始化后建议立即执行，团队成员亦可据此快速上手。
技巧 6：/compact 压缩上下文 —— 节省 Token
当对话达 5–6 轮或 Claude 出现“遗忘”迹象时，运行 /compact 提取关键信息生成摘要，释放上下文窗口（默认 200K Token）。
# 长对话后压缩
/compact
# 压缩后继续工作
现在我们已经完成了用户模块，接下来做订单模块技巧 7：/commit 自动提交 —— Git 工作流自动化
/commit 自动识别变更、生成符合 Conventional Commits 规范的提交信息。
/commit支持进阶用法：/commit --yes（跳过确认）、/commit --dry-run（仅生成不提交）。
技巧 8：Shift+Tab 自动接受 —— 提高流畅度
开启后免确认直接应用代码修改，提升迭代效率。
- 按
Shift+Tab→ 进入自动接受模式 - 再按
Shift+Tab→ 退出模式
注意事项：敏感操作（如删文件、改配置）仍会强制询问；建议始终配合 Git 使用以便回滚。
技巧 9：Ctrl+C 取消操作 —— 紧急制动
中断长时间运行任务或错误指令：
- 按一次
Ctrl+C→ 取消当前操作 - 按两次
Ctrl+C→ 完全退出 Claude Code
与双击 Esc 的区别：Ctrl+C 停止执行中任务；双击 Esc 撤销对话历史。
技巧 10：/context 查看上下文使用 —— 优化 Token 消耗
/context 显示实时 Token 占用、引用文件数及高消耗文件列表，辅助优化成本。
/context输出含健康度评估与优化建议（如将 node_modules 加入 .claudeignore）。
技巧 11：/resume 恢复会话 —— 切换多任务对话
在多任务并行时快速切换上下文，无需重启：
/resume支持场景：A）修复 Bug 与开发新功能来回切换；B）临时查询算法后返回原开发任务；C）中断后继续未完成工作。
| 命令 | 作用 | 使用场景 |
|---|---|---|
/resume |
当前聊天中切换回上一段会话 | 多任务并行，需频繁切换 |
claude -c |
继续最近一次会话 | 退出后重新连接同一会话 |
claude -r |
恢复上一段会话 | 退出后还原会话状态 |
| 双击 Esc | 回退到上一轮对话状态 | 撤销最近一轮交互 |
核心配置
配置文件位置与优先级
Claude Code 采用分层配置机制，优先级从高到低为：项目级 > 用户级 > 默认配置。
CLAUDE.md —— 项目记忆
CLAUDE.md 是项目级核心配置文件，定义技术栈、代码规范、常用命令等。每次启动自动加载，是团队协作与新人上手的关键文档。
快速生成方式：
claude
/init.claudeignore —— 节省 Token
声明无需加载的文件/目录，可降低 40–60% Token 消耗并提升响应速度。
推荐配置项：
# ===== 依赖目录 =====
node_modules/
.pnp/
.pnp.js
# ===== 构建产物 =====
dist/
build/
.next/
out/
*.tsbuildinfo
# ===== 日志文件 =====
*.log
npm-debug.log*
yarn-debug.log*
...
# ===== 敏感信息 =====
.env
.env.local
.env.*.local
# ===== 大型资源文件 =====
*.png
*.jpg
*.svg
*.mp4
权限配置
通过 settings.json 中的 permissions 字段精细控制操作权限：
{
"permissions": {
"allow": ["Bash(git status)", "Edit(src/**/*.{ts,tsx})"],
"ask": ["Bash(git commit:*)", "Edit(package.json)"],
"deny": ["Bash(rm -rf:*)", "Bash(sudo:*)"]
}
}
Rules 规则目录
大型项目可将规范拆分为模块化规则文件，存放于 .claude/rules/ 目录下：
.claude/
├── settings.json
├── CLAUDE.md
└── rules/
├── 00-security.md # 安全规则
├── 01-coding-style.md # 编码风格
├── 10-api.md # API 规范
├── 11-frontend.md # 前端规范
└── 20-testing.md # 测试规范数字前缀控制加载顺序，支持全局规则与路径特化规则的继承与覆盖。
核心操作指令
Slash 命令速查
标准化内置功能，以 / 开头：
符号系统
快捷操作符组合提升效率：
组合示例：
@src/utils.ts !npm test
@src/components/ @src/pages/ 比较这两个目录的结构
!git diff @src/app.tsx 解释这些变更国内使用方案
因网络限制，中国用户可采用以下方式接入：
方案 1：API 代理服务
# 设置环境变量
export ANTHROPIC_BASE_URL="https://your-api-proxy.com/v1"
export ANTHROPIC_API_KEY="your-api-key"
claude方案 2：第三方兼容工具
# 安装兼容版本
npm install -g @some-provider/claude-code
# 配置 API
claude config set api.key your-api-key
claude config set api.baseUrl https://api.some-provider.com方案 3：替代工具
