# 설치와 로그인 npm에서 Lockpick CLI를 설치하고, 터미널에서 브라우저로 로그인하세요. Lockpick CLI를 사용하면 터미널에서 나와 코딩 도우미가 Lockpick을 쓸 수 있습니다. Node.js 20.9 이상이 필요합니다. ## 설치 ```bash title="터미널" npm install -g lockpicks ``` 패키지 이름은 `lockpicks`이며 s가 붙습니다. 설치되는 명령어는 `lockpick`입니다. 설치하지 않고 `npx lockpicks`로 실행할 수도 있습니다. ## 로그인 ``` lockpick login --host https://www.lockpick.app ``` 스니펫은 `--host`로 이 Lockpick 서버를 지정합니다. 기본으로 내장된 호스트는 없습니다. CLI는 `--host`, `LOCKPICK_HOST`, 저장된 프로필 순서로 확인합니다. 처음 로그인한 뒤에는 `lockpick login`이 그 프로필을 재사용할 수 있습니다. 브라우저가 열리고 로그인을 승인하도록 요청합니다. 키는 터미널로 바로 전달되므로 직접 복사할 필요가 없습니다. 기본적으로 키는 사이트와 보고서를 읽을 수 있습니다. 더 많은 권한이 필요하면 로그인할 때 요청하세요. * `--pulse`를 붙이면 Pulse 스캔, 빠른 검사, 무료 **이 레코드 다시 읽기**를 시작할 수 있습니다. * `--sites`를 붙이면 사이트를 추가하고, 무료 사이트를 바꾸고, 패키지 버전을 [Monitor](/ko/docs/protect/monitor)로 보낼 수 있습니다. * `--deep`을 붙이면 Deep 스캔을 준비할 수 있습니다. 실제 실행은 Lockpick에서 여전히 승인해야 합니다. * `--no-browser`를 붙이면 브라우저를 열지 않고 로그인 주소만 출력합니다. `lockpick whoami`로 현재 로그인한 계정을 확인하고, `lockpick logout`으로 로그아웃하세요. 로그아웃하면 키도 폐기됩니다. ## 첫 명령어 ```bash title="터미널" lockpick whoami lockpick sites lockpick status ``` 이 명령어들은 스캔을 시작하지 않고 계정과 기존 결과만 읽습니다. 연결이 되지 않으면 `lockpick doctor`를 실행하세요. 검사를 시작하려면 `--pulse` 권한으로 로그인하고, 소유하고 있거나 테스트해도 되는 사이트를 사용하세요. `atlas.example`은 예시 주소이며 실제 테스트 대상이 아닙니다. 스캔을 시작하면 Lockpick이 보여 주는 허용량을 사용하고, 스캔 상태나 보고서를 읽는 것은 스캔을 추가로 사용하지 않습니다. 모든 명령어는 스크립트용 `--json`과 옵션 안내용 `--help`를 지원합니다. [명령어](/ko/docs/cli/commands)에서 전체 목록을 볼 수 있습니다. ## 종료 코드 | 코드 | 의미 | | -- | -------------------------------------------------------------------- | | 0 | 성공했습니다 | | 1 | 문제가 생겼거나, 요청한 항목을 찾지 못했습니다 | | 2 | 로그인이 필요합니다 | | 3 | 기다리던 스캔이 성공하지 못했거나 아직 실행 중입니다 | | 4 | 키 또는 역할이 허용하지 않거나, 허용량을 모두 사용했습니다 | | 5 | 명령어 또는 값 중 하나가 올바르지 않습니다 | | 6 | 요청이 너무 많습니다. 기다렸다가 다시 시도하세요 | | 7 | Lockpick 또는 Lockpick이 쓰는 제공자가 바쁘거나 사용할 수 없습니다 | | 8 | 열린 문제가 `--fail-on` 기준에 도달했습니다([CI에서 Lockpick 실행하기](/ko/docs/cli/ci)) | 오류 메시지 끝에는 그 내용을 설명하는 페이지 링크가 있습니다. `lockpick doctor`로 설정을 확인하고, `lockpick docs `로 터미널에서 이 문서를 검색할 수 있습니다.