skill-installer-cn은(는) 무엇을 하나요?
제한된 네트워크 환경에서 Claude Code 스킬 설치 — GitHub 타임아웃 문제 해결, npm/git 미러, 30개 이상의 개발 도구 체인 미러 설정
개요
이 스킬은 방화벽이나 제한된 네트워크(예: 중국 본토)에서 Claude Code를 사용할 때 발생하는 스킬 설치 문제를 해결합니다. GitHub 타임아웃, npm 패키지 다운로드 실패, git clone 중단 등의 문제를 자동으로 감지하고 적절한 미러 설정을 적용합니다.
주요 기능
- GitHub 접속 문제 해결:
git clone타임아웃 시 자동으로 GitHub 미러(예:https://github.com.cnpmjs.org)로 전환 - npm 미러 구성:
npm config set registry https://registry.npmmirror.com자동 설정 - pip 미러 구성:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple적용 - git 미러 구성: git clone 시 자동으로
https://github.com.cnpmjs.org프리픽스 적용 - 30개 이상 도구 체인 지원: npm, pip, git, gem, apt, maven, gradle, docker, conda, yarn, brew 등
지원 플랫폼
- Claude Code (모든 버전)
- Codex CLI
- Cursor
- Aider
- GitHub Copilot CLI
사용 방법
- 스킬 설치:
claude install skill bailishta/skill-installer-cn - 자동 감지: Claude Code가 네트워크 상태를 감지하고 필요한 미러 설정을 제안합니다.
- 수동 설정:
!skill-mirror-setup명령어로 모든 미러 설정을 한 번에 적용할 수 있습니다.
명령어
| 명령어 | 설명 |
|---|---|
!skill-mirror-setup | 모든 도구 체인에 대해 미러 설정 자동 구성 |
!skill-mirror-check | 현재 네트워크 상태 및 미러 연결 테스트 |
!skill-mirror-reset | 모든 미러 설정을 기본값(공식 소스)으로 초기화 |
!skill-mirror-list | 지원되는 모든 도구 체인과 현재 미러 상태 표시 |
설정 파일
이 스킬은 다음 위치에 설정 파일을 생성합니다:
~/.claude/skills/mirror-config.json— 모든 미러 설정 저장~/.bashrc또는~/.zshrc— 환경 변수 내보내기 추가
트러블슈팅
Q: GitHub 연결 타임아웃이 계속 발생합니다.
A: !skill-mirror-setup 명령어를 실행하여 GitHub 미러를 활성화하세요. 또는 수동으로 다음 환경 변수를 설정하세요:
export GIT_SSL_NO_VERIFY=true
export GH_MIRROR_PREFIX=https://github.com.cnpmjs.org
Q: npm install이 실패합니다.
A: npm 레지스트리를 중국 미러로 변경하세요:
npm config set registry https://registry.npmmirror.com
Q: pip 패키지를 설치할 수 없습니다.
A: pip 소스를 TUNA 미러로 변경하세요:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
지원 도구 체인 전체 목록
- npm, yarn, pnpm
- pip, conda, poetry, pipenv
- gem, bundler
- apt, yum, dnf, pacman, zypper
- git, gh CLI
- maven, gradle
- docker, docker-compose
- cargo, rustup
- go, go modules
- brew (macOS)
- nuget, dotnet
- flutter, dart pub
라이선스
MIT