企业官网建设流程全解析

Claude code

Claude Code 是一个可编程、可扩展、可组合的 AI Agent 框架。

一、架构分析

Claude Code 的底层能力从技术上拆解，可以分成四个层次
从底层记忆到顶层编程接口，它的架构设计遵循了渐进式控制的原则：既可以通过自然语言进行轻量级交互，也可以通过编程接口实现复杂的自动化流程。

• 基础层
• 拓展层
• 集成层
• 编程接口层

flowchart TD subgraph L4 ["🔌 编程接口层"] SDK["Agent SDK (Python/TS)"] end subgraph L3 ["🔗 集成层"] Headless["Headless (CI/CD)"] MCP["MCP (外部工具)"] end subgraph L2 ["🧩 扩展层"] Cmd["Commands (手动触发)"] Skill["Skills (自动发现)"] Sub["SubAgents (任务分发)"] Hook["Hooks (事件驱动)"] end subgraph L1 ["🧱 基础层"] Mem["Memory (CLAUDE.md)"] end L4 ==> L3 L3 ==> L2 L2 ==> L1 classDef l4 fill:#e1f5fe,stroke:#039be5,stroke-width:2px,color:#01579b classDef l3 fill:#e8f5e9,stroke:#43a047,stroke-width:2px,color:#1b5e20 classDef l2 fill:#fff3e0,stroke:#fb8c00,stroke-width:2px,color:#e65100 classDef l1 fill:#fce4ec,stroke:#d81b60,stroke-width:2px,color:#880e4f class SDK l4 class Headless,MCP l3 class Cmd,Skill,Sub,Hook l2 class Mem l1

1.1 基础层：记忆与上下文核心

核心组件：Memory (CLAUDE.md 记忆系统)
这是 Claude Code 的“潜意识”与“经验库”。大语言模型本身是无状态的，而 CLAUDE.md 机制赋予了它跨会话的持久化能力。

• 项目级上下文：CLAUDE.md 通常放置在项目根目录，记录了项目的技术栈、架构规范、代码风格偏好以及常用命令。Claude Code 启动时会自动读取，确保每次交互都符合项目规范。
• 记忆的自演进：随着项目的推进，Claude Code 可以根据新的约定和修正，动态更新 CLAUDE.md，实现“越用越懂你”的适配效果。
• 隔离与继承：支持全局 (~/.claude/CLAUDE.md) 与项目级 的记忆配置，实现通用偏好与项目特定规则的隔离

1.2 扩展层：能力与行为引擎

这一层是 Claude Code 展现出“智能体”特征的关键，它由四种不同触发和运行机制的模块组成。

• Commands (手动触发)：用户显式调用的指令（如 /fix、/pr）。这是最高效的确定性交互方式，适用于流程固定、需要人工明确意图的场景。
• Skills (自动发现)：Claude Code 的“条件反射”。系统会根据当前的工作环境（如检测到 package.json 发现是 Node 项目，或检测到报错日志）自动激活相关技能。无需用户干预，实现“所想即所得”。
• SubAgents (任务分发)：处理复杂任务的“分身术”。当面临大型重构或多文件修改时，主 Agent 会将子任务拆解分发给 SubAgents 并行处理。这大大缩短了执行时间，并确保每个 SubAgent 专注于单一上下文，减少幻觉。
• Hooks (事件驱动)：系统的“神经系统”。通过监听特定事件（如文件保存后、代码提交前、命令执行后），自动触发预设的逻辑。例如：代码生成后自动触发 Linter 检查，或在提交前自动补充测试用例

1.3 集成层：外部世界连接器

Claude Code 的价值不仅在于生成代码，更在于与现有工程生态的无缝融合。

• Headless (CI/CD 集成)：无头模式允许 Claude Code 脱离终端 UI，在服务器后台运行。这使得它可以嵌入 GitHub Actions、GitLab CI 等流水线中，实现自动代码审查、依赖升级、PR 自动生成与冲突解决。
• MCP (外部工具)：模型上下文协议是 Claude Code 的“万能插头”。通过 MCP，Claude Code 可以安全地连接数据库、调用第三方 API（如 Jira、Slack）、操作浏览器，甚至控制本地 Docker 容器。它打破了沙盒限制，让 AI 真正具备了操作数字世界的能力

1.4 编程接口层：开发者赋能极限

核心组件：Agent SDK (Python / TypeScript 编程驱动)

