본문으로 건너뛰기

다운로드 및 설치

이 페이지에서는 Elftia를 처음 다운로드하고, 설치하고, 실행하는 과정을 안내합니다.

시스템 요구 사항​

설치하기 전에 기기가 다음 최소 요구 사항을 충족하는지 확인하세요.

플랫폼최소 버전아키텍처
WindowsWindows 10 (64-bit) 이상x64 / arm64
macOSmacOS 10.15 (Catalina) 이상Intel / Apple Silicon
LinuxUbuntu 20.04 / Fedora 36 / Debian 11 또는 이에 준하는 버전x64

하드웨어 권장 사항:

  • RAM: 4 GB 이상(8 GB 권장)
  • 디스크 공간: 최소 500 MB의 사용 가능한 공간
  • 네트워크: LLM API 호출을 위한 인터넷 연결 필요

선택적 의존성(Agent 기능에 필요):

Elftia는 처음 실행할 때 다음 도구를 자동으로 감지합니다. Agent 기능(코드 편집, 파일 작업, Shell 명령 등)을 사용할 계획이라면 미리 설치하는 것이 좋습니다.

도구용도다운로드
Node.js 18+MCP 서버 런타임, 일부 도구 실행nodejs.org
Git버전 관리, 프로젝트 관리git-scm.com
uv / uvxPython 패키지 관리(일부 MCP 서버에 필요)astral.sh/uv

이 의존성은 선택 사항입니다. 기본 AI 채팅 기능만 필요하다면 건너뛰어도 됩니다.

다운로드​

공식 웹사이트​

Elftia 공식 웹사이트의 다운로드 페이지를 방문해 운영 체제에 맞는 버전을 선택하세요.

GitHub Releases​

GitHub Releases 페이지에서도 최신 버전이나 이전 버전을 다운로드할 수 있습니다. 각 릴리스에는 다음 설치 파일이 포함되어 있습니다.

플랫폼설치 파일 형식파일 이름 예시
WindowsNSIS 설치 프로그램Elftia-Setup-x.x.x.exe
macOSDMG 이미지Elftia-x.x.x.dmg / Elftia-x.x.x-arm64.dmg
LinuxAppImageElftia-x.x.x.AppImage

설치 단계​

Windows​

  1. 다운로드한 Elftia-Setup-x.x.x.exe 파일을 두 번 클릭합니다.
  2. Windows SmartScreen 프롬프트가 표시되면 "More info"를 클릭한 다음 "Run anyway"를 선택합니다.
  3. 설치 경로를 선택합니다(기본값은 C:\Users\<username>\AppData\Local\Elftia).
  4. 설치가 완료될 때까지 기다립니다. 설치 프로그램이 바탕 화면 바로 가기와 Start Menu 항목을 자동으로 생성합니다.
  5. "Finish"를 클릭해 Elftia를 실행합니다.
팁

Elftia는 자동 업데이트를 지원하는 NSIS 설치 프로그램을 사용합니다. 설치된 애플리케이션은 시스템 설정에서 일반적인 방식으로 제거할 수 있습니다.

macOS​

  1. 다운로드한 .dmg 파일을 두 번 클릭해 디스크 이미지를 마운트합니다.
  2. 열린 창에서 Elftia 아이콘을 "Applications" 폴더로 드래그합니다.
  3. 처음 실행할 때 macOS에서 "Cannot verify developer" 프롬프트가 표시될 수 있습니다.
    • "System Preferences → Security & Privacy → General"을 엽니다.
    • "Open anyway" 버튼을 클릭합니다.
  4. Elftia가 실행되고 사용할 준비가 완료됩니다.
팁

Apple Silicon(M1/M2/M3/M4) 사용자는 최적의 성능을 위해 arm64 버전을 다운로드해야 합니다. Intel Mac 사용자는 표준 버전을 다운로드해야 합니다.

Linux​

  1. .AppImage 파일을 다운로드합니다.
  2. 실행 권한을 부여합니다.
    chmod +x Elftia-x.x.x.AppImage
  3. 두 번 클릭해 실행하거나 터미널에서 실행합니다.
    ./Elftia-x.x.x.AppImage
팁

AppImage가 실행되지 않으면 FUSE를 설치해야 할 수 있습니다. sudo apt install libfuse2(Ubuntu/Debian).

첫 실행​

Elftia를 처음 실행하면 다음 흐름이 표시됩니다.

1. 환경 감지​

Elftia는 시스템에 설치된 도구(Node.js, Git, ripgrep, uv/uvx 등)를 자동으로 감지합니다. 감지 결과는 Settings 페이지의 "Environment" 섹션에 표시되며, 각 도구 옆에는 초록색(설치됨) 또는 빨간색(설치되지 않음) 상태 표시기가 표시됩니다.

나중에 Settings → General → Environment에서 이 도구들을 확인하고 관리할 수 있습니다. 누락된 일부 도구는 "Install" 버튼을 클릭해 직접 설치할 수 있습니다.

2. 언어 선택​

Elftia는 세 가지 인터페이스 언어를 지원합니다.

  • 중국어 간체
  • 영어
  • 일본어

기본 언어는 시스템 언어에 따라 자동으로 선택됩니다. Settings → General → Language에서 언제든지 변경할 수 있습니다.

3. LLM 제공업체 구성​

AI 채팅을 시작하려면 최소 하나의 LLM 제공업체를 구성해야 합니다. 자세한 내용은 첫 채팅을 참조하세요.

Steam 버전 차이점​

Steam을 통해 Elftia를 설치하는 경우 다음 차이점에 유의하세요.

항목표준 에디션Steam 에디션
업데이트 방식앱 내 자동 업데이트(electron-updater)Steam 클라이언트를 통한 업데이트
설치 경로사용자 정의Steam 라이브러리 폴더
제거 방법시스템 설정 / 제어판Steam을 통해 제거
기능동일동일

Steam 버전은 표준 에디션과 기능이 동일하며, 업데이트 메커니즘만 다릅니다.

일반적인 설치 문제​

설치 프로그램이 실행되지 않음​

Windows: 백신 소프트웨어에 의해 차단되었는지 확인하세요. 일부 백신 프로그램은 Electron 애플리케이션을 잘못 감지할 수 있습니다. 백신 허용 목록에 Elftia를 추가하세요.

macOS: "damaged, can't be opened" 메시지가 표시되면 터미널에서 다음을 실행하세요.

xattr -cr /Applications/Elftia.app

Linux: FUSE 의존성이 설치되어 있고 파일에 실행 권한이 있는지 확인하세요.

시작 시 빈 화면 또는 충돌​

  • 그래픽 드라이버가 최신 버전으로 업데이트되어 있는지 확인하세요.
  • 관리자 권한으로 실행해 보세요(Windows).
  • 다른 Elftia 인스턴스가 이미 실행 중인지 확인하고 닫으세요.
  • 오래된 GPU를 사용하는 경우 시작 시 --disable-gpu 매개변수를 추가해 보세요.

.NET 또는 Visual C++ 런타임 누락(Windows)​

일부 Windows 시스템에는 필요한 런타임 라이브러리가 없을 수 있습니다. Visual C++ Redistributable을 설치한 뒤 다시 시도하세요.

방화벽이 인터넷 연결을 차단함​

Elftia는 LLM API를 호출하기 위해 인터넷 접근이 필요합니다. 방화벽이 Elftia의 아웃바운드 연결을 허용하는지 확인하세요. 프록시 설정은 프록시 사용을 참조하세요.


설치가 완료되면 첫 채팅을 계속 읽고 AI 여정을 시작하세요.