본문 바로가기
환경과 대화

실행 환경 연결

내 PC, SSH 서버와 WSL을 연결하고 파일과 에이전트가 실행될 위치를 선택합니다.

실행 환경은 프로젝트 파일, 터미널과 AI 에이전트가 실제로 동작하는 컴퓨터입니다. Liverary 화면을 내 PC에서 보고 있어도 원격 환경을 선택하면 작업은 원격 컴퓨터에서 실행됩니다. 이 문서는 공개 설치본 1.0.0의 데스크톱 앱을 기준으로 합니다.

먼저 작업 위치 확인하기

사용할 환경파일·터미널·제공자 인증의 위치
로컬현재 PC
SSH 또는 주소로 연결한 환경연결한 원격 컴퓨터
WSL선택한 Linux 배포판

내 PC에서만 작업한다면 별도의 원격 연결은 필요하지 않습니다. 프로젝트 추가에서 로컬 폴더를 선택하면 됩니다. Windows와 WSL, 여러 원격 서버를 함께 사용할 때는 프로젝트를 열기 전에 환경 이름과 경로를 확인하세요.

앱 가입 없이 이 연결들을 사용할 수 있지만, SSH·서버 접속 인증과 각 환경의 AI 제공자 인증은 필요합니다. 원격 환경에 연결한 뒤에는 AI 제공자 설정에서도 같은 환경을 선택해야 합니다.

SSH로 컴퓨터 연결하기

데스크톱 앱은 현재 PC의 SSH 설정, SSH 에이전트와 터널을 사용합니다. 먼저 대상 컴퓨터에 SSH로 접속할 수 있는 계정과 호스트 주소 또는 SSH 별칭을 준비하세요.

  1. 설정 → 실행 환경을 엽니다.
  2. 환경 추가를 누르고 SSH를 선택합니다.
  3. SSH 호스트 또는 별칭에서 기존 호스트를 선택하거나 주소·별칭을 입력합니다.
  4. 필요하면 사용자 이름과 포트를 지정합니다. 기존 SSH 설정을 사용하는 경우 그 설정에 맞춥니다.
  5. 환경 추가를 누르고, 비밀번호나 추가 인증 요청이 나타나면 응답합니다.
  6. 연결된 환경을 선택해 프로젝트 폴더를 엽니다.

예를 들어 로컬 SSH 설정에 devbox라는 별칭을 등록했다면 같은 별칭으로 연결할 수 있습니다. SSH 키를 사용하더라도 서버 정책에 따라 별도 인증 코드가 필요할 수 있습니다. 연결만으로 내 PC의 프로젝트 파일이나 AI 로그인이 원격 컴퓨터로 복사되지는 않습니다.

주소와 페어링 코드로 연결하기

이 방식은 대상 컴퓨터에서 Liverary가 실행 중이고, 현재 PC가 그 서버 주소에 접근할 수 있을 때 사용합니다. 연결할 컴퓨터와 접속받을 컴퓨터의 설정을 차례대로 진행하세요.

접속받을 컴퓨터에서

  1. 설정 → 공유 및 접근에서 공유할 실행 환경을 선택합니다.
  2. 다른 컴퓨터가 접근해야 한다면 네트워크 접근과 접속 주소를 확인합니다. 설정 변경으로 재시작 안내가 나오면 진행 중인 작업을 먼저 마칩니다.
  3. 접근이 허용된 클라이언트에서 링크 만들기를 누릅니다.
  4. 연결할 클라이언트의 권한을 정하고 링크를 만듭니다. 파일을 읽기만 할 목적이라면 읽기 전용을 선택할 수 있습니다.
  5. 링크 복사 또는 코드 복사로 연결 정보를 가져옵니다.

연결할 컴퓨터에서

  1. 설정 → 실행 환경 → 환경 추가를 엽니다.
  2. 원격 연결을 선택합니다.
  3. 호스트와 페어링 코드를 입력합니다. 전체 페어링 URL을 붙여 넣으면 두 필드를 자동으로 채울 수 있습니다.
  4. 환경 추가를 누르고 연결된 환경을 확인합니다.

연결 정보는 저장되며 앱을 다시 시작할 때 재연결합니다. 페어링 코드는 해당 서버에 접근할 권한을 주므로 연결할 기기에 전달하세요. 읽기 전용으로 연결한 경우 파일 수정·터미널 제어 등 허용되지 않은 작업은 사용할 수 없습니다.

Windows에서 WSL 사용하기

Windows 데스크톱 앱에서 사용할 WSL 배포판이 준비되어 있어야 합니다. WSL의 프로젝트와 제공자 인증은 Windows 쪽과 별도로 관리됩니다.

  1. 설정 → 공유 및 접근에서 이 컴퓨터를 선택합니다.
  2. WSL 백엔드에서 사용할 배포판을 고릅니다.
  3. 안내에 따라 Windows와 WSL 함께 실행 또는 WSL만 사용을 선택합니다.
  4. 연결이 준비되면 명령 팔레트의 WSL 폴더 열기로 프로젝트를 선택합니다.
  5. WSL 환경의 AI 제공자를 연결하고 새 대화를 시작합니다.

두 환경을 함께 실행해도 프로젝트 파일은 원래 파일 시스템에 남습니다. WSL만 사용을 선택하면 앱이 다시 시작되며, 이 설정을 끄기 전까지 Windows 쪽 프로젝트에 접근할 수 없습니다.

WSL을 끄면 해당 배포판의 프로젝트와 대화가 앱에서 일시적으로 보이지 않을 수 있지만 데이터는 배포판에 남습니다. 같은 배포판을 다시 켜면 사용할 수 있습니다. 배포판을 변경하면 현재 실행 중인 세션은 중단됩니다.

연결이 되지 않을 때

  • SSH 연결 실패: 호스트·사용자 이름·포트와 로컬 SSH 설정을 확인합니다. 추가 인증 요청이 남아 있는지도 살펴보세요.
  • 주소 연결 실패: 대상 Liverary가 실행 중인지, 다른 컴퓨터에서 접근할 주소인지, 페어링 코드와 권한이 유효한지 확인합니다.
  • 파일 수정이나 에이전트 설정 불가: 연결의 권한과 현재 선택한 환경을 확인합니다. 접속 성공과 모든 작업 권한은 별개입니다.
  • WSL 폴더를 열 수 없음: 원래 사용한 배포판의 WSL 백엔드를 시작한 뒤 다시 선택합니다.

관련 문서

문서 기준