>_

Claude Code 安裝指南

了解如何為 Claude Code 安裝和設定 Agent Skills。

前置需求

在安裝技能之前，請確保您已具備：

  • 已安裝 Claude Code CLI（npm install -g @anthropic-ai/claude-code）
  • 已初始化 Claude Code 的專案目錄
  • Node.js 18 或更高版本

安裝方法

方法 1：CLI 命令（推薦）

新增技能的最簡單方式：

bash
claude skill add owner/skill-repo

例如：

bash
claude skill add anthropic/brand-guidelines

方法 2：手動設定

直接將技能新增到專案的 .claude/settings.local.json：

json
{
  "skills": [
    "https://github.com/owner/skill-repo"
  ]
}

方法 3：本機技能

用於本機開發或私有技能：

json
{
  "skills": [
    "./local-skills/my-skill"
  ]
}

設定選項

技能優先順序

當安裝多個技能時，您可以設定優先順序：

json
{
  "skills": [
    {
      "url": "https://github.com/owner/skill-1",
      "priority": 1
    },
    {
      "url": "https://github.com/owner/skill-2",
      "priority": 2
    }
  ]
}

數字越小 = 優先順序越高。

條件式技能

僅針對特定檔案類型啟用技能：

json
{
  "skills": [
    {
      "url": "https://github.com/owner/react-skill",
      "match": ["**/*.tsx", "**/*.jsx"]
    }
  ]
}

驗證安裝

檢查您的技能是否已安裝：

bash
claude skill list

您應該會在輸出中看到您的技能：

Installed Skills: - anthropic/brand-guidelines (v1.0.0) - my-org/custom-skill (local)

更新技能

將所有技能更新到最新版本：

bash
claude skill update

更新特定技能：

bash
claude skill update owner/skill-repo

移除技能

從專案中移除技能：

bash
claude skill remove owner/skill-repo

疑難排解

技能無法載入

  1. 檢查技能 URL 是否正確
  2. 確認儲存庫包含有效的 SKILL.md 檔案
  3. 檢查您的網路連線
  4. 執行 claude skill validate owner/skill-repo 以檢查錯誤

技能之間的衝突

如果技能有衝突的指令：

  1. 調整優先順序以決定哪個優先
  2. 使用條件式匹配來限制技能範圍
  3. 考慮將相關技能合併為一個

權限問題

如果您遇到權限錯誤：

bash
# 修正 npm 權限
sudo chown -R $(whoami) ~/.claude

後續步驟

在 GitHub 上編輯此頁面