Claude Code CLI 是 Anthropic 推出的 AI 编码助手，直接在终端中工作。使用前，理解 /init 命令、.claude 目录结构和 .claudeignore 配置是基本功。

一、/init 命令

/init 是 Claude Code 的交互式命令，用于自动扫描整个项目并生成 CLAUDE.md。

当前限制

/init 不支持指定输出目录。它默认生成在两个位置之一：

前言

2025-2026 年，AI 编码助手的能力突飞猛进，但一个老问题始终没解决：每个新会话都要重新解释项目结构、技术栈、规范，而且 AI 经常写出和期望不符的代码。

Spec-Driven Development（SDD） 应运而生——把规范作为真相源（source of truth），让人和 AI 在写代码前先对齐。其中最具代表性的两个框架是 OpenSpec（61.3k ⭐）和 Superpowers（256k ⭐）。

发布日期： 2026-07-17
适用版本： Claude Code v2.1.x+

---

目录

1. 什么是 Claude Code？
2. 系统要求
3. 安装指南
   • 3.1 原生安装（推荐）
   • 3.2 Homebrew 安装（macOS）
   • 3.3 WinGet 安装（Windows）
   • 3.4 npm 安装
   • 3.5 Linux 包管理器安装
4. 验证安装与诊断
5. 认证与登录
   • 配置第三方 API 提供商
6. 升级 Claude Code
   • 6.1 自动更新
   • 6.2 手动更新
   • 6.3 切换发布频道
   • 6.4 禁用自动更新
7. 卸载与完全重置
   • 7.1 卸载程序
   • 7.2 删除配置文件（完全重置）
   • 7.3 重置模型设置
   • 7.4 重置所有自定义配置的终极方案
8. 常用功能案例详解
   • 案例 1：初始化项目与 CLAUDE.md
   • 案例 2：上下文管理 — /compact 与 /clear
   • 案例 3：模型切换与 Effort 控制
   • 案例 4：自定义 Slash 命令
   • 案例 5：Hooks — 自动质量门禁
   • 案例 6：.claudeignore — 砍掉 Token 浪费
   • 案例 7：MCP 服务器集成
   • 案例 8：Headless 模式 — CI/CD 集成
   • 案例 9：并行任务与 Git Worktree
   • 案例 10：批量重构 — /batch 命令
9. 最佳实践总结
10. 常见问题 FAQ