Claude Code 封神指南：从安装到架构实战

Claude Code 封神指南：从安装到架构实战

Claude Code 不是普通的聊天机器人，它是运行在你终端里的"全栈工程师"。它能直接读取你的代码库、修改文件、运行测试，甚至帮你排查 Docker 问题。这篇天花板级教程将带你从零搭建环境，直达架构级实战。

一、环境搭建：3 分钟极速安装

1. 安装 CLI（推荐原生安装）

根据你的操作系统选择一条命令执行：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | sh

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

# 验证安装
claude --version

2. 启动与登录

进入你的项目根目录启动（关键：必须在项目目录下，才能读取上下文）：

cd ~/your-project
claude

首次运行会提示登录（需拥有 Claude Pro 账号），登录后即可进入交互式会话。

二、核心配置：让 AI 懂你的"规矩"

1. 权限管理（防炸库）

新手最怕 AI 乱删文件。使用 /permissions 命令设置安全策略：

• 读权限：Allow（允许读取文件结构）
• 写权限/运行命令：Ask（操作前必须确认）
• Git 操作：Deny（生产环境慎用）

2. 项目宪法：CLAUDE.md

在项目根目录创建 CLAUDE.md，这是 Claude Code 的"施工图纸"，必须包含以下内容：

# Project: My App
## Tech Stack
- Backend: Spring Boot 3 (Java 17)
- Frontend: Vue 3 + TypeScript
- Database: MySQL

## Coding Rules
- 禁止使用 `@Autowired`，必须使用构造器注入
- 接口返回必须封装为 `Result<T>`
- 所有 Service 必须写单元测试（JUnit 5 + Mockito）

## Commands
- 启动: `docker-compose up -d`
- 测试: `mvn test`
- 构建: `mvn clean package -DskipTests`

## 禁区
- 不要修改 `application-prod.yml`
- 不要自动执行 `git push`

三、实战演练：解决你的 Docker 痛点

结合你之前提到的 Docker Compose 更新需求，以下是 Claude Code 的自动化解决方案：

场景：自动检测镜像更新并重建

在 Claude Code 会话中输入以下指令：

请检查当前目录下的 docker-compose.yml 文件。

1. 对比 Docker Hub，找出有更新的服务。
2. 生成一个更新脚本，执行 docker-compose pull 并强制重建容器。
3. 执行后验证服务状态。

Claude Code 的执行流程：

1. 读：解析 YML 文件，获取镜像标签。
2. 查：调用工具检查远程仓库（需权限）。
3. 写 ：生成 update.sh 脚本（包含 docker-compose pull && docker-compose up -d --force-recreate）。
4. 跑 ：在确认后执行脚本，并运行 docker-compose ps 验证状态。

四、进阶技巧：架构师级用法

1. 模型切换策略

• 日常编码 ：Claude 3.5 Sonnet（性价比最高，响应快）。
• 复杂架构 ：Claude 3.5 Opus（处理大型重构、微服务设计）。
• 切换命令 ：会话中输入 /model 或 Ctrl+P 快速切换。

2. Plan Mode（规划模式）

对于高风险操作（如数据库迁移、API 大改），使用 /plan 模式：

• Claude 会先只读分析，输出详细的修改步骤和影响范围。
• 你确认方案无误后，输入 execute 它才会真正动手修改文件。

3. IDE 集成（VS Code）

在 VS Code 终端启动 Claude Code 后，使用 /ide 命令连接：

• Claude 能直接看到你当前打开的文件和选中的代码。
• 修改代码时，会在 VS Code 中显示 Diff 对比，像 Code Review 一样逐行确认。

五、避坑指南

1. 上下文爆炸 ：长时间对话后，使用 /compact 压缩历史，或 /clear 清空会话，避免模型"失忆"。
2. 危险操作 ：切勿使用 --dangerously-skip-permissions 参数，除非你完全信任 AI。
3. 成本控制 ：状态栏可显示 Token 消耗，复杂任务建议先用 /plan 预估工作量。

六、封神 Prompt 模板

直接复制使用这段"天花板级"指令，让 Claude Code 进入最佳工作状态：

你是我项目的资深架构师。请遵循以下流程：
1. **先问**：对于模糊需求，先向我提问澄清边界。
2. **规划**：输出详细的执行步骤和风险点（类似 /plan）。
3. **执行**：修改文件前必须逐文件展示 Diff。
4. **验证**：最后自动运行测试（如 `mvn test`）并报告结果。

当前任务：<在此处填写你的具体需求>

总结 ：Claude Code 的本质是**"带思考过程的自动化脚本"**。用好 CLAUDE.md 定义规则，用 /plan 控制风险，你就能真正把它变成团队里的"首席代码机器人"。