Appearance
熬夜3个月研究透Claude Code:从安装到进阶完整指南
用3个月的深度使用经验,把Claude Code从安装到进阶用法全部讲透。重点不是告诉你「它是什么」,而是告诉你「怎么用它」。
一、Claude Code到底是什么?
Claude Code是Anthropic公司出品的AI编程助手,可以把它理解成一个住在终端里的超级程序员。
与Copilot的区别
| 工具 | 方式 |
|---|---|
| Copilot | 在你写代码的时候,给你说「嘿,我建议你这样写」 |
| Claude Code | 你告诉它「给我把这个功能做了」,它直接帮你全部搞定 |
Copilot是给你递扳手的,Claude Code是直接帮你修车的。
它能做什么
| 能力 | 说明 |
|---|---|
| 读写文件 | 创建项目、修改代码 |
| 分析代码 | 找出bug、理解逻辑 |
| 执行命令 | 运行测试、部署代码 |
| 理解项目 | 帮你理解陌生项目 |
| 写文档 | 测试用例、README、注释 |
| Code Review | 检查代码质量 |
二、安装配置:10分钟搞定
2.1 安装前准备
1. Node.js环境
bash
node --version
npm --version去 https://nodejs.org/ 下载安装。
2. API Key
去 https://console.anthropic.com/ 注册账号,创建API Key。
重要提醒:Key千万不能泄露,更不能上传到GitHub!
2.2 安装步骤
bash
# 第一步:安装Claude Code
npm install -g @anthropic-ai/claude-code
# 第二步:验证安装
claude --version
# 第三步:启动
claude2.3 配置API Key
方式一:环境变量
bash
export ANTHROPIC_API_KEY=your-api-key方式二:配置文件
创建 ~/.claude/config.json:
json
{
"apiKey": "your-api-key"
}三、三种工作模式
| 模式 | 说明 | 适合场景 |
|---|---|---|
| Default | 每次操作都需要确认 | 首次使用、不熟悉的操作 |
| Accept Edits | 文件修改自动执行 | 信任Claude的常规开发 |
| Plan Mode | 只分析不执行 | 复杂任务、重要修改 |
Shift+Tab切换模式
四、高效使用技巧
4.1 CLAUDE.md配置
markdown
# 项目:电商后台
## 技术栈
- Next.js 14 + TypeScript
- Prisma + PostgreSQL
## 代码规范
- 函数式组件 + Hooks
- API路由在 /app/api/
## 硬性规则
- 分页默认20条
- 时间格式ISO 86014.2 Hooks自动化
json
{
"hooks": {
"PostToolUse": [{
"matcher": "Write|Edit",
"command": "npx prettier --write $FILE"
}]
}
}4.3 上下文管理
| 操作 | 命令 | 时机 |
|---|---|---|
| 压缩 | /compact | 50%时主动执行 |
| 回退 | /rewind | 走偏了回退 |
| 清除 | /clear | 新任务新会话 |
五、常见问题
| 问题 | 解决 |
|---|---|
| 安装失败 | 检查Node.js版本,用管理员权限 |
| API连接失败 | 检查Key是否正确,网络是否通畅 |
| 响应慢 | 正常,复杂任务需要时间 |
| 上下文超限 | 用/compact压缩 |
六、进阶用法
子Agent
用子Agent帮我重构这个模块复杂任务拆给子Agent,主Agent保持整洁。
批量操作
帮我给src目录下所有.ts文件加上eslint-disable项目分析
分析这个项目的架构,给我一个概览总结
安装:npm install -g @anthropic-ai/claude-code
核心技巧:CLAUDE.md配置 + Hooks自动化 + 上下文管理
效率关键:Accept Edits模式 + 后台任务 + /compact及时压缩
一句话:你告诉它要什么,它帮你全部搞定——这才是Claude Code的正确打开方式。
