Nest.js基础-6:关于Claude Code

一、Claude Code 到底是什么

1. 官方定义

Claude Code = 终端原生 AI 编程智能体（Agent） 由 Anthropic 基于 Claude 4（Opus/Sonnet/Haiku） 打造，运行在本地终端，不是网页聊天框、不是 IDE 插件、不是代码补全工具。他是一个能自己干活的 AI 程序员。

2. Agent（智能体） vs 普通聊天机器人

DeepSeek/ChatGPT / 网页 Claude

• 你手动贴代码片段
• 它被动回答
• 无权限碰你本地文件、命令、Git
• 每次对话失忆，要反复介绍项目背景

Claude Code（Agent）

• 自动读取整个代码库（所有文件、目录结构、依赖）
• 主动规划任务：拆解需求 → 找文件 → 改代码 → 跑测试 → 排错
• 有权限执行本地命令：npm、docker、git、shell
• 全程记忆上下文：不用重复解释项目
• 多文件联动修改：改一个接口 → 同步改调用处、文档、测试

普通 AI 只是问答工具 而Claude Code 是能自主执行开发流程的 AI 员工

---

二、技术架构

1. 运行方式

• 本地终端运行（macOS/Linux/Windows 全平台）Claude

• 轻量安装 ：只依赖 Node.js，一行命令安装

  bash

  运行

  curl -fsSL https://claude.ai/install.sh | bash

• 本地模型兼容：可接国产模型（DeepSeek、通义千问、智谱 GLM），国内稳定可用

• 注意也可以用nodejs直接安装，但是官方未来已经不再维护更新nodejs包

2. 核心模块（Agent 内部）

（1）代码库理解引擎

• 自动遍历项目所有文件
• 构建项目图谱：文件依赖、函数调用、模块关系
• 智能缓存：只更新改动文件，大型项目（1000 + 文件）也快

（2）工具调用系统（关键！）

Claude Code 自带一堆 "工具"，能自己调用：

• 文件读写（读 / 改 / 新建 / 删除）
• Shell 命令（npm run、docker、git、build）
• Git 操作（commit、branch、merge、PR）
• 测试运行（jest、pytest、lint）
• MCP 扩展（Playwright 网页测试、Figma 转代码、数据库连接）

（3）记忆系统

• 会话记忆：记住本次对话的所有上下文
• 项目记忆（CLAUDE.md） ： 项目根目录放一个 CLAUDE.md，写清楚：
  • 项目简介、技术栈
  • 启动命令、测试命令
  • 代码规范、目录结构
  • 常见问题 / 坑 每次启动自动读取，永久记住项目规则

（4）多子代理（Agent Teams）

复杂任务可同时启动多个子 AI 分工：

• 主 Agent：统筹、分配任务、合并结果
• 子 Agent A：写后端接口
• 子 Agent B：写前端页面
• 子 Agent C：写测试用例 并行开发，效率翻倍

---

三、核心能力

1. 代码理解：秒懂陌生项目

能做什么

• 自动梳理项目架构图
• 解释核心模块逻辑、数据流
• 标注关键文件、入口、依赖
• 找出技术债、烂代码、潜在 bug

例子（ 比如上一节的Node 游戏服务器）

输入：

plaintext

帮我梳理这个 game-server 项目的架构，说明每个文件作用和启动流程

Claude Code 会：

1. 自动读 app.js、package.json、目录结构
2. 输出：
   • 入口：app.js（启动 HTTP + WebSocket 服务）
   • 依赖：Express、Socket.io、Redis
   • 目录：/routes（接口）、/controllers（逻辑）、/utils（工具）
   • 启动流程：初始化 Redis → 启动 Express → 绑定 Socket.io → 监听端口

2. 代码创作：从 0 到 1 写功能

能做什么

• 写接口、函数、组件、配置文件
• 生成 Dockerfile、docker-compose.yml、package.json
• 批量生成 CRUD 代码
• 按规范写注释、文档

例子（给游戏服务器加一个 "玩家登录接口"）

输入：

在 game-server 里加一个 POST /api/login 接口，接收 username 和 password，返回 token，用 JWT，存在 Redis

Claude Code 会自动：

1. 安装依赖：npm install jsonwebtoken redis
2. 新建 / 修改文件：
   • routes/login.js（接口路由）
   • controllers/loginController.js（逻辑）
   • utils/jwt.js（JWT 工具）
   • utils/redis.js（Redis 连接）
3. 自动在 app.js 注册路由
4. 写好注释和错误处理
5. 运行测试：npm test

全流程自动完成。

3. 调试 & 修复 Bug：自动排错、自动修复

能做什么

