설치 안내
Claude Code 공개 설치, Desktop/Web ZIP 업로드, 설치 경로와 옵션 확인
목표: 필요한 플러그인을 설치하고 AI가 읽는 경로까지 확인합니다. Codex·OpenCode·Orca 등은 시작하기의 설치 선택을 이용하세요.
준비물과 실행 위치#
-
macOS/Linux 터미널(Windows는 WSL),
bash,curl,tar,python3. - Claude Code 사용자는
claude --version으로 CLI 설치 여부를 확인합니다. - 인터넷 연결. 이 공개 다운로드 방식에는 GitHub 계정·저장소 권한이 필요 없습니다.
- 아래 명령은 아무 폴더에서 실행해도 됩니다. 사용자 홈에 설치됩니다.
Claude Code — 작은 플러그인 하나부터#
처음에는 도구를 고르는 나침반인 cc-compass부터 설치해 보세요.
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --plugin cc-compass정상 결과: 다운로드·설치 완료 메시지가 나오고 다음 파일이 생깁니다.
~/.claude/skills/cc-compass/.claude-plugin/plugin.json
~/.claude/skills/cc-compass/skills/cocode-compass/SKILL.md
Claude Code에서 /reload-plugins를 실행하거나 재시작한 뒤,
첫 실행 확인 요청으로 로드된 파일과 결과를 확인합니다.
설치 성공과 개별 스킬이 요구하는 MCP·SDK 준비 완료는 별개입니다.
파일을 먼저 읽고 설치하기#
터미널 · 다운로드를 저장할 폴더에서:
curl -fsSL https://skills.cocode.im/install.sh -o cocode-install.sh편집기로 cocode-install.sh를 열어 내용을 확인한 다음 실행합니다.
bash cocode-install.sh --plugin cc-compass이 파일은 다운로드한 시점의 스크립트입니다. 나중에 최신 버전을 설치할 때는 다시 내려받습니다.
필요한 범위 늘리기#
작게 시작하려면 --preset starter(3개), --preset flutter-core(5개),
--preset serverpod-core(4개)를 선택할 수 있습니다. 대표 명령·정확한 구성을 확인하세요.
설치 완료 시 출력되는 업데이트 명령은 선택한 프리셋/플러그인·설치 경로를 함께 보존합니다.
# 실제 플러그인 목록과 버전 보기
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --list
# 현재 프리셋에 포함되는 정확한 플러그인 보기
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --help
# 개별 선택
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --plugin cc-flutter cc-coui
# 역할별 묶음 선택
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --preset flutter| 프리셋 | 선택할 때 |
|---|---|
flutter | Flutter 앱 개발·디자인·테스트 |
fullstack | Flutter와 서버 개발·개발 사이클까지 |
pm | 제품 기획·요구사항 정리 |
uiux | UI/UX 관련 도구 |
web | Jaspr 웹 작업 |
infra | 인프라 작업 |
integration | 외부 도구 연동 |
all | 전체 플러그인 |
정확한 구성은 taxonomy.json에서 생성된 **현재 스크립트의 --help**를 기준으로 합니다.
옵션 없이 실행하면 전체 설치입니다. 전체 설치 때는 현재 배포 목록에 없는 cc-* 폴더도 정리됩니다.
개인 스킬은 배포 플러그인 폴더 안에서 수정하지 말고 원본 수정 실습을 따르세요.
Claude Desktop / Web#
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --desktop --plugin cc-compass- 출력에서 각 ZIP의 다운로드 성공 여부를 확인합니다.
~/Downloads/cocode-skills/cc-compass.zip을 찾습니다.- 사용하는 Claude 앱의 사용자 지정 → 스킬 → 추가에서 업로드합니다. 메뉴 이름은 앱 버전에 따라 다를 수 있습니다.
- 활성화된 목록과 새 대화에서 스킬 로드를 확인합니다.
다운로드만으로 업로드/활성화가 완료되지는 않습니다. Code 전용 셸·커맨드·MCP를 전제로 한 스킬은 Desktop/Web에서 실행 조건이 충족되지 않을 수 있습니다. 업로드 형식을 거부하면 해당 앱의 스킬 형식·정책을 확인하고 실제로 쓸 스킬 단위로 준비합니다.
--desktop ZIP 저장 위치는 ~/Downloads/cocode-skills/로 고정입니다.
도움말의 ~/.claude/plugins/local/ 표기는 기본 대상 변수이며, 실제 ZIP 다운로드 위치와 다릅니다.
--dir도 Desktop ZIP 저장 위치를 바꾸지 않습니다.
설치 경로를 바꿔서 확인하기#
Claude Code 다운로드 파일을 시험용 폴더에 받는 예:
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --plugin cc-compass --dir "$HOME/cocode-skills-preview" --keep-marketplace
이 경로는 Claude가 자동으로 읽는 경로가 아닙니다. 생성된 파일을 확인하거나,
claude --plugin-dir "$HOME/cocode-skills-preview/cc-compass"로 해당 세션에 로드합니다.
옵션 빠른 참조#
| 옵션 | 의미 |
|---|---|
--list, --help | 목록·도움말 조회 |
--plugin NAME [...] | 선택한 플러그인 설치 |
--preset NAME | 역할별 묶음 설치 |
--desktop | Desktop/Web 업로드용 ZIP 다운로드 |
--dir PATH | Code 설치 대상 변경 |
--update | 버전 비교 후 업데이트와 변경 내역 표시 |
--version | 지금 실행하는 설치 스크립트 버전. 설치본 검증은 아님 |
--keep-marketplace | 충돌 마켓플레이스 등록 자동 정리 방지 |
--uninstall | 선택한 설치 대상의 이 설치기가 처리하는 항목 제거 |
업데이트 전 백업, 같은 버전에서 재설치, 제거 범위는 업그레이드와 복구에서 이어갑니다.
이름이 같은 두 설치 스크립트#
| 파일 | 파일을 가져오는 곳 | 용도 |
|---|---|---|
루트 install.sh |
현재 체크아웃의 plugins/ (레포 밖이면 원격 clone) |
팀의 로컬 원본 전체를 Claude에 동기화 |
scripts/install.sh |
skills.cocode.im/downloads |
공개 다운로드용. 배포 시 /install.sh로 복사됨 |
bash install.sh를 실행했다고 웹의 최신 버전을 받는 것은 아닙니다.
루트 스크립트에는 공개 스크립트의 --plugin, --dir, --update 옵션 계약이 없습니다.
다음 단계: 첫 스킬 수정 → · 설치가 안 되면 문제 해결 →