Foxl 설치하기

먼저 다운로드 페이지에서 Foxl을 받으세요. 이 페이지에서는 설치 과정을 하나씩 안내해요.

필요한 환경앵커 링크 복사

• macOS: macOS 13(Ventura) 이상, Apple Silicon(M1 이상) 또는 Intel Mac.
• Windows: Windows 10 이상, 64비트.
• Linux: FUSE가 있는 64비트(x86-64) 시스템. AppImage를 실행하려면 FUSE가 필요해요.

따로 설치할 건 없어요. Foxl이 자체 서버 런타임을 함께 가져와요(macOS와 Linux는 Bun, Windows는 Node.js).

휴대폰에서 쓰려고 하나요? iOS는 App Store에 있고, Android는 APK로 직접 설치해요. 모바일 앱을 보세요.

macOS앵커 링크 복사

1. 받은 .dmg 파일을 여세요.
2. Foxl을 응용 프로그램 폴더로 끌어다 놓으세요.
3. 응용 프로그램에서 Foxl을 여세요.
4. 처음 열 때 macOS가 정말 열지 물어볼 수 있어요. 열기를 클릭하세요.

Mac 다운로드는 유니버설 빌드라서 Apple Silicon Mac과 Intel Mac에서 모두 돌아가요. Homebrew를 쓴다면 brew install --cask foxl-ai/tap/foxl로 같은 빌드를 설치할 수 있고, cask는 릴리스마다 업데이트돼요.

Windows앵커 링크 복사

설치 프로그램: Foxl-latest-setup.exe를 실행하고 안내를 따라가세요. Foxl을 설치하고 바탕 화면 바로 가기를 추가해요. 스스로 업데이트되는 건 이 버전이에요.

포터블: Foxl-latest-portable.zip을 받아 압축을 풀고 Foxl.exe를 실행하세요. 아무것도 설치되지 않아요.

Foxl이 이미 실행 중이면 설치 프로그램을 진행하는 동안에도, 설치를 취소해도 계속 실행돼요. 설치를 클릭할 때만 종료돼요. Foxl을 나만 쓰도록 설치했다면 설치 프로그램이 종료하기 전에 물어봐요. 예전 버전이 모든 사용자용으로 설치돼 있을 때와 자동 업데이트 중에는 묻지 않고 Foxl을 종료해요.

Linux앵커 링크 복사

1. 파일을 실행할 수 있게 만드세요: chmod +x Foxl-latest.AppImage
2. 실행하세요: ./Foxl-latest.AppImage

dlopen(): error loading libfuse.so.2로 멈추면 시스템에 FUSE 2가 없는 거예요. Ubuntu 22.04부터는 기본으로 설치되지 않아요. sudo apt install libfuse2를 실행한 다음(Ubuntu 24.04에서는 패키지 이름이 libfuse2t64예요) 다시 시도하세요.

Foxl을 처음 열면앵커 링크 복사

1. Google, Apple, GitHub, 또는 이메일(매직 링크, 또는 비밀번호를 정해 뒀다면 비밀번호)로 로그인하세요. 로그인 방법 아래의 언어 선택에서 로그인하기 전에 Foxl의 언어를 정할 수 있고, 고른 언어는 로그인한 뒤에도 그대로 유지돼요.
2. 앱 위에 짧은 초기 설정이 떠요. 화면 스타일 선택: 라이트, 다크, 시스템 중 하나와 19가지 색상 테마 중 하나를 골라요. Foxl에게 당신을 알려주세요: 내 역할, 그리고 기술에 얼마나 익숙한지를 카드 세 장 중에서 골라요(기술적인 내용까지 전부, 내부 구조는 빼고 개념만, 또는 쉬운 말로). 꼭 해야 하는 건 없어요. 아무것도 고르지 않아도 계속을 누를 수 있고, 모두 건너뛰기나 Escape로 언제든 나갈 수 있어요.
3. Foxl Notes 준비하기(데스크톱 앱). 한 화면이고, 모든 항목은 선택 사항이에요.
   • Apple Silicon Mac에서는 이 Mac에서 Notes 실행하기(Windows PC나 Linux x64 컴퓨터에서는 이 컴퓨터에서 Notes 실행하기)가 온디바이스 음성 엔진과 Gemma를 함께 설치해요. 약 6.5GB예요(컴퓨터에 없는 부분만 받아요). 남은 양을 보여 주고, 일시 정지할 수 있고, 계속을 누른 뒤에도 백그라운드에서 이어서 받아요. 이미 전사와 요약을 할 수 있는 컴퓨터에는 대신 준비됨이 보여요. 다른 컴퓨터에서는 회의 전사 항목에서 AssemblyAI 키를 넣을 수 있고, 이미 전사할 수 있는 컴퓨터라면 준비됨이 보여요. 채팅용 Gemini 키가 이미 있으면(설정 > 모델/제공자) 키를 또 붙여 넣는 대신 Gemini 사용하기가 나와요.
   • 마이크와 다른 앱 소리: 허용을 누르면 시스템 권한 창이 뜨고, 항목이 허용됨으로 바뀌어요. Windows는 마이크 권한만 묻고, Linux는 마이크만 녹음해요.
   • 실시간 번역: 직접 켜기 전에는 꺼져 있고, 번역할 언어도 함께 골라요.
