문서

설치

데스크톱 앱 (권장)

fate 데스크톱 버전은 macOS 13 이상을 지원합니다. 설치 후 본인의 ChatGPT·Claude 구독 또는 API 키로 모델 서비스에 연결하세요.

버전 0.1.0 · macOS 13 이상

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple이 표시되면 Apple 실리콘 버전을, ‘프로세서’에 Intel이 표시되면 Intel 버전을 선택하세요.

ZIP 형식도 사용할 수 있습니다. 압축을 풀고 fate.app을 ‘응용 프로그램’으로 옮기세요.

Windows 버전 준비 중

  1. 칩에 맞는 DMG를 다운로드해 열고 fate.app을 ‘응용 프로그램’으로 드래그하세요.
  2. fate에서 로그인 또는 가입을 선택합니다. 브라우저에서 Google이나 이메일 인증 코드로 로그인하고 승인한 뒤 앱으로 돌아옵니다. 대기를 취소하고 다시 시작할 수 있습니다.

처음 열 때

첫 출시 버전은 Apple의 공증을 받지 않아 macOS가 처음 실행을 차단할 수 있습니다. fate 공식 사이트에서 다운로드했는지 확인한 뒤 ‘시스템 설정 > 개인정보 보호 및 보안’에서 ‘그래도 열기’를 선택하세요.

공식 사이트에서 다운로드해 ‘응용 프로그램’에 넣은 fate에 다음 명령을 실행한 뒤 다시 열 수도 있습니다.

$ xattr -dr com.apple.quarantine /Applications/fate.app

로그인하고 모델 연결

fate를 먼저 설치한 뒤 fate 계정에 로그인합니다. 모델 멤버십과 fate 플랜은 계정과 요금이 별개입니다.

  1. fate에서 로그인 또는 가입을 선택합니다. 브라우저에서 Google이나 이메일 인증 코드로 로그인하고 승인한 뒤 앱으로 돌아옵니다. 대기를 취소하고 다시 시작할 수 있습니다.
  2. 안내 카드 또는 설정 > 계정 및 모델에서 자신의 ChatGPT·Claude 멤버십이나 지원 서비스의 API Key를 선택합니다.
  3. 멤버십은 아래 공식 안내에 따라 해당 CLI를 설치한 뒤 fate에서 로그인합니다. API Key는 CLI가 필요 없고 모델 서비스 사용량으로 청구됩니다.

멤버십 연결용 공식 설치 안내

설치하는 것은 모델 서비스의 공식 도구입니다. 설치 후 fate로 돌아와 로그인하며 터미널에서 fate를 실행할 필요는 없습니다.

CLI를 찾지 못하거나 버전 확인 실패

  1. 설정 > 진단의 공식 명령줄에서 경로와 버전을 확인합니다. 공식 도구 설치·업데이트 후 다시 감지를 누릅니다.
  2. 계속 없으면 설치된 codex 또는 claude 실행 파일을 선택합니다. 파일 선택 취소는 설정을 바꾸지 않고 지정 경로를 지우면 자동 탐색으로 돌아갑니다.
  3. 지정한 경로가 무효이면 수정하거나 지웁니다. 새 연결을 추가해도 기존 모델 선택은 유지되며 필요할 때 입력창에서 직접 전환합니다.

모델 연결 실패

  1. 모델 로그인·사용 한도·네트워크를 확인합니다. 설정 > 진단 > 모델 네트워크에서 시스템, 직접 연결, 사용자 HTTP/HTTPS 프록시 또는 터미널 가져오기를 선택합니다.
  2. 프록시 주소·사용자 이름·암호를 각각 입력합니다. 사용할 수 없다는 안내가 나오면 유효한 HTTP/HTTPS 프록시나 직접 연결로 바꿔 재시도합니다.
  3. 진행 중인 리딩이나 로그인을 완료 또는 취소한 뒤 모델 설정을 변경합니다. 실패하면 이전의 유효 설정을 유지하며 모델이나 청구 출처를 자동 변경하지 않습니다.

fate 업데이트

fate는 백그라운드에서 업데이트를 확인·다운로드하고 종료 시 설치합니다. 이 페이지에서 Mac 칩에 맞는 설치 파일을 받을 수도 있습니다. 모델 CLI는 해당 공식 안내에 따라 업데이트합니다.

빠른 시작