第一阶段：核心环境搭建

在开始使用前，必须安装支撑 AI 运行的三个底层工具。

  1. 安装 Git（版本控制）
  • 操作步骤： 在搜索引擎中搜索“git 安装”或“git install”，进入官方网站 1。
  • Windows 用户： 在网页点击下载 Windows 安装包，下载后直接双击完成常规安装 2。
  • macOS 用户： 点击 macOS 选项，复制网页提供的单行安装命令，打开电脑自带的“终端 (Terminal)”应用，粘贴命令并回车运行（若提示缺少 Homebrew，需先按提示链接安装 Homebrew）2。
  1. 安装 VS Code（代码编辑器）
  • 操作步骤： 搜索“VS Code 安装”进入官网，网页会自动识别您的操作系统 2, 3。
  • 安装： 点击下载按钮获取安装包。Windows 用户双击安装；Mac 用户将下载的文件拖入“应用程序 (Applications)”文件夹 3。
  • 首次打开： 在应用列表中搜索“VS Code”并打开，如果弹出要求登录的界面，可以直接跳过登录 3。
  1. 安装 Claude Code 本体
  • 操作步骤： 前往 Claude Code 官网，复制页面上提供的一行安装命令 3。
  • 执行安装： 打开刚刚安装好的 VS Code，唤出底部的终端（Terminal），将命令粘贴进去并敲击回车 2, 3。
  • 验证： 等待系统自动安装，当终端出现 installation complete 字样时，即代表安装成功 3。

第二阶段：绕过限制，配置第三方大模型

如果您无法直接使用 Claude 官方模型，可通过开源工具 CC Switch 接入 DeepSeek、Minimax 等其他厂商模型。

  1. 安装 CC Switch
  • 获取命令： 在开源社区（如 GitHub）找到 CC Switch 项目页面，下拉找到安装命令 4。
  • 执行安装： Windows 用户在 release 页面下载专用安装包；Mac 用户复制两行安装命令，在 VS Code 终端中粘贴并回车 4。
  • 打开应用： 安装完成后，在电脑应用列表中搜索“CC”打开 CC Switch 应用程序 4。
  1. 绑定第三方模型
  • 添加 API： 在 CC Switch 界面点击右上角的“+”号 4。
  • 填写信息： 选择您想使用的模型提供商（例如 Minimax 或 DeepSeek），选择具体模型，并填入您在厂商平台获取的 API Key，点击添加 4。
  • 生效验证： 回到 VS Code 的终端，输入命令 cloud 打开 Claude Code，您会在底部状态栏看到当前默认模型已经切换为您刚添加的第三方模型 5。

第三阶段：图形化界面配置与基础交互

告别纯代码黑框，使用官方 UI 插件获得直观的操作体验。

  1. 安装官方 UI 插件
  • 点击 VS Code 最左侧边栏的“管理插件”图标（通常是四个方块的图标）6。
  • 在搜索框输入 cloud code，找到带有 Anthropic 官方蓝标的插件并点击“安装” 6。
  1. 优化界面布局
  • 安装后，左侧边栏和右侧边栏都会弹出 Claude Code 的标志 6。
  • 调整： 为了不阻挡左侧查看文件目录的视线，建议将聊天面板拖拽到右侧边栏 7。您可以点击右侧上方的放大按钮全屏查看，或点击“X”关闭 7。
  1. 基础交互操作
  • 开启对话： 点击面板上的“+”号可以开启新的对话线程，点击历史按钮可找回过往对话 7。
  • 引入上下文： 对话框上方有 Add context 按钮，您可以直接点击左侧文件树里的文件，或者在右侧面板点击文件将其加入上下文，此时该文件名会出现在对话框下方，代表 AI 已经能“看”到它了 7, 8。

第四阶段：配置全自动工作权限 (Permissions)

默认情况下 AI 每次修改代码都会询问您，如果您想让它独立完成工作，需要配置权限。

  1. 理解四种权限模式通过点击对话框右下角的权限按钮可进行切换：
  • Plan mode（计划模式）： 只出方案，不修改任何文件 9。
  • Ask before edit（默认）： 每次执行写入操作前，需要您手动点击 Yes 放行 9。
  • Edit automatically： 自动执行常规编辑和创建文件夹命令，但遇到诸如 open（打开网页）或网络请求等敏感命令时仍会询问 9-11。
  • Bypass permissions（最高权限）： 彻底全开，全自动执行所有命令，不再询问 9, 11。
  1. 开启最高权限（推荐实战使用）
  • 方法一（界面操作）： 点击 VS Code 左上角菜单 -> Code -> Settings -> Settings，搜索 Allow dangerous shell permissions，在 Claude Code 扩展选项中勾选该项 11。
  • 方法二（终端命令）： 在终端直接输入 clouddangerous key permissions 并回车即可开启 11。

