# 설정

글쓰기 방식을 정하고, 연구 도구를 연결하고, 로컬 저장소를 관리합니다.

레일의 톱니바퀴나 명령 팔레트에서 **설정**을 열거나, macOS에서는 ⌘,, Windows와 Linux에서는 Ctrl+,를 누르세요. 이 단축키는 분리된 PDF 창에서도 작동하며, macOS에서는 **Oleafly** 메뉴에도 **설정…** 항목이 있습니다. [클라우드 동기화](/docs/cloud-sync/#settings)를 켜지 않는 한 설정은 이 컴퓨터에 적용됩니다. 프로젝트의 엔진, 메인 문서 등 프로젝트 단위의 선택은 프로젝트 파일과 함께 이동합니다.

![프로젝트 도구 모음에서 설정을 엽니다. 왼쪽 열에 모든 설정 섹션이 나열됩니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-general-dark-window-v2.png#view=519,89,883,902)

## 설정 찾기

왼쪽 열 맨 위의 **설정 검색**에 "테마", "Zotero", "맞춤법" 같은 단어를 입력하세요. 섹션 목록이 일치하는 섹션과 설정으로 좁혀집니다. 설정을 선택하면 그곳으로 이동합니다. Oleafly가 알맞은 탭을 열고 해당 행으로 스크롤한 뒤 색을 입혀서 쉽게 찾을 수 있게 해 줍니다.

## 섹션 초기화

일반, 모양, 사전, AI 어시스턴트, 엔진, 키보드 단축키, 실험 기능은 각각 마지막에 **기본값으로 초기화**가 있습니다. 버튼의 작은 점은 그 섹션의 무언가가 기본값과 다르다는 뜻입니다. 한 섹션을 초기화해도 다른 섹션에는 영향이 없습니다.

## 경로는 가려집니다

홈 폴더 안의 경로는 `~/…`로 표시됩니다. 프로젝트 폴더, 엔진 위치, CLI 에이전트 프로그램처럼 설정에 나오는 파일과 폴더 경로는 마우스를 올리거나 Tab으로 이동하기 전까지 흐리게 표시됩니다. 그래서 설정을 스크린샷으로 찍어도 파일이 어디에 있는지 드러나지 않습니다.

## 일반

인터페이스 언어를 고르고, 교정을 설정하고, 오프라인 컴파일을 켜거나 끄고, 둘러보기를 제어합니다. 인터페이스는 21개 언어로 제공되며 **시스템 기본값**은 운영 체제를 따릅니다. 새 언어는 바로 적용됩니다.

[일반의 모든 컨트롤](/docs/settings/general/)에는 각각의 설명이 있습니다. **오프라인 모드**는 Tectonic과 Typst가 이미 가진 패키지만 쓰게 하고 네트워크 인용 조회를 끕니다. 새 프로젝트를 오프라인으로 전환하기 전에 [컴파일](/docs/compiling/)을 읽어 보세요.

## 모양

밝은 테마와 어두운 테마, 강조 색상, 배경, 앱과 편집기의 글꼴을 고릅니다. 컴퓨터에 설치된 어떤 글꼴이든 쓸 수 있습니다. 앱 전체의 확대/축소 수준을 설정하고, 텍스트 크기를 조정하고, 프로젝트를 분할 보기, 편집기만, PDF만 중 무엇으로 열지 고르세요. 편집기에는 밝은 모드용 테마 하나와 어두운 모드용 테마 하나가 적용되며, **편집기 색상**에서 두 테마의 어떤 색이든 바꿀 수 있습니다. 여기의 편집기 컨트롤에는 줄 높이, 자간, 커서, 자동 완성, 괄호와 수식과 환경 짝 맞추기, 고정 컨텍스트, 키 바인딩(기본, Vim, Emacs), 인라인 제안, 파일을 옮길 때 경로에 일어나는 일도 있습니다. 파일 트리, 라이브러리 PDF 미리보기, Zen 모드도 제어할 수 있습니다. **터미널** 탭은 내장 터미널의 스타일을 정합니다. 이 탭의 **폴더를 열 위치** 설정은 **터미널에서 열기**와 CLI 에이전트 로그인처럼 Oleafly가 대신 실행하는 명령에 쓸 터미널 앱을 고릅니다. 내장 터미널일 수도 있고, macOS의 iTerm, Windows의 Windows Terminal, Linux의 GNOME Terminal 같은 다른 앱일 수도 있습니다. [모양과 테마](/docs/settings/appearance/)를 참고하세요.

## 사전

무시한 단어를 검토합니다. **전역** 탭에는 모든 프로젝트에서 건너뛴 단어가, **프로젝트** 탭에는 열려 있는 프로젝트에서만 건너뛴 단어가 나열됩니다. 단어를 제거하면 다시 교정 대상에 포함됩니다. 탭 아래에는 꺼 둔 문법 규칙, 무시한 결과, **학술 프로필이 꺼 두는 규칙**이 있습니다. 이 규칙은 모두 하는 일, 예시, 켜는 스위치와 함께 나옵니다. [맞춤법과 문법](/docs/spellcheck-grammar/)을 참고하세요.

## 데이터 저장

라이브러리가 어디에 있고 프로젝트, 파일, Git 이력, 빌드 캐시가 공간을 얼마나 쓰는지 확인합니다. 자동 [체크포인트](/docs/checkpoints/)와 저장 알림은 **로컬 저장소**에서 제어합니다. **클라우드 동기화** 탭은 라이브러리 프로젝트와 설정을 Dropbox에 백업합니다. 로컬 저장소는 여기서 관리하고, 백업할 때는 [데이터는 어디에 있나요](/docs/where-your-data-lives/)를 따르세요.

## AI 어시스턴트

| 탭 | 설정할 수 있는 것 |
|---|---|
| **제공자와 키** | 클라우드 제공자, 호환 엔드포인트, 로컬 모델, 모델 선택기, 프로젝트 승인, 예산. |
| **CLI 에이전트** | 내 컴퓨터에서 실행되는 에이전트의 설치, 연결, 구성. |
| **지침** | 글쓰기 지침, 모델 기본값, PDF 캡처, 도구 카탈로그. |
| **페르소나** | 작업 종류별로 이름을 붙인 지침 프리셋. |
| **스킬** | 연구 워크플로, 분야별 안내, 직접 만든 재사용 스킬. 검색 상자와 스킬마다 스위치 하나가 있습니다. |
| **MCP** | 어시스턴트가 사용할 수 있는 외부 도구. 서버 검색과 구성 가져오기를 포함합니다. |
| **도구** | 로컬 모델이나 연결된 CLI 에이전트 같은 도구에 쓸 모델, 그리고 Mathpix 키. |

[AI 설정하기](/docs/ai-setup/)부터 시작하세요. 개별 컨트롤은 [CLI 에이전트](/docs/cli-agents/), [스킬](/docs/skills/), [사용량과 예산](/docs/ai-usage/)을 읽어 보세요.

## 엔진

문서를 컴파일하는 도구를 관리합니다. LaTeX의 경우 Oleafly가 시스템에 설치된 TeX를 감지하거나 자체 TinyTeX를 설치할 수 있습니다. 패키지 관리와 태그된 PDF 설정도 여기에 있습니다. [LaTeX 엔진과 패키지](/docs/latex-engines/)를 참고하세요.

**LaTeX** 탭의 **TeX 배포판 관리**에는 Oleafly가 찾은 MacTeX, TeX Live, MiKTeX, TinyTeX 같은 모든 TeX 설치본이 나열됩니다. 설치본에 `latexmk`나 `tlmgr`가 있으면 각 행에 해당 배지가 표시되고, **사용 중**은 latexmk 컴파일이 실행되는 설치본을 표시합니다. 다른 설치본으로 컴파일하려면 그 행에서 **컴파일에 사용**을 선택하세요. 그 행의 **자동**은 선택을 Oleafly에 되돌려 주며, Oleafly는 완전한 시스템 TeX를 먼저, TinyTeX를 그다음으로 고릅니다. Perl이 없는 MiKTeX에는 **latexmk에 Perl이 필요합니다**가 표시되며, Strawberry Perl 같은 Perl을 설치하기 전에는 고를 수 없습니다. TeX가 Oleafly가 찾아보지 않는 폴더에 설치되어 있다면 **TeX 폴더 선택**으로 그 폴더를 고를 수 있습니다. [latexmk와 시스템 TeX](/docs/latex-engines/#latexmk-and-system-tex)를 참고하세요.

Oleafly 자체 TinyTeX가 없으면 TinyTeX 카드에 **TinyTeX 내려받기(약 250 MB)**가 나타납니다. 이 버튼은 TinyTeX를 내려받고, 압축을 풀고, 패키지를 추가하는 동안 진행 상황을 보여 주며, **취소**는 다운로드와 압축 풀기 중에 설치를 멈춥니다. 다운로드가 중간에 멈추면 버튼에 이미 저장된 메가바이트와 함께 **다운로드 이어가기**가 표시되고 거기서부터 이어 받습니다. 완전한 TeX 설치본이 이미 **사용 중**이면 설치한 뒤에도 계속 사용 중이며, **컴파일에 사용**으로 고른 설치본도 마찬가지입니다. TinyTeX로 바꾸려면 TinyTeX에서 **컴파일에 사용**을 선택하세요. 완전한 설치본에는 `latexmk`, pdfLaTeX, XeLaTeX, LuaLaTeX, Biber가 있습니다. **자동**에서는 Oleafly가 이 중 일부가 빠진 설치본이나 Perl이 없는 MiKTeX를 TinyTeX보다 뒤로 두므로, TinyTeX를 설치하면 저절로 TinyTeX가 넘겨받습니다. 설치하고 나면 TinyTeX는 **제거**가 있는 자기 행을 갖습니다. 설치한 TinyTeX가 이 버전의 Oleafly가 기대하는 릴리스가 아니면 그 행에 **업데이트**도 표시됩니다.

Debian, Ubuntu, Fedora에서 시스템 패키지로 설치한 TeX Live는 `apt`나 `dnf`가 관리합니다. 패키지 목록이 그렇게 알려 주며, Oleafly는 그 TeX Live를 건드리지 않습니다. 시스템 도구로 패키지를 추가하거나, Oleafly가 관리하게 하려면 TinyTeX를 내려받으세요.

**LaTeX** 탭에는 **기본 컴파일 엔진**도 있습니다. 새로 만들거나 가져오거나 변환한 LaTeX 프로젝트는 여기서 고른 엔진으로 시작합니다. [새 프로젝트의 기본값 설정하기](/docs/engines/#set-a-default-for-new-projects)를 참고하세요.

Typst의 경우 **버전**에 Typst 0.11부터 0.15까지가 나열됩니다. 버전을 설치하고, 새 프로젝트의 기본값을 고르고, **새 버전 사용해 보기**로 열려 있는 프로젝트를 더 새로운 Typst로 빌드해 보면 전환하기 전에 어떤 오류와 경고가 달라지는지 알 수 있습니다. 각 프로젝트는 컴파일 메뉴에서 자기 버전을 고정합니다. [Typst 버전](/docs/typst/#typst-versions)을 참고하세요.

**Markdown 컴파일러** 행은 관리형 Pandoc을 설치하거나 복구합니다.

## 다운로드

템플릿과 글꼴 팩을 내려받고, 내려받은 글꼴을 프로젝트에 추가하고, 내려받은 맞춤법 사전을 확인하고, 갤러리에 저장한 AI 템플릿을 관리합니다. **다운로드 소스** 탭은 다운로드를 받아 오는 곳과 `tlmgr`이 TeX 패키지를 설치해 오는 저장소를 정합니다. [다운로드](/docs/settings/downloads/)를 참고하세요.

## 연동

각 탭에는 해당 서비스의 로고가 표시됩니다.

| 탭 | 연결하는 대상 |
|---|---|
| **GitHub** | 프로젝트를 게시하고 pull, push할 때 쓰는 계정, 그리고 새 프로젝트에 Git 저장소를 만들지 여부. |
| **alphaXiv** | alphaXiv의 MCP 서버. 어시스턴트가 논문을 검색하고 읽을 수 있습니다. |
| **Zotero** | Zotero 라이브러리. 글을 쓰면서 인용하거나 프로젝트의 참고문헌으로 가져올 수 있습니다. |
| **인용 검색** | 학술 검색 서비스의 키와 연락용 이메일. |
| **Oleafly MCP** | 외부 어시스턴트가 내 프로젝트에서 작업하도록 하는 Oleafly의 로컬 서버. |
| **데스크톱 앱** | 에이전트가 허용한 데스크톱 프로그램과 웹사이트를 쓸 수 있게 하는 Cua Driver. |

alphaXiv, Zotero, 인용 검색은 [연구 자료 서비스 연결](/docs/integrations/research-sources/)에서 다룹니다. 외부 MCP 도구는 **AI 어시스턴트 → MCP**에서 연결합니다. 외부 어시스턴트는 **연동 → Oleafly MCP**를 통해 Oleafly에 연결합니다. [MCP 가이드](/docs/mcp/)는 두 방향을 모두 다룹니다.

## 키보드 단축키

단축키 목록을 검색하고, 사용자 지정을 지원하는 앱 동작의 대체 단축키를 기록합니다. 편집기 바인딩은 앱 명령과 함께 나열됩니다. [키보드 단축키](/docs/keyboard-shortcuts/)를 참고하세요.

## 실험 기능

실험 기능에는 아직 베타인 기능이 모여 있습니다. 섹션 맨 위의 경고는 이 기능들이 아직 충분히 테스트되지 않았으며 이후 릴리스에서 바뀌거나, 망가지거나, 사라질 수 있다고 알려 줍니다. 스위치는 모두 기본적으로 꺼져 있습니다.

- **LaTeX 도구**는 Oleafly 도구 갤러리와 슬래시 명령을 표시합니다. [Oleafly 도구 가이드](/docs/tools/)는 모든 변환기, 참조 빌더, 연구 유틸리티, 검사기, 글쓰기 도우미를 다룹니다.
- **노트**는 홈 독에 노트를 추가합니다. 노트는 다이어그램, 차트, 수식을 넣을 수 있는 Markdown 파일로, 나와 에이전트가 함께 편집할 수 있습니다. 노트는 프로젝트 라이브러리에 나타나지 않으며, 노트마다 프로젝트에 연결할 수 있습니다. 이 스위치는 **설정 → 모양**과 **설정 → 키보드 단축키**에 **노트** 탭도 추가합니다. [노트](/docs/notes/)를 참고하세요.
- **연구 작업**은 에이전트가 프로젝트의 사본에서 혼자 작업하고 변경 사항을 내가 검토하도록 남겨 둡니다. 앱은 이 기능이 매우 불안정하다고 표시합니다. 실행이 멈추거나, 실패하거나, 직접 정리해야 할 변경 사항을 남길 수 있고, 그동안 내내 제공자의 할당량을 사용합니다. 이 기능을 켜면 설정에 **연구** 섹션이 추가되고, 끄면 실행 중인 모든 작업이 중단됩니다. [연구 작업](/docs/research-tasks/)을 참고하세요.

![설정 → 실험 기능에서 LaTeX 도구, 노트, 연구 작업이 켜져 있고, 위에는 이 기능들이 아직 베타라는 경고가 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-experimentation-dark-window-v2.png#view=424,136,1072,928)

이 옵션을 쓰는 가이드를 따라 하기 전에 여기서 스위치를 켜세요.

## 도움말 및 정보

앱 버전을 확인하고, 업데이트를 찾고, 새로운 기능을 읽고, 둘러보기를 다시 시작하고, 문서를 열고, 문제를 신고하세요. **정보 복사**는 버그 신고에 쓸 버전과 시스템 정보를 모아 줍니다. **논문에서 Oleafly 인용하기**는 페이지의 마지막 카드입니다.

설정 사이드바 맨 아래에는 어느 섹션을 열어 두었든 작은 버튼 다섯 개가 있습니다. Discord, X, GitHub, 문서, 릴리스 노트입니다. 마지막 버튼은 새로운 기능을 엽니다.

개별 가이드는 [일반](/docs/settings/general/), [모양](/docs/settings/appearance/), [다운로드](/docs/settings/downloads/), [저장소](/docs/settings/storage/), [도움말](/docs/settings/help/)을 읽어 보세요.
