본문 바로가기
시작하기

AI 제공자와 모델

Codex·Claude 인증을 연결하고, 추가 계정과 작업에 사용할 모델을 설정합니다.

Liverary에서 답변을 생성하고 도구를 실행하려면 AI 제공자를 연결해야 합니다. 별도의 Liverary 가입은 필요하지 않으며, 이미 사용하는 Codex·Claude의 인증을 연결할 수 있습니다. 이 문서는 공개 설치본 1.0.0을 기준으로 합니다.

기존 계정 연결하기

먼저 어느 컴퓨터에서 에이전트를 실행할지 정하세요. 로컬 프로젝트는 내 PC의 인증을 사용하고, 원격 프로젝트는 선택한 서버의 인증을 사용합니다. 원격 환경에서 로그인할 때는 내 PC에 로그인된 계정이 자동으로 적용되지 않습니다.

  1. 설정 → AI 제공자를 열고 작업할 실행 환경을 확인합니다.
  2. 사용할 Codex 또는 Claude 제공자의 설치 상태를 확인합니다. 기본 설정은 해당 컴퓨터의 데스크톱 앱에 포함된 CLI를 먼저 찾고, 없으면 터미널의 PATH에서 찾습니다.
  3. 다른 실행 파일을 사용하려면 실행 파일 경로에서 발견된 CLI를 선택하거나 전체 경로를 입력합니다.
  4. 계정에서 로그인 상태를 확인합니다. 연결되지 않았다면 로그인을 누르고 화면에 표시된 브라우저 또는 터미널 안내를 따릅니다.
  5. 로그인한 계정과 사용할 모델을 확인한 뒤 프로젝트의 새 대화를 엽니다.

CLI가 설치되지 않았다면 첫 실행 화면의 설치 기능을 사용하세요. 수동 설치가 필요할 때는 제공자 설정의 별도 CLI 설치 → 설치 명령 보기에서 해당 환경에 맞는 명령을 확인할 수 있습니다.

브라우저 인증 화면이 열리지 않으면 로그인 링크 복사로 주소를 복사해 브라우저에서 여세요. 인증을 마친 뒤 Liverary에서 계정 상태를 확인합니다. 제공자에 따라 인증 코드 입력이나 하단 터미널에서의 조작이 필요할 수 있습니다.

두 번째 계정 추가하기

개인 계정과 업무 계정을 함께 사용하려면 제공자를 하나 더 추가하세요. 기존 연결의 계정만 교체하는 작업은 계정 변경으로 할 수 있지만, 두 계정을 구분해 계속 사용하려면 별도 추가가 적합합니다.

  1. 설정 → AI 제공자에서 AI 제공자 추가를 선택합니다.
  2. 사용할 실행 환경과 제공자를 고릅니다.
  3. 새 계정을 독립적으로 연결하려면 홈 경로를 비워 둡니다. 이미 다른 폴더에 로그인한 계정이라면 그 폴더를 지정합니다.
  4. 추가한 제공자의 인증 안내를 따라 로그인합니다.
  5. 새 대화에서 원하는 계정의 모델을 선택합니다.

기본 Codex·Claude 계정은 각각 ~/.codex, ~/.claude를 사용합니다. 추가 계정의 홈을 비워 두면 Liverary가 ~/.liverary/userdata/providers/ 아래에 계정별 경로를 배정합니다. 예를 들어 기존 Codex 대화를 그대로 이어 쓰려면 새 빈 홈 대신 그 대화를 만들 때 사용한 계정을 연결해야 합니다.

홈 경로를 바꾸면 조회하는 인증과 세션 저장 위치도 달라집니다. 대화가 보이지 않을 때 새 계정을 계속 추가하기 전에 원래 계정의 홈을 확인하세요. 원격 환경에서 이 경로는 원격 컴퓨터에 있습니다.

사용할 모델 정하기

대화 입력창의 모델 선택에서 이번 작업에 사용할 모델을 고릅니다. 모델명뿐 아니라 연결된 제공자와 계정도 함께 확인하세요. 같은 모델 이름이 표시되더라도 선택한 계정에 따라 인증과 사용량이 달라집니다.

제공자 설정의 모델에서는 목록을 정리할 수 있습니다.

  • 모델 검색으로 원하는 모델을 찾습니다.
  • 자주 쓰는 모델은 즐겨찾기에 추가하고, 사용하지 않는 모델은 선택기에서 숨깁니다.
  • 목록에 없는 모델을 직접 지정해야 할 때는 사용자 지정 모델 추가를 사용합니다. 제공자가 실제로 지원하는 모델 식별자를 입력해야 합니다.

새 대화의 기본값은 설정 → 대화 관리 → 기본 모델에서 지정합니다. 프로젝트별 기본 모델이 설정되어 있으면 그 선택이 우선합니다.

제공자마다 모델, 추론 수준, 속도와 도구 지원이 다릅니다. 다른 제공자에서 보았던 옵션이 현재 계정에 없다고 해서 반드시 연결 오류는 아닙니다. 작업 권한과 계획 모드 설정은 대화와 작업 진행에서 확인하세요.

연결이나 모델 선택이 되지 않을 때

증상먼저 확인할 내용
설치된 CLI를 찾지 못함선택한 실행 환경과 실행 파일 경로가 맞는지 확인합니다.
인증 후에도 로그인되지 않음인증을 진행한 계정·컴퓨터·홈 경로가 해당 제공자 설정과 같은지 확인합니다.
브라우저가 열리지 않음로그인 링크 복사 후 직접 열어 인증을 마칩니다.
새 모델이 목록에 없음AI 제공자 버전 확인과 모델 숨김 설정을 확인합니다. 버전 확인을 끄면 모델 목록 갱신이 늦어질 수 있습니다.
기존 대화가 없음같은 계정의 세션 저장소인지, 해당 제공자가 자동 공유를 지원하는지 확인합니다.

AI 제공자 로그인과 GitHub 로그인은 별개입니다. 에이전트가 답변할 수 있어도 비공개 저장소 복제나 PR 작업에는 소스 제어 인증이 추가로 필요할 수 있습니다.

다음으로 할 일

문서 기준