第五阶段：构建进阶能力 (Hooks, Skills, Plugins)

将您的专属规范和经验固化到 AI 中。

  1. 创建 Hooks（钩子：关键节点拦截器）
  • 作用： 在 AI 准备交差前强制检查。例如规定它没有跑通测试就不准结束 12-14。
  • 操作： 直接在聊天框用自然语言命令：“帮我创建一个 Hook，要求在任务结束前（stop 节点）必须检查测试结果，如果有没做完的继续工作” 14。
  • 查看： AI 会自动在项目的 .cloud/settings.json 文件中生成相应规则代码 14。
  1. 创建 Skills（技能：标准化工作流）
  • 作用： 将反复使用的提示词和操作步骤打包。例如做 PPT 或检索报告 15。
  • 操作： 在聊天框输入：“生成一个名为 research to slide 的 Skill。先去网上仔细搜索，再整理信息，最后调用 PPT 技能生成文档” 16, 17。
  • 查看： AI 会在 .cloud/skills/ 目录下生成包含操作说明的 skill.md 文件 17, 18。
  1. 安装 Plugins（插件：外接大礼包）
  • 作用： 插件是 Skills、Hooks 和连接外部工具接口的集合体 17, 19。
  • 操作： 在聊天框输入 /plugin 唤出插件管理界面，选择 manage plugin 按回车 19。
  • 推荐安装： 找到 superpowers（包含优秀开发实践的插件），点击 install for you 进行全局安装 20, 21。

第六阶段：配置子智能体与自动化

利用多线程大幅提升效率。

  1. 部署子智能体 (Subagents)
  • 操作： 打开 VS Code 终端，输入 _agents 唤起命令 22。
  • 配置路径： 使用方向键选择 Project -> Generate with Claude 23。
  • 设定属性： 在终端中用自然语言描述其职责（如：“创建一个帮我搜索并交叉验证信息的助手”），随后按提示选择允许它使用的工具、选择模型、分配界面颜色，并指定将其记忆保存在当前项目（Project scope）中 23, 24。最后按 Enter 保存。
  • 使用： 主智能体在需要时会自动唤醒并委派任务给子智能体，子智能体会独立思考且不污染主对话记录 22, 25。
  1. 配置自动化任务 (Schedule)
  • 操作： 在对话框输入类似指令：“使用 _schedule 命令帮我创建一个定时任务，每天早上8点使用子智能体搜索昨天的 AI 新闻并总结” 25。
  • 注意限制： 该自动化任务必须运行在云端，因此需要消耗官方 Claude 的订阅额度，不支持第三方厂商的 API 20。

第七阶段：正式项目实战工作流

准备开发具体项目（如网页 App）时的标准操作顺序：

  1. 初始化项目说明书
  • 操作： 在终端输入 _init 26。
  • 效果： Claude Code 会扫描您的项目，自动生成 cloud.md。这是给 AI 看的全局说明书，包含技术栈、架构和规范，之后 AI 每次工作都会自动加载它，避免反复提问 26, 27。
  1. 配置本地环境变量
  • 操作： 如果项目需要用到大模型 API（如 DeepSeek），在左侧文件树中找到或创建 .env.local 文件 28。
  • 填写： 将您在厂商控制台生成的 API Key 填入其中并保存（Ctrl + S） 28。
  1. 需求沟通与并行开发
  • 头脑风暴： 在需求描述最后，要求 AI：“先调用 superpowers 插件进行 brainstorming” 21。AI 会连续向您提问确认细节（如文案语言、API 选择、输出方式），消除模糊地带 21, 29。
  • 执行开发： 确认无误后让 AI 开始工作。此时 AI 会自动生成详细的待办清单，并优先采用子智能体驱动（Subagent Driven）模式，并行处理不同模块代码，您只需等待本地预览链接生成即可 28, 30。

**