Brand OS 跨境电商课

主题

第3课 装好工具，跑通第一个 Skill ​

开场：让 AI 帮我做了一件真正有用的事 ​

我用 Agent 做的第一件真正有用的事，是让它每天早上整理一遍竞品评论里的新词。我自己做这件事大概要二十分钟，它跑完不到一分钟。

那次之后我才认真想：什么事情交给它划算，什么事情还是得我自己来。

这门课里，你会在第6课开始跑 Hound 的 market-scout，第10课跑 Parrot 的 brand-story，第16课跑 Bee 的 audience-finder。这些 Skill 都跑在 Claude Code 上——你现在需要先把环境装好，这样后面每一课的作业都可以真正动手，而不是只看例子。

安装大概需要5-10分钟。

你在安装什么 ​

Brand OS 的 Skill 跑在 Claude Code 上——这是 Anthropic 官方出的 CLI（命令行界面），让你在终端里用对话方式调用 AI。

不是网页，不是 App，是在电脑终端里打命令。

听起来有技术感，但实际操作是这样：打开终端，输入 claude，然后用自然语言说"帮我用 brand-story skill 生成品牌故事"。AI 开始工作，读取你的 context.json，运行 Skill，把结果写入文件。整个过程不需要写代码，不需要懂 API，只需要会在终端打字。

安装步骤（5分钟完成） ​

第1步：安装 Node.js。 Node.js 是运行 Claude Code 的底层环境。先检查是否已有：

bash
node --version

显示版本号（如 v20.11.0）就不用装。如果提示"command not found"，去 nodejs.org 下载 LTS 版本，装好后重开终端。

第2步：安装 Claude Code。

bash
npm install -g @anthropic-ai/claude-code

-g 表示全局安装，装完后在任何文件夹都能用 claude 命令。安装完运行 claude --version，显示版本号就成功了。

第3步：登录。 运行 claude，第一次会要求登录 Anthropic 账号或输入 API Key。按提示操作。如果通过课程拿到了 API Key，直接输入 Key 即可。

第4步：安装第一个 Brand OS Skill。

bash
npx skills add Tenx/BrandOS/hound/market-scout -g

这条命令从 GitHub 拉取 market-scout Skill，安装到你的全局 skills 目录。安装完成后，在任何文件夹里运行 claude，直接说"用 market-scout 分析这个产品"，AI 会自动识别并运行。

第一次运行 Skill 的完整流程 ​

以 market-scout 为例，走一遍：

先建立品牌文件夹：

bash
mkdir -p ~/brand-projects/mybrand
cd ~/brand-projects/mybrand

创建初始 context.json：

bash
echo '{"brand": {"name": "我的品牌", "product": "手工针织上衣"}}' > context.json

然后启动 Claude Code，在对话界面说：

"帮我用 market-scout skill 分析手工针织上衣这个品类，目标市场是欧美买家。"

Claude Code 会自动读取当前目录的 context.json，运行 market-scout，把分析结果写回 context.json 的 hound.market 段。整个过程大概1-3分钟。

第一次运行时，你不需要输出完美——看到终端里有输出，看到 context.json 被修改了，这就是成功。

常见卡点和解决方法 ​

API 余额不足或 Key 无效。 检查 API Key 是否正确，账号是否有余额。运行一次 Skill 大概消耗 1000-5000 tokens，费用很低（不到一块钱人民币）。

npm 报权限错误（macOS/Linux）。 加 sudo 用管理员权限：sudo npm install -g @anthropic-ai/claude-code。会要求输入电脑登录密码。

中国大陆网络无法连接。 Claude Code 需要连接 Anthropic 的 API 服务器，需要科学上网。建议用系统级代理（不是浏览器代理），确保终端里的网络流量也走代理。验证方法：curl https://api.anthropic.com/v1/models，如果返回 JSON 数据，说明网络通了。

Skill 安装后找不到。 重新打开一个终端窗口再试——有时候环境变量需要重新加载。

context.json 是什么 ​

这是整个 Brand OS 系统里最重要的文件。每个品牌项目建一个独立文件夹，context.json 放在文件夹根目录：

~/brand-projects/
├── mybrand/
│   └── context.json
├── hazumicrafts/
│   └── context.json
├── fulu/
│   └── context.json

每个品牌完全隔离，同时跑多个品牌不会互相干扰。

context.json 的基本结构：

json
{
  "brand": {
    "name": "HazumiCrafts",
    "product_category": "handknit women's apparel",
    "target_market": "US/UK, 28-45, slow fashion buyers"
  },
  "hound": {},
  "parrot": {},
  "rabbit": {},
  "bee": {},
  "elephant": {}
}

每个 Skill 运行后，会把结果写入对应的段——hound.market、parrot.brand、rabbit.listing 等。后续 Skill 读上游段的数据，不需要你重复提供。这就是为什么你在第10课跑了 brand-story，第11课的 product-copy 会自动带上品牌语气——数据都存在 context.json 里。

关于 context.json 的完整解读在第23课，现在只需要知道：它是整个系统的记忆中枢，每个 Skill 都在读它、写它。

安装全部 Skill ​

等你熟悉基本流程，可以一次安装所有 Skill：

bash
# Hound 模块（第6-9课）
npx skills add Tenx/BrandOS/hound/market-scout -g
npx skills add Tenx/BrandOS/hound/competitor-spy -g
npx skills add Tenx/BrandOS/hound/trend-timer -g

# Parrot 模块（第10-13课）
npx skills add Tenx/BrandOS/parrot/brand-story -g
npx skills add Tenx/BrandOS/parrot/product-copy -g
npx skills add Tenx/BrandOS/parrot/ai-hero-photo -g
npx skills add Tenx/BrandOS/parrot/social-post -g

# Rabbit 模块（第14-15课）
npx skills add Tenx/BrandOS/rabbit/etsy-listing-manager -g
npx skills add Tenx/BrandOS/rabbit/shopify-listing -g

# Bee 模块（第16-18课）
npx skills add Tenx/BrandOS/bee/audience-finder -g
npx skills add Tenx/BrandOS/bee/campaign-plan -g
npx skills add Tenx/BrandOS/bee/ad-launcher -g
npx skills add Tenx/BrandOS/bee/campaign-monitor -g

# Elephant 模块（第19-21课）
npx skills add Tenx/BrandOS/elephant/sales-review -g
npx skills add Tenx/BrandOS/elephant/review-manager -g

也可以边学边装，用到哪个装哪个。

本课作业 ​

  1. 完成 Claude Code 的安装和登录
  2. 安装 market-scout Skill
  3. 为你的品牌建立文件夹和初始 context.json
  4. 运行一次 Skill（任意一个），截图运行成功的界面

把截图发到学习群。如果卡在某一步，说明卡在哪、报错信息是什么——群里有人帮你排查。