확장 살펴보기
이 페이지는 영어 원문을 기계 번역했습니다. 수정 제안을 환영합니다. GitHub에서 이 페이지 수정
이 페이지 목차
ccam ext는 "이 스킬(또는 MCP 서버)이 왜 한 계정에서는 되고 다른 계정에서는 안 될까?"라는 질문에 답합니다. 계정마다 Claude Code가 불러오는 확장과 각각의 출처(공유 그룹, 계정 자체 폴더, 지금 있는 프로젝트)를 나열합니다. 표 아래에는 확장이 예상대로 로드되지 못하게 막는 문제를 나열합니다. 읽기만 합니다.
사용법
ccam ext # every account
ccam ext work # one account
ccam ext --json # for scripts$ ccam ext
Skills
personal work
half account ! -
review - default
Commands
personal work
deploy - default
MCP servers
personal work
ctx account default
Hooks (commands per event)
personal work
PreToolUse 1 (default) 1 (default)
This project (/home/me/code/app), for every account:
commands: ship
MCP servers: fs
Sources: a group name (shared), account (its own folder), - (not loaded).
! personal: half: no SKILL.md, so Claude Code does not load it
! personal: MCP server ctx is defined differently in group default's mcp.json and .claude.json각 칸은 그 계정에서 그 항목의 출처를 나타냅니다. 공유 그룹(default), 계정 자체 폴더에 있으면 account, 계정에 없으면 -입니다. !는 문제가 있는 항목을 표시하며, 문제는 표 아래에 설명합니다.
읽는 곳
| 종류 | 위치 | 표시되는 출처 |
|---|---|---|
| 스킬 | skills/ 안에서 SKILL.md가 있는 각 폴더 |
skills/가 링크하는 그룹, 또는 account |
| 명령, 에이전트 | commands/와 agents/ 아래의 .md 파일, 하위 폴더는 folder/name 형태 |
그룹, 또는 account |
| 플러그인 | plugins/installed_plugins.json |
그룹, 또는 account |
| MCP 서버 | 그룹의 mcp.json(MCP를 공유할 때)과 계정의 .claude.json |
그룹, 또는 account |
| 훅 | settings.json의 hooks, 이벤트별 개수 |
그룹, 또는 account |
| 이 프로젝트 | 현재 폴더의 .claude/skills, .claude/commands, .claude/agents, .claude/settings.json, .claude/settings.local.json, .mcp.json |
모든 계정에 대해 한 번만 표시 |
알려 주는 문제
- 깨진 링크:
skills/,commands/,agents/안에서 대상이 사라진 링크, 또는 없는 위치를 가리키는 공유 폴더(skills,commands,agents,plugins)입니다(ccam doctor --fix로 복구). SKILL.md가 없는 스킬 폴더: Claude Code가 건너뜁니다.- 두 곳에서 다르게 정의된 MCP 서버: 그룹의
mcp.json과 계정의.claude.json, 또는 그중 하나와 프로젝트의.mcp.json입니다. 두 곳의 설정이 같으면(mcp_strategy = "sync"가 이렇게 씁니다) 문제가 아닙니다. 계정 자체 서버를 그룹으로 옮기려면ccam mcp import <account> <server>를 쓰세요. - 올바른 JSON이 아닌
installed_plugins.json.
안전장치와 예외 상황
ccam ext는 아무것도 바꾸지 않고 네트워크 요청도 하지 않습니다. 서버 이름과 훅 개수만 읽으며, MCP 정의에 있는env나 헤더의 값은 절대 읽지 않습니다.- 디스크에 있는 그대로를 보여 줍니다. 설치했지만 설정에서 꺼 둔 플러그인이나 관리형 설정이 막은 서버도 표시됩니다.
- 프로젝트 폴더에서 실행하면 그 프로젝트의
.claude폴더와.mcp.json도 포함됩니다.