4. 설정 가져오기. Foxl에 아직 없는 내용이 담긴 Claude Code나 Codex 설정을 컴퓨터에서 찾았을 때만 나와요. 지침, 스킬, MCP 서버가 보이고, 새로운 항목은 모두 체크돼 있어요. 가져오기를 누르면 체크한 항목을 가져오고(지침은 Foxl의 AGENTS.md 끝에 추가돼요), Foxl에 이미 있는 건 바꾸지 않아요. 아무것도 체크하지 않고 계속을 누르면 아무것도 가져오지 않아요. 같은 가져오기는 나중에 설정 > 고급에서도 할 수 있어요.
5. 모델 연결. 아직 채팅에 답할 수 있는 게 없는 컴퓨터에서는 마지막 화면이 모델 연결을 도와줘요. OpenRouter, 다른 제공자, 또는 Apple Silicon Mac이라면 이 Mac에서 AI 실행하기(Windows와 Linux에서는 이 컴퓨터에서 AI 실행하기) 중에서 고르면 돼요. 이 Mac에서 Notes 실행하기가 이미 그 다운로드를 제안했다면 이 화면에서는 다시 제안하지 않고, 거기서 설치를 눌렀다면 다운로드 진행 상황을 보여 줘요. AWS 자격 증명, Claude Code나 ChatGPT 로그인, Ollama, 제공자 키가 있어서 이미 채팅할 수 있는 컴퓨터에는 이 화면이 나오지 않아요. 시작하기를 보세요.
6. 짧은 둘러보기가 스케줄, 에이전트, 채팅을 가리키고, macOS와 Linux 앱에서는 제목 표시줄의 초록색 점(지금 실행 중인 작업, 채팅의 토큰과 비용, 요금제나 크레딧의 남은 양을 보여 주는 상태 패널이 열려요)을, 데스크톱 앱에서는 모델/제공자 설정을 가리켜요. Foxl Notes를 처음 열면 짧은 둘러보기가 주요 컨트롤을 알려 주고, 설정을 처음 열면 설정에만 있는 몇 가지 기능(Chrome 확장, Mac의 컴퓨터 사용, 어디서나 음성 입력, 그리고 Mac이나 Windows PC에서는 종료해도 계속 실행)을 알려 준 다음 Foxl Notes에 캘린더 연결하기로 끝나요.

새로 설치하면 Foxl은 스케줄이나 에이전트가 끝났을 때 알려 주지 않아요. 실패했을 때, 기기가 연결됐을 때, 내 답이 필요할 때는 여전히 알려 줘요. 끝났을 때도 알림을 받고 싶다면 설정 > 알림의 스케줄이나 에이전트 아래에서 작업 완료를 켜세요. 이미 Foxl을 쓰던 컴퓨터는 알림 설정이 그대로 유지돼요.

Windows에서는 초기 설정의 계속 옆에 로그인할 때 Foxl 시작도 켜진 채로 보여요. 켜 둔 채로 초기 설정을 마쳐야만 Foxl이 로그인할 때 실행되는 앱에 추가돼요. 나중에 설정 > 일반 > 로그인 시 자동 시작에서 바꿀 수 있어요.

초기 설정을 다시 보고 싶나요? 설정 > 화면 모드에 설정 다시 보기가 있고, 그 아래의 온보딩 초기화는 로그인한 상태라면 계정의 초기 설정을 처음부터 다시 시작해요. 내 기기 중 가장 먼저 여는 기기에서 한 번 더 실행돼요. 로그인한 기기 하나에서 초기 설정을 끝내거나 건너뛰면 모든 기기에서 완료로 처리돼요. 휴대폰 앱은 이 초기 설정을 건너뛰고 바로 앱으로 들어가요. 휴대폰에서 설정 다시 보기로 직접 요청하거나 초기화로 요청됐을 때만 나와요. 이때 휴대폰에서는 화면 스타일 화면이 라이트, 다크, 시스템만 물어요. app.foxl.ai에서는 새 계정으로 처음 로그인하면 화면 스타일과 자기소개 화면, 그리고 둘러보기가 나와요. Notes, 설정 가져오기, 모델 연결 화면은 데스크톱 앱에만 있어요.

