설정 참조

이 페이지는 Elftia에서 사용자가 구성할 수 있는 모든 설정을 다루는 전체 참조 문서입니다. 설정은 탭별로 구성되어 있으며, 애플리케이션의 설정 페이지와 대응됩니다.

일반 설정

Settings → General 아래에 있습니다.

언어

설정	옵션	기본값	설명
인터페이스 언어	Simplified Chinese / English / 日本語	시스템 따르기	애플리케이션 인터페이스의 표시 언어

언어 변경은 재시작 없이 즉시 적용됩니다.

프록시

설정	옵션	기본값	설명
프록시 모드	System Proxy / Custom Proxy / No Proxy	System Proxy	네트워크 요청에 사용하는 프록시 방식
사용자 지정 프록시 URL	텍스트 입력	비어 있음	"Custom Proxy" 모드에서만 적용됩니다

자세한 내용은 프록시 사용을 참조하세요.

시작

설정	유형	기본값	설명
자동 시작	토글	끄기	운영 체제가 시작될 때 Elftia를 자동으로 실행합니다
시작 시 최소화	토글	끄기	자동 시작 후 창을 표시하는 대신 트레이로 최소화합니다

트레이

설정	유형	기본값	설명
트레이로 최소화	토글	끄기	창을 닫을 때 애플리케이션을 종료하는 대신 시스템 트레이로 최소화합니다

알림

설정	유형	기본값	설명
데스크톱 알림	토글	켜기	새 메시지가 도착하면 시스템 알림을 표시합니다
알림 소리	토글	켜기	알림이 도착하면 알림 소리를 재생합니다

환경 도구

일반 설정 페이지 하단에 있으며, 시스템에 설치된 개발 도구의 상태를 표시합니다.

도구	목적	자동 설치 가능
Node.js	MCP 서버 런타임	아니요
Git	버전 관리	아니요
ripgrep (rg)	빠른 파일 검색	예
uv	Python 패키지 관리자	예
uvx	Python 도구 실행기	예

"자동 설치 가능"으로 표시된 도구는 "Install" 버튼을 클릭해 자동으로 설치할 수 있습니다.

외형 설정

Settings → Appearance 아래에 있습니다. 자세한 설명은 테마 및 외형을 참조하세요.

설정	유형	기본값	설명
테마 모드	Light / Dark / Follow System	Follow System	인터페이스 색 구성표
강조 색상	색상 선택기	Preset Blue	버튼, 링크 및 기타 요소의 테마 색상
UI 글꼴	텍스트 입력	Inter	인터페이스 텍스트에 사용하는 글꼴
코드 글꼴	텍스트 입력	JetBrains Mono	코드 블록에 사용하는 고정폭 글꼴
배경화면(라이트 모드)	이미지 업로드 / URL	없음	라이트 모드의 배경화면
배경화면(다크 모드)	이미지 업로드 / URL	없음	다크 모드의 배경화면
블러 강도	슬라이더 0-30	6	배경화면에 적용할 가우시안 블러 양
마스크 불투명도	슬라이더 0-100	70	배경화면 마스크 레이어의 불투명도
컴팩트 창에서 배경화면 비활성화	토글	켜기	창이 작을 때 배경화면을 자동으로 비활성화합니다
사용자 지정 CSS	CSS 편집기	비어 있음	사용자 지정 스타일을 주입합니다
원격 리소스 허용	토글	끄기	원격 이미지와 글꼴 로드를 허용합니다
원격 도메인 허용 목록	목록	기본 목록	리소스 로드가 허용된 도메인

Provider 설정

Settings → Provider Settings 아래에 있습니다. 자세한 설명은 LLM Provider 구성을 참조하세요.

각 provider는 다음 옵션으로 구성할 수 있습니다.

