xcode-cli은(는) 무엇을 하나요?
Claude Code 플러그인: Claude로 Xcode를 제어 — 빌드, 테스트, 실행, 정리, 시뮬레이터, 스킴, 프로젝트, 기기 관리. AppleScript + xcodebuild + xcrun을 통한 30개 이상의 명령어.
기능
- 빌드: Xcode 프로젝트 또는 워크스페이스를 지정된 스킴으로 빌드합니다.
- 테스트: 특정 스킴의 테스트를 실행합니다.
- 실행: 선택한 스킴을 시뮬레이터나 연결된 기기에서 실행합니다.
- 정리: 빌드 폴더와 파생 데이터를 정리합니다.
- 시뮬레이터 관리: 시뮬레이터 생성, 부팅, 종료, 삭제.
- 스킴 관리: 활성 스킴 조회 및 변경.
- 프로젝트 관리: Xcode 프로젝트 열기, 닫기 및 파일 조작.
- 기기 관리: 연결된 iOS/tvOS/watchOS 기기 목록 보기.
요구 사항
- macOS (Xcode 12 이상 권장)
- Claude Code CLI
- AppleScript 및
xcodebuild,xcrun에 대한 시스템 접근 권한
설치
claude code add marcelrgberger/xcode-cli
사용 예제
# 프로젝트 빌드
claude code "myproject.xcodeproj 빌드해줘"
# 테스트 실행
claude code "MyApp 스킴으로 테스트 실행해줘"
# 시뮬레이터 부팅
claude code "iPhone 15 Pro 시뮬레이터 부팅해줘"
# 파생 데이터 정리
claude code "빌드 폴더 정리해줘"
명령어 목록
| 명령어 | 설명 |
|---|---|
build | Xcode 프로젝트 빌드 |
test | 지정된 스킴의 테스트 실행 |
run | 시뮬레이터나 기기에서 실행 |
clean | 빌드 파생 데이터 정리 |
open | Xcode에서 프로젝트 열기 |
close | 프로젝트 닫기 |
list-devices | 연결된 기기 나열 |
boot-simulator | 시뮬레이터 부팅 |
shutdown-simulator | 시뮬레이터 종료 |
create-simulator | 새 시뮬레이터 생성 |
delete-simulator | 시뮬레이터 삭제 |
list-schemes | 프로젝트의 스킴 나열 |
set-scheme | 활성 스킴 설정 |
archive | 아카이브 생성 |
export-archive | 아카이브 내보내기 |
install | 시뮬레이터나 기기에 앱 설치 |
uninstall | 앱 제거 |
clear-derived-data | 파생 데이터 폴더 지우기 |
show-derived-data | 파생 데이터 경로 표시 |
version | Xcode 버전 표시 |
healthcheck | 설치 상태 확인 |
구성
환경 변수나 설정 파일을 통해 기본 프로젝트 경로나 선호 스킴을 설정할 수 있습니다.
export XCODE_PROJECT_PATH="/Users/me/MyApp/MyApp.xcodeproj"
export XCODE_SCHEME="MyApp"
문제 해결
- 권한 오류: Xcode와 Claude Code에
System Events및 Finder 접근 권한을 부여하세요. - 명령어 시간 초과: 대규모 프로젝트는 빌드 시간이 길어질 수 있습니다. Claude Code 설정에서 시간 제한을 늘리세요.
- 시뮬레이터 문제: 시뮬레이터가 응답하지 않으면
xcrun simctl shutdown all로 재설정하세요.
라이선스
MIT