Windows와 Linux: 트레이, 창, 메뉴앵커 링크 복사

• 트레이 아이콘을 누르면 창이 열려요. Windows에서는 시스템 트레이의 Foxl 아이콘을 클릭하거나 더블클릭하면 창이 다시 나와요. Linux에서는 데스크톱 환경이 허용하는 곳이라면 클릭으로 열려요. macOS에서는 메뉴 막대 아이콘을 클릭하면 메뉴가 열려요.
• 창 닫기. Windows에서는 창을 닫아도 트레이 아이콘이 있든 없든(설정 > 일반의 시스템 트레이에 표시) Foxl이 계속 실행돼요. Linux에서는 그 설정에 따라 달라요. 트레이 아이콘이 켜져 있으면 Foxl이 계속 실행되고(처음 한 번은 알림으로 그 사실과 다시 여는 방법을 알려 줘요), 꺼져 있으면 창을 닫을 때 Foxl이 종료돼요.
• 메뉴는 앱의 언어를 따라요. 메뉴 막대와 트레이 메뉴 모두요. 새로 설치한 직후에는 Foxl 창이 한 번 열릴 때까지 영어로 나와요.
• Linux에서는 메뉴 막대가 숨겨져 있어요. Alt를 누르면 보여요. Ctrl+Q 같은 단축키는 어느 쪽이든 동작해요.
• Ctrl+R로 앱이 새로고침되지 않아요. 보기 > 새로고침은 단축키 없이 메뉴에 그대로 있고, 터미널에서 Ctrl+R은 여전히 셸로 가요. macOS의 Cmd+R은 그대로예요.
• Windows 작업 표시줄 고정. Foxl은 시작 메뉴 바로 가기와 같은 앱 ID로 실행돼요. Windows는 이 ID로 알림을 보내고, 고정한 Foxl을 그 창과 묶어요. 로그인 시 자동 시작도 같은 ID를 써서 로그인할 때 Foxl이 두 번 실행되지 않아요. 0.7.36 이하 버전에서 Foxl 창으로 고정한 항목은 Foxl이 시작되고 잠시 뒤에 이 ID로 옮겨져요. 그래도 Foxl 버튼이 두 개 보이면 Foxl을 고정 해제했다가 다시 고정하세요.

라이트, 다크, 그리고 창앵커 링크 복사

Foxl은 시스템의 라이트/다크 설정을 따라요. 직접 고르려면 설정 > 화면 모드를 여세요. 같은 페이지에 19가지 색상 테마와 15가지 표면도 있어요(화면 모드 참고). 고른 설정은 데스크톱 앱, app.foxl.ai, 휴대폰 앱에 적용돼요.

macOS 26(Tahoe) 이상에서는 창의 바깥 테두리가 비쳐 보여서, 콘텐츠는 불투명하게 유지되면서 사이드바 뒤로 바탕 화면이 보여요. 이전 macOS, Windows, Linux는 일반적인 불투명 창을 써요.

업데이트앵커 링크 복사

Foxl은 업데이트를 스스로 확인하고, 앱을 종료할 때 설치해요.

업데이트를 끝내지 못하면(앱을 아직 쓰고 있는 무언가가 있었다면) 다음 실행 때 알림 벨과 설정에서 알려 주고 다시 시도하도록 제안해요.

베타 업데이트앵커 링크 복사

설정 > 일반의 업데이트 아래에 있는 베타 업데이트 스위치를 켜면 베타 버전이 나오자마자 받아요. 다른 사람보다 한 릴리스 먼저예요.

• 베타도 같은 Foxl이고, 같은 방식으로 서명되며, 평소 쓰는 계정과 데이터를 그대로 써요. 앱만 앞서 있어요.
• 같은 버전의 정식 버전이 나오면 자동으로 그 버전으로 옮겨 가요.
• 스위치를 끄면 그 정식 버전이 나올 때까지 지금 버전에 머물러요. 이전 버전으로 되돌아가는 일은 없어요.
• 베타는 프리릴리스로 게시돼서, 스위치를 끈 상태에서는 베타를 받을 일이 없고 다운로드 링크는 늘 정식 버전을 줘요.

도움이 필요한가요?앵커 링크 복사

문제 해결을 보거나 Discord 커뮤니티에서 물어보세요.