설치와 로그인
CLI를 설치하고 브라우저에서 로그인한 뒤, 첫 Skill 목록을 확인해 보세요. 아래 명령은 터미널에서 한 줄씩 실행합니다.
시작하기 전에
- 로그인할 계정과 소속 조직이 필요합니다. 아직 조직에 참여하지 않았다면 조직 관리자에게 초대를 요청하세요.
- 평소 사용하는 서비스 주소를 확인하세요. 브라우저에서 로그인할 때 사용하는 주소입니다.
- PC에서 터미널을 여세요. macOS는 터미널 앱, Windows는 PowerShell, Linux는 터미널을 사용할 수 있습니다.
1. Node.js 준비하기
Node.js는 CLI를 실행하는 데 필요한 프로그램입니다. 24.18.0 이상을 사용해야 합니다. 먼저 설치되어 있는지 확인하세요.
node --version표시된 버전이 v24.18.0 이상이면 다음 단계로 진행하세요. 명령을 찾을 수 없거나 버전이 낮으면 Node.js 공식 다운로드 에서 조건에 맞는 버전을 설치하세요. 설치 후 터미널을 닫았다가 다시 열고 버전을 확인합니다.
2. CLI 설치하기
현재 CLI 버전은 2026.6.14입니다.
Node.js와 함께 설치되는 npm으로 CLI를 설치합니다.
npm install -g aipctl@latest설치가 끝나면 다음 명령을 실행하세요.
aipctl --version버전 번호가 표시되면 설치가 완료된 것입니다. 이후에는 aipctl로 명령을 실행할 수 있습니다.
npm이나 aipctl 명령을 찾을 수 없다고 나오면 터미널을 다시 열고 실행해 보세요. 계속 문제가 발생하거나 설치 권한 오류가 나타나면 문제 해결을 확인하세요.
3. 접속 주소 설정하고 로그인하기
접속 주소가 https://app.querypie.com이면 아래 명령을 그대로 실행하세요. 조직에서 별도 주소를 사용한다면 해당 주소로 바꿔 입력합니다.
aipctl config set --app-url https://app.querypie.com이제 로그인 명령을 실행합니다.
aipctl auth login- 자동으로 열린 브라우저에서 평소 사용하는 계정으로 로그인합니다.
- 접근할 수 있는 조직이 여러 개면 사용할 조직을 선택합니다. 하나라면 자동으로 선택합니다.
- 터미널에 로그인 완료 안내가 나타나는지 확인합니다.
브라우저가 열리지 않으면 터미널에 표시된 로그인 주소를 복사해 같은 PC의 브라우저에서 여세요. 5분 안에 완료하지 못했다면 aipctl auth login을 다시 실행합니다.
4. 첫 명령 실행하기
로그인할 때 선택한 조직의 Skill 목록을 확인해 보세요. 아래 명령은 목록을 조회합니다.
aipctl skill listSkill 목록이 표시되면 첫 조회가 완료된 것입니다. 등록된 Skill이 없다면 빈 목록이 표시될 수 있습니다. 오류 없이 조회가 끝났다면 정상적으로 연결된 상태입니다.
이제 Skill 관리에서 다운로드와 등록 방법을 알아보거나, Agent 관리로 이동해 보세요. 사용할 수 있는 모든 명령은 전체 명령 참조에서 확인할 수 있습니다.
다른 조직으로 전환하기
여러 조직에 속해 있다면 브라우저에서 사용할 조직을 다시 선택할 수 있습니다.
aipctl org select터미널에서 선택하려면 먼저 조직 목록을 확인합니다.
aipctl org list목록의 slug 값을 복사해 ORG_SLUG 대신 입력하세요. slug는 조직 이름이나 ID와 다를 수 있습니다.
aipctl org use ORG_SLUG다른 조직에 한 번만 명령을 실행하려면 --org를 붙입니다. 저장된 기본 조직은 바뀌지 않습니다.
aipctl skill list --org OTHER_ORG_SLUG로그인 갱신과 로그아웃
로그인 정보는 필요할 때 자동으로 갱신됩니다. 직접 갱신해야 할 때는 다음 명령을 사용하세요.
aipctl auth refresh이 PC에서 로그아웃하려면 다음 명령을 실행합니다.
aipctl auth logout로그아웃하면 이 PC에 저장된 로그인 정보가 지워집니다. 다른 계정으로 사용하려면 로그아웃한 뒤 aipctl auth login을 실행하세요. 이미 서버에 전달한 작업은 로그아웃해도 취소되지 않습니다.
접속 정보 확인하기
설정한 서비스 주소를 확인하려면 다음 명령을 실행합니다.
aipctl config status로그인 상태, 계정, 선택한 조직은 다음 명령으로 각각 확인할 수 있습니다.
aipctl auth status
aipctl auth whoami
aipctl org currentauth status와 org current는 PC에 저장된 상태를 보여줍니다. 현재 서버에서 확인한 계정 정보는 auth whoami로 확인하세요.
aipctl config set --app-url로 접속 주소를 변경하면 저장된 로그인 정보와 선택 조직이 지워집니다. 주소를 변경한 뒤에는 다시 로그인하세요. 같은 PC에서 다른 버전의 CLI를 실행해도 로컬 설정은 공유됩니다.
업데이트하기
npm install -g aipctl@latest
aipctl --version특정 버전이 필요한 스크립트에서는 VERSION을 실제 버전으로 바꿔 고정할 수 있습니다.
npx --yes --package=aipctl@VERSION -- aipctl --version일반 사용에는 latest를 사용하세요. 개발·검증용 배포 채널은 서버에서 제공하지 않는 기능을 사용할 수 있게 해 주지 않습니다.