
Cloud Code 全流程实战指南:从环境搭建到高级功能扩展
- 🛠️全流程实战指南:从环境搭建到高级功能扩展
-
- 一、环境搭建与基础交互
- [二、 核心工作模式](#二、 核心工作模式)
- 📊复杂任务处理与终端控制
-
- 一、项目实战:代办软件开发
- 二、终端命令控制
-
- [1. 命令执行:输入`!`进入bash模式🐚,可运行任意终端命令(如`open index.html`)。](#1. 命令执行:输入
!进入bash模式🐚,可运行任意终端命令(如open index.html)。) - [2. 权限管理:](#2. 权限管理:)
- [3. 后台任务管理:](#3. 后台任务管理:)
- [1. 命令执行:输入`!`进入bash模式🐚,可运行任意终端命令(如`open index.html`)。](#1. 命令执行:输入
- 🔄多模态与上下文管理
-
- 一、多模态交互
-
- [1. 图片输入:](#1. 图片输入:)
- [2. Figma设计稿还原:](#2. Figma设计稿还原:)
- 二、上下文管理核心命令
- 🚀高级功能扩展与定制
-
- 一、项目配置文件(cloud.md)
-
- [1. 初始化:执行`--init`生成模板文件📄。](#1. 初始化:执行
--init生成模板文件📄。) - [2. 作用:](#2. 作用:)
- [3. 使用:修改后重启Cloud Code自动生效,通过`--memory`命令快速编辑✏️。](#3. 使用:修改后重启Cloud Code自动生效,通过
--memory命令快速编辑✏️。)
- [1. 初始化:执行`--init`生成模板文件📄。](#1. 初始化:执行
- 二、钩子(Hook)系统
-
- [1. 配置入口:`--hooks`命令进入配置界面⚡。](#1. 配置入口:
--hooks命令进入配置界面⚡。) - [2. 执行时机:支持工具使用前/后、失败时等多种触发条件⏱️。](#2. 执行时机:支持工具使用前/后、失败时等多种触发条件⏱️。)
- [3. 应用示例:代码自动格式化✨](#3. 应用示例:代码自动格式化✨)
- [4. 作用域:本地项目级、共享项目级、用户级🌐。](#4. 作用域:本地项目级、共享项目级、用户级🌐。)
- [1. 配置入口:`--hooks`命令进入配置界面⚡。](#1. 配置入口:
- [三、Agent Skill](#三、Agent Skill)
-
- [1. 定义:动态加载的提示词模板📚,类似"给大模型看的说明书"。](#1. 定义:动态加载的提示词模板📚,类似“给大模型看的说明书”。)
- [2. 创建方法:在`~/.cloud/skills`目录下创建技能文件夹及`skill.md`📂。](#2. 创建方法:在
~/.cloud/skills目录下创建技能文件夹及skill.md📂。) - [3. 使用方式:](#3. 使用方式:)
- [4. 典型应用:生成标准化日报📅、代码规范检查等。](#4. 典型应用:生成标准化日报📅、代码规范检查等。)
- [四、Sub Agent(子代理)](#四、Sub Agent(子代理))
-
- [1. 创建命令:`--agent`选择`Create new agent`👶。](#1. 创建命令:
--agent选择Create new agent👶。) - [2. 核心特性:](#2. 核心特性:)
- [3. 应用场景:代码审核🔍、大型项目分析等资源密集型任务。](#3. 应用场景:代码审核🔍、大型项目分析等资源密集型任务。)
- [1. 创建命令:`--agent`选择`Create new agent`👶。](#1. 创建命令:
- 五、插件系统
-
- [1. 插件管理:`/plugin`命令进入插件管理器🧩。](#1. 插件管理:
/plugin命令进入插件管理器🧩。) - [2. 安装流程:在Discover页面选择插件,支持用户级/项目级安装📥。](#2. 安装流程:在Discover页面选择插件,支持用户级/项目级安装📥。)
- [3. 组成结构:可包含Agent Skill、Sub Agent、Hook等多种组件🧰。](#3. 组成结构:可包含Agent Skill、Sub Agent、Hook等多种组件🧰。)
- [4. 示例:Frontend Design插件可显著提升UI设计质量🎭。](#4. 示例:Frontend Design插件可显著提升UI设计质量🎭。)
- [1. 插件管理:`/plugin`命令进入插件管理器🧩。](#1. 插件管理:
- 📝关键洞察与注意事项
-
- [1. 安全警示:](#1. 安全警示:)
- [2. 版本兼容性:](#2. 版本兼容性:)
- [3. 最佳实践:](#3. 最佳实践:)
- [4. 生态扩展:](#4. 生态扩展:)
- [六、写在最后💡 教学感悟](#六、写在最后💡 教学感悟)
-
- [📋 内容适配说明](#📋 内容适配说明)
- [🚀 致学习者](#🚀 致学习者)
🛠️全流程实战指南:从环境搭建到高级功能扩展
一、环境搭建与基础交互
#全流程实战指南:从环境搭建到高级功能扩展# 1. 安装与登录流程
安装步骤:通过官方网站复制安装命令📋,在终端粘贴执行完成安装。
#全流程实战指南:从环境搭建到高级功能扩展# 2. 登录方式:
- 订阅制:适用于Cloud Pro/Max会员🎫,通过网页授权完成登录
- API Key:按token用量计费💰,需手动配置
- 国产模型兼容:支持GLM、Minimax等模型🇨🇳,通过设置环境变量实现
二、 核心工作模式
Cloud Code提供三种交互模式🔄,通过Shift+Tab循环切换:
| 模式 | 特点 | 适用场景 |
|---|---|---|
| 默认模式(提示文字:? for shortcuts) | 每次文件操作需用户确认✅ | 安全优先,关键文件修改 |
| 自动模式(Accept edits on) | 会话期间自动同意所有文件操作⚡ | 信任任务流程,提升效率 |
| 规划模式(Plan mode) | 只讨论方案不执行操作🗺️ | 复杂需求设计与方案探讨 |
📊复杂任务处理与终端控制
一、项目实战:代办软件开发
基础实现:通过命令cloude启动后🚀,输入用HTML实现代办软件,自动生成index.html。
架构升级:从单文件HTML重构为React+TypeScript+Vite现代架构💎
- 使用规划模式(Plan mode)讨论重构方案🧠
- 通过
Control+G调用VS Code编辑复杂需求⌨️ - 支持多行输入(
Shift+Enter换行↩️,旧版本不支持,建议升级)
二、终端命令控制
1. 命令执行:输入!进入bash模式🐚,可运行任意终端命令(如open index.html)。
2. 权限管理:
- 终端命令默认需用户确认⚠️,无全局自动执行选项
- 危险模式:启动时添加
--dangerously-skip-permissions参数💀,会同时跳过所有文件操作和终端命令的权限检查
3. 后台任务管理:
Control+B:将当前任务放入后台⏸️--tasks:查看后台任务列表📋K:终止指定后台任务❌
🔄多模态与上下文管理
一、多模态交互
1. 图片输入:
- 直接拖放图片至终端🖼️
- 粘贴图片:最新版本Mac系统支持
Command+V📎,旧版本需使用Control+V
2. Figma设计稿还原:
- 通过MCP(模型通信协议)连接Figma🔗
- 安装Figma MCP Server:执行官方提供的安装命令⚙️
- 复制设计稿链接,Cloud Code可获取精确设计参数(间距、字体、样式等)🎨
二、上下文管理核心命令
| 命令 | 功能 | 应用场景 |
|---|---|---|
/compact |
压缩上下文,保留关键信息🗜️ | 提升性能,减少token消耗 |
/clear |
清空所有上下文🧹 | 开始全新任务 |
/rewind |
回滚到指定历史版本⏪ | 撤销错误操作 |
/resume |
恢复上一次对话🔙 | 中断后继续工作 |
注意:回滚功能仅是对ClaudeCode生成的文件有效,终端命令创建的文件需要手动处理。
🚀高级功能扩展与定制
一、项目配置文件(cloud.md)
1. 初始化:执行--init生成模板文件📄。
2. 作用:
- 项目级/用户级配置(分别存于项目目录和用户目录)🏗️
- 定义固定提示词、注意事项等全局规则📜
3. 使用:修改后重启Cloud Code自动生效,通过--memory命令快速编辑✏️。
二、钩子(Hook)系统
1. 配置入口:--hooks命令进入配置界面⚡。
2. 执行时机:支持工具使用前/后、失败时等多种触发条件⏱️。
3. 应用示例:代码自动格式化✨
bash
jq -r .file_path | xargs prettier --write
4. 作用域:本地项目级、共享项目级、用户级🌐。
三、Agent Skill
1. 定义:动态加载的提示词模板📚,类似"给大模型看的说明书"。
2. 创建方法:在~/.cloud/skills目录下创建技能文件夹及skill.md📂。
3. 使用方式:
- 自动触发:大模型识别需求后调用🤖
- 手动触发:
--[skill名称]直接调用🖱️
4. 典型应用:生成标准化日报📅、代码规范检查等。
四、Sub Agent(子代理)
1. 创建命令:--agent选择Create new agent👶。
2. 核心特性:
- 独立上下文、工具和技能🔧
- 仅返回最终结果,不污染主对话🚿
3. 应用场景:代码审核🔍、大型项目分析等资源密集型任务。
五、插件系统
1. 插件管理:/plugin命令进入插件管理器🧩。
2. 安装流程:在Discover页面选择插件,支持用户级/项目级安装📥。
3. 组成结构:可包含Agent Skill、Sub Agent、Hook等多种组件🧰。
4. 示例:Frontend Design插件可显著提升UI设计质量🎭。
📝关键洞察与注意事项
1. 安全警示:
--dangerously-skip-permissions参数会赋予Cloud Code完全终端权限🚨,存在理论风险。
2. 版本兼容性:
部分功能(如Shift+Enter换行、Mac快捷键)需较新版本支持🔄,建议定期升级。
3. 最佳实践:
- 复杂项目建议结合Git使用🐙,弥补Cloud Code回滚功能的局限性
- 通过
cloud.md定义团队规范👥,确保协作一致性 - 利用Sub Agent处理资源密集型任务⚡,保持主对话简洁
4. 生态扩展:
插件市场持续增长📈,已覆盖UI设计、特定语言支持等多个领域。### 环境搭建与基础交互
六、写在最后💡 教学感悟
从一线开发转向 ClaudeCode 教学,最深刻的体会是:编程教学并非「单纯罗列语法📜」,而是通过 ClaudeCode 特有的实战化引导,打通「知识」与「落地」的壁垒🔍。
ClaudeCode 成为教学过程中的「核心工具链🛠️」,帮助将抽象的编程概念转化为可落地的实战案例,从而聚焦于逻辑思维培养和工程化编码习惯塑造📊。
📋 内容适配说明
示例内容基于 ClaudeCode 最新版本环境验证通过✅,修改业务场景与核心参数即可快速复用。若内容对你有启发,欢迎点赞❤️或分享🔄,评论区期待你的「学习实战故事」🗨️------ 无论是语法卡点还是思维突破,共同探讨成长🌱
🚀 致学习者
编程能力的本质是相通的:语法基础能搭建代码的骨架,而 ClaudeCode 赋能的工程化思维则赋予代码生命力。保持探索,每一次卡点都是进阶的契机💪