설정	유형	설명
API Key	비밀번호 입력	provider의 API Key
Base URL	텍스트 입력	API 엔드포인트 주소(사용자 지정 엔드포인트 지원)
활성화	토글	이 provider를 활성화할지 여부
API Key 풀	다중 키 관리	로드 밸런싱을 위해 여러 API Key 구성

API Key 풀

각 provider는 여러 API Key 구성을 지원하며, 시스템은 가중 라운드 로빈을 사용해 그중 하나를 자동으로 선택합니다.

설정	유형	설명
키 목록	목록	여러 API Key 항목
가중치	숫자	각 키의 선택 가중치
활성화/비활성화	토글	개별 키의 활성화 상태

키에서 429(속도 제한) 또는 529(과부하) 오류가 발생하면, 시스템은 자동으로 사용 가능한 다른 키로 전환하고 실패한 키에 쿨다운 기간을 설정합니다(60초에서 15분까지 지수 백오프).

기본 모델

Settings → Default Models 아래에 있습니다.

설정	목적	설명
일반 채팅	일상 대화용 기본 모델	새 대화를 만들 때 자동으로 선택됩니다
긴 컨텍스트	긴 문서를 처리하기 위한 모델	컨텍스트가 임계값을 초과하면 자동으로 전환됩니다
웹 검색	검색 요약용 모델	웹 검색을 활성화할 때 사용됩니다
이미지 생성	이미지 생성 모델	이미지를 만들 때 사용됩니다
백그라운드 작업	백그라운드 처리용 모델	대화 제목 생성, 요약 등에 사용됩니다

각 범주는 활성화된 모든 provider의 사용 가능한 모델 중에서 선택할 수 있습니다.

Agent 설정(Clawia)

Settings → Clawia(Agent Configuration 탭) 아래에 있습니다.

Agent 엔진

설정	옵션	기본값	설명
Agent Backend	Claude SDK / TinyElf / CLI	Claude SDK	Agent 실행 엔진

• Claude SDK: 가장 완전한 기능을 제공하는 Anthropic의 Agent SDK를 사용합니다.
• TinyElf: 모든 LLM provider를 지원하는 내장 경량 agent 엔진입니다.
• CLI: 명령줄을 통해 외부 agent 도구를 호출합니다(Claude Code CLI, Codex CLI 등).

CLI Backend 설정(CLI 모드 전용)

설정	유형	기본값	설명
CLI 도구	선택	Claude Code	사용할 CLI backend
제한 시간	숫자(초)	300	단일 실행의 최대 지속 시간
PTY 모드	토글	끄기	실행에 의사 터미널을 사용합니다
PTY 열	숫자	120	PTY 터미널 너비
PTY 행	숫자	40	PTY 터미널 높이

프롬프트 버전

설정	옵션	기본값	설명
프롬프트 버전	V1 / V2 / V3 / V4	V4	시스템 프롬프트 구성 방식

• V1: SDK preset + 단순 추가(time, workspace, memory, channels)
• V2: 완전히 사용자 지정된 시스템 프롬프트(PromptBuilder)
• V3: V2 + 5계층 구조(bootstrap, onboarding, memory, channels, dynamic)
• V4: SDK preset + bootstrap file + soul/memory/onboarding/channels/scheduling

팁

V4는 권장 기본 버전이며, SDK 최적화와 프로젝트별 사용자 지정을 결합합니다. 대부분의 사용자는 이 설정을 변경할 필요가 없습니다.

보안 설정

설정	옵션	기본값	설명
GuardianAgent 모드	Off / Monitor / Guard / Strict	Off	AI 안전 검토 수준

자세한 내용은 보안 설정을 참조하세요.

세션 모드

설정	옵션	기본값	설명
기본 세션 모드	Continue / New	Continue	애플리케이션을 열 때의 기본 동작

• Continue: 애플리케이션을 열 때 이전 대화 세션을 복원합니다.
• New: 애플리케이션을 열 때마다 새 대화 세션을 만듭니다.