• 分析报错日志、堆栈信息
• 定位 bug 所在文件、行号
• 给出修复方案并自动改代码
• 修复后自动跑测试验证

例子（游戏服务器启动报错：端口被占用）

输入：

npm start 报错：Error: listen EADDRINUSE: address already in use :::3000

Claude Code 会：

1. 自动执行：lsof -i :3000 找占用进程
2. 给出方案：
   • 方案 1：杀掉进程 kill -9 <pid>
   • 方案 2：改端口为 3001
3. 自动修改 app.js 端口为 3001
4. 重新启动服务：npm start

全程不用你敲命令，它自己搞定。

4. 重构 & 优化：清理烂代码、提升性能

能做什么

• 重构老旧代码、统一风格
• 拆分大函数、消除重复代码
• 优化性能（减少查询、缓存数据）
• 修复安全漏洞（SQL 注入、XSS）

例子（把游戏服务器里一个 500 行的大函数拆成小模块）

输入：

重构 controllers/gameController.js 里的 handleGameLogic 函数，拆成 3 个小函数，保持功能不变

Claude Code 会：

1. 分析原函数逻辑
2. 拆分为：
   • validatePlayerInput()（参数校验）
   • processGameAction()（核心逻辑）
   • broadcastGameState()（广播状态）
3. 自动修改调用处
4. 运行测试确保功能一致

5. Git 集成：自动提交、写 Commit、发 PR

能做什么

• 查看 git 历史、对比差异
• 暂存、提交、推送代码
• 自动写规范的 commit 信息
• 创建分支、合并分支、发 PR

例子（写完登录接口后提交代码）

输入：

提交所有修改，commit 信息：feat: add user login api with JWT & Redis

Claude Code 会：

bash

运行

git add .
git commit -m "feat: add user login api with JWT & Redis"
git push

其实个人不建议连git提交都是用claude code，这种东西我自己习惯手动操作

6. MCP 扩展：连接外部工具

MCP = Model Control Protocol（模型控制协议） 让 Claude Code 能调用外部服务，相当于给 AI 装插件。

常用 MCP

• Playwright MCP：自动写网页测试、爬虫、截图
• Figma MCP ：上传 Figma 设计稿，一键生成前端代码（React/Vue）
• GitHub MCP：自动处理 Issue、Review 代码、合并 PR
• Database MCP：连接 MySQL/PostgreSQL，自动写 SQL、建表、查数据

例子（Figma 设计稿转游戏官网）

你输入：

用 Figma MCP 把这个设计稿转成 React 页面，适配移动端

Claude Code 会：

1. 读取 Figma 设计
2. 生成 React 组件、CSS 样式
3. 自动适配响应式
4. 运行项目预览

---

四、和上一节内容Docker结合

1. 自动生成 Docker 配置

输入：

给这个 game-server 生成 Dockerfile 和 docker-compose.yml，用 Node 20，暴露 3000 端口

Claude Code 会自动生成：

dockerfile

# Dockerfile
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["node", "app.js"]

yaml

# docker-compose.yml
version: '3'
services:
  game-server:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/app
    environment:
      - NODE_ENV=development

2. 一键启动 Docker 服务

输入：

用 docker-compose 启动服务，后台运行

Claude Code 会执行：

bash

运行

docker-compose up -d

3. 调试 Docker 容器内的服务

输入：

查看 docker 容器日志，找出游戏服务器连接 Redis 失败的原因

Claude Code 会：

1. docker-compose logs -f 看日志
2. 分析 Redis 连接配置
3. 给出修复方案（如改 Redis 地址为 redis://redis:6379）
4. 自动修改配置文件并重启容器

---

五、适用人群 & 不适用人群

适合

• 全栈开发者：提升日常开发效率
• 后端 / 游戏服务器开发：快速写接口、逻辑、Docker 配置
• 接手老旧项目的人：快速理解、重构、排错
• 独立开发者 / 小团队：一人顶三人，快速迭代
• 学习编程的人：边做项目边学，实时解释代码

不适合

• 想完全不看代码、直接上线的人（AI 可能犯错，必须审核）
• 不愿意学习新工具、坚持传统开发方式的人
• 对代码质量、安全要求极高且不允许任何自动修改的企业级核心系统

在游戏开发中，AI输出的代码质量只能保证功能，在项目契合度上有可能会有问题，所以一定要人工的去看每一行代码是否合乎个人的思路。即使这样效率也要比手搓代码快太多。

---

七、总结

Claude Code 是跑在本地终端、能读懂整个代码库、自主执行开发全流程（写代码→测试→排错→Git 提交）、支持 MCP 无限扩展的 AI 编程智能体，是 2026 年提升开发效率的必备工具。