Claude Code 完整使用指南

本文读完你能做什么

• 从零安装到发起第一次会话
• 理解 Claude Code 的五类核心能力
• 在自己项目里建立可持续的 AI 协作工作流
• 碰到常见问题知道如何自查

一、快速安装（5 分钟）

详细步骤参见《Mac 安装教程》《Windows 安装教程》。这里只给最短路径。

# 1. 装 Node.js 22
brew install node@22

# 2. 装 Claude Code
npm install -g @anthropic-ai/claude-code

# 3. 配置 API（推荐 CC Switch）
brew install --cask cc-switch

# 4. 启动
claude

二、基础操作

2.1 启动与退出

cd 你的项目目录
claude                 # 启动会话
# Ctrl + D 退出 / Ctrl + C 中断当前操作

2.2 高频内置命令

2.3 黄金三规则

1. 目标先行：第一句话说清楚要什么
2. 边界明确：告诉它只改哪些文件
3. 验收标准：说清楚完成的定义

三、五类核心能力

3.1 代码阅读与理解

"请读完 src/api/auth 目录，告诉我登录流程的完整链路。"

3.2 代码编辑与重构

"把 User 类型中的 any 替换为显式类型，不要改动调用方。"

3.3 调试协助

贴上报错 + 复现步骤，让它先提假设而非直接改。

3.4 命令执行

可直接让它运行 git、npm、test、部署命令（需在 .claude/settings.json 授权）。

3.5 文档与测试生成

"为 parseConfig 函数补齐 JSDoc，并写 3 条单元测试覆盖边界情况。"

四、建立项目级工作流

4.1 第一次进入新项目

/init

生成 CLAUDE.md 后手动补充：技术栈、目录约定、禁止事项、验收标准。

4.2 日常节奏

五、成本与配额

• 按模型 Token 消耗计费
• Max 订阅有周配额，超出后降级
• 密集使用建议订阅，偶尔使用按量即可

六、常见问题

本文为骨架版，第二阶段将补充：每类能力的真实项目案例、完整 prompt 示例、进阶玩法。