개발자 모드

설정	유형	기본값	설명
개발자 모드	토글	끄기	활성화하면 DevTools와 추가 디버깅 정보에 접근할 수 있습니다

개발자 모드는 Settings → About에서 특정 동작(버전 번호를 연속 클릭)을 통해 활성화해야 합니다. 활성화되면 Clawia 탭에 개발자 모드 토글이 표시됩니다.

웹 검색 설정

Settings → Web Search 아래에 있습니다. 자세한 설명은 웹 검색 기능을 참조하세요.

설정	유형	설명
검색 provider	선택	웹 검색 엔진 provider를 선택합니다
구성 전략	선택	검색 결과의 구성 방식
압축 설정	옵션	검색 결과 콘텐츠의 압축 수준
도메인 차단 목록	목록	이 도메인에서는 검색 결과를 가져오지 않습니다

시스템 설정

Settings → System 아래에 있습니다.

진단 도구

작업	설명
진단 내보내기	진단 정보(로그, 구성, 런타임 환경)를 내보냅니다
캐시 지우기	로컬 캐시 데이터를 지웁니다
진단 로그 복사	진단 로그를 클립보드에 복사합니다
첨부 파일 정리	연결되지 않은 첨부 파일을 정리합니다

데이터베이스 유지 관리

작업	설명
데이터베이스 크기	현재 SQLite 데이터베이스 파일 크기를 표시합니다
VACUUM	데이터베이스 압축 최적화를 실행하고 삭제된 데이터가 사용하던 공간을 회수합니다

리소스 정리

작업	설명
정리 가능한 항목	안전하게 삭제할 수 있는 고립된 리소스의 수량과 크기를 표시합니다
리소스 정리	리소스 정리를 실행합니다

데이터 가져오기 및 마이그레이션

작업	설명
Legacy JSONL 가져오기	빠른 페이지네이션 쿼리를 위해 ~/.claude/projects/*.jsonl을 데이터베이스에 동기화합니다
썸네일 생성	목록과 갤러리 로딩 속도를 개선하기 위해 기존 이미지의 썸네일을 일괄 생성합니다
첨부 파일 저장소 마이그레이션	기존 media:// 첨부 파일을 resource:// 콘텐츠 주소 지정 저장소로 마이그레이션하고, 중복을 제거하며, 공간을 절약합니다

실험적 기능

테스트 중인 일부 새 기능은 이 섹션에서 켜거나 끌 수 있습니다. 실험적 기능은 불안정할 수 있으므로 고급 사용자에게만 권장됩니다.

기능	설명
새 파일 시스템	스트림 검색, ripgrep 통합, 자동 fallback 메커니즘
최적화된 파일 트리	향상된 트리 렌더링과 증분 업데이트

문제가 발생하면 언제든지 기능을 끄고 안정 버전으로 되돌릴 수 있습니다.

:::info Design Studio는 기본적으로 활성화되어 있습니다 Design Studio는 버전 0.1.7부터 기본적으로 활성화되어 있으며 더 이상 실험적 기능에 포함되지 않습니다. 이제 탐색 모음에는 🎨 Design Studio 항목이 직접 표시됩니다. 남은 유일한 요구 사항은 현재 LLM provider 엔진이 Design adapter를 지원해야 한다는 것입니다(api 엔진은 지원하지 않음). 자세한 내용은 Design Studio를 참조하세요. :::

정보

Settings → About 아래에 있습니다.

정보	설명
버전	현재 Elftia 버전
업데이트 확인	새 버전을 사용할 수 있는지 수동으로 확인합니다
개발자 모드	버전 번호를 연속 클릭하여 활성화합니다
DevTools	개발자 모드에서 Electron DevTools를 열거나 닫습니다
계정 상태	로그인 상태와 멤버십 정보

---

보안 관련 설정에 대한 자세한 설명은 보안 설정을 계속 읽어보세요.