如果说前三层是“使用者”的视角，那么这一层则是“创造者”的视角。

• 代码即智能体：用代码精确控制 Prompt 注入、工具调用顺序及异常重试策略。
• 工作流编排：将 Claude Code 嵌入业务系统，构建如“需求转代码”平台或“自动排障”运维机器人。
• 类型安全：依托 TS/Python 类型系统定义严格的输入输出 Schema，确保 AI 返回的结构化数据能被下游安全消费。

1.5 架构总结

这四个层次并非孤立存在，而是构成了一条从人机交互到全自动化的演进链路
Memory 是基础设施，始终存在；扩展层是能力中心，按需激活；Hooks 是守门人，监控一切。

二、Plugins

Claude Code Plugins 将原本零散的 Slash Commands、MCP 工具和自动化脚本整合成了标准化的模块。对于团队而言，这意味着可以将最佳实践和工具链打包成插件，新成员只需一行命令即可拥有与团队完全一致的开发环境和 AI 辅助能力，大幅提升了开发效率与体验

2.1 包含内容

一个 Claude Code Plugin 并不是单一的脚本，它将以下五种核心能力打包在一起：

• Slash Commands（快捷命令）：如 /lint、/test、/create-component 等自定义快捷指令。
• Subagents（专业化 AI 子代理）：针对特定任务定制的 AI 代理，拥有专属的系统提示和上下文。
• MCP Servers（外部工具集成）：通过 MCP 协议连接 GitHub、Figma、数据库等外部工具或数据源。
• Hooks（事件钩子）：在特定事件触发时自动执行操作，例如在 Git 提交前自动运行代码检查。
• LSP 配置（语言服务器协议支持）：提供代码语法分析、自动补全等语言服务支持

2.2 使用

Claude Code 提供了简洁的命令行指令来管理插件的生命周期：

• 添加插件市场源：

  /plugin marketplaceadd<作者/仓库>

  例如：/plugin marketplace add jarrodwatts/claude-hud
• 安装插件：

  /plugininstall<插件名>

• 验证与管理：

  /plugin list--installed# 查看已安装插件/plugin status<插件名># 查看特定插件状态/reload-plugins# 重新加载插件（安装后生效）

2.3 实际应用场景与案例

场景一：前端组件开发工作流
假设你在开发一个 Vue 3 组件库，通过安装对应的组件开发插件，你可以直接使用/create-component Button命令。插件会自动调用内部的 Subagent 和 Hooks，一键生成组件文件、路由、测试用例和文档，省去了手动创建和配置的繁琐。

场景二：状态栏增强插件
这是目前非常受欢迎的实用插件之一。原生的 Claude Code 界面无法直观显示上下文和额度使用情况，而claude-hud插件可以在终端底部常驻一行状态栏，实时显示：

• Context：当前会话消耗的上下文百分比（方便及时/compact）。
• Usage：5小时滚动窗口的额度用量及重置倒计时。
• Weekly：每周配额用量及重置倒计时。
• 环境信息：当前使用的模型、项目目录和 Git 分支（防止在多个 worktree 间切错分支）。

安装后只需运行/claude-hud:setup即可将其配置为默认状态栏，直接生效。

三、方案选型核心逻辑拆解

1. 选 Commands：当你需要**“人为主控、按需执行、规范模板”**时。它像是一个工具箱，人拿起来用，保证动作标准。
2. 选 Skills：当你需要**“潜移默化、专业赋能、上下文感知”**时。它像是 Agent 的被动技能，在合适的时候自动展现专业度。
3. 选 SubAgents：当你面临**“信息过载、过程冗长、只需结论”**时。它像是外包员工，把脏活累活隔离出去，只交回一份精简报告。
4. 选 Hooks：当你需要**“即时响应、无感自动化、监听事件”**时。它像是条件反射，发生 A 就立刻做 B。
5. 选 MCP：当你需要**“突破信息孤岛、连接外部系统”**时。它像是万能转接头，让 Agent 具备操作外部工具的能力。
6. 选 Headless + SubAgents：当你需要**“脱离 GUI、融入流水线、并行处理”**时。它像是不需要休息的夜班车间，在 CI/CD 中静默运转。
7. 选 Agent SDK：当你需要**“复杂业务逻辑、状态流转、极高自由度”**时。它像是白纸，允许你用代码从零编织一切规则。

四、底层模型选型