설정
상단 바의 톱니바퀴 아이콘을 클릭하면 설정(Settings, 상단 버튼 툴팁은 “구성”, 대화상자 제목은 “설정”)이 열립니다. 왼쪽에는 그룹과 그 안의 탭이 나열되고, 오른쪽에는 선택한 탭이 표시됩니다. 일부 탭은 변경 사항이 자동으로 저장되고, 일부 탭은 자체 Save(저장) 버튼을 사용합니다.
그룹은 접을 수 있으며, HagiCode는 어떤 그룹을 펼쳐 두었는지 기억합니다.
| 그룹 | 탭 |
|---|---|
| General(일반) | General Settings(일반 설정), Notifications(알림), Confirm Prompts(확인 메시지), About(정보) |
| Appearance and interface(외관 및 인터페이스) | Startup Splash(시작 화면), Status Bar Scroll(상태 표시줄 스크롤), TokenMonitor, Mermaid Appearance(Mermaid 다이어그램 모양), Kanban Right Panel(칸반 오른쪽 패널) |
| Sessions and conversation(세션 및 대화) | Session List(세션 목록), Chat View(채팅 보기), AgentCLI Interactive Control(AgentCLI 대화형 제어), Agent resource limits(Agent 리소스 한도), Error Retry(오류 재시도), Post-state actions(세션 상태 후 동작) |
| Proposals and planning(제안 및 계획) | Proposal Creation(제안 생성), Planning Direction(계획 방향), Proposal Stage Diagram(제안 단계 다이어그램) |
| Input and efficiency(입력 및 효율) | Haginput, Common Phrases(자주 쓰는 문구), Quick Actions(빠른 작업), Comments(주석) |
| Projects and integrations(프로젝트 및 통합) | Project Icon(프로젝트 아이콘), GitHub, Git, Code Server, OmniRoute |
| Lifestyle and wellbeing(생활과 건강) | Achievements(업적), Break Reminder(휴식 알림), Salary Tracker(시급 계산기) |
| System(시스템) | Data Management(데이터 관리), Debug(디버그), Danger Zone(위험 영역) |
일부 컨트롤은 TurboEngine DLC를 활성화해야 사용할 수 있습니다. 활성화되지 않은 경우 잠금 상태로 표시됩니다.
General(일반)
General Settings(일반 설정)

- Brand Customization(브랜드 사용자 지정)에서는 상단 바 로고, 애플리케이션 제목, 브랜드 이동 링크, 브라우저 제목을 설정하고 결과를 실시간으로 미리 볼 수 있습니다. 이 컨트롤은 미리 보기만 가능하며, TurboEngine DLC를 활성화하기 전까지는 잠겨 있습니다.
- Back to Top Button Settings(맨 위로 버튼 설정)에서는 세션에서 “맨 위로” 버튼의 위치를 선택합니다. 예를 들어 Bottom Right(오른쪽 아래)를 고를 수 있습니다.
Notifications(알림)

먼저 알림을 켠 다음 채널을 선택합니다. 채널은 Toast notifications(토스트 알림), Browser notifications(브라우저 알림, 브라우저에서 허용해야 함), Speech synthesis(음성 합성), Sound Settings(소리 설정)입니다. Status rules(상태 규칙) 표에서는 세션 상태마다 어떤 채널을 사용할지, 어떤 소리를 재생할지 정합니다. 상태는 New(신규), Drafted(초안 작성됨), Executing(실행 중), Waiting for Reply(응답 대기), Execution Complete(실행 완료), Archived(보관됨) 등입니다. 재생 버튼을 누르면 소리를 미리 들을 수 있습니다.
Confirm Prompts(확인 메시지)

전체를 제어하는 스위치 하나와, 확인 대화상자마다 하나씩 있는 스위치가 있습니다. 대상은 Super Commit으로 모두 제출하기 전, 제안 생성, 대기 상태로 이동, 즉시 실행, 보관 전, 그리고 선택한 세션을 보관하거나 삭제하기 전입니다. 메시지를 끄면 클릭 수는 줄어들지만, 실수했을 때 치러야 할 대가는 커집니다. Reset to Default(기본값으로 복원)를 누르면 기본값으로 돌아갑니다.
About(정보)

버전과 빌드 날짜를 표시하고, 전체 커뮤니티 목록이 있는 공식 “정보” 페이지로 연결되는 링크를 제공합니다.
Appearance and interface(외관 및 인터페이스)
Startup Splash(시작 화면)

HagiCode를 시작할 때 어떤 화면을 표시할지 정합니다. Changes apply the next time HagiCode starts.(변경 사항은 다음에 HagiCode를 시작할 때 적용됩니다)
- Show startup splash image(시작 화면 이미지 표시)를 끄면 시작할 때 브랜드 이름, 버전, 로딩 표시만 나타납니다.
- Image selection(이미지 선택 방식)에는 세 가지가 있습니다. Random on every startup(시작할 때마다 무작위), Random once per day(하루에 한 번 무작위, 그날 처음 시작할 때 정해지고 이후에는 유지됨), Fixed image(고정 이미지)입니다.
- Fixed image를 선택하면 아래 선택기에 사용할 수 있는 시작 화면이 나열되며, 하나를 클릭하면 시작할 때마다 그 화면이 표시됩니다.
이 컨트롤은 미리 볼 수 있지만, 스크린샷에서 보듯 TurboEngine DLC를 활성화하기 전까지는 잠겨 있습니다.
Status Bar Scroll(상태 표시줄 스크롤)

상태 표시줄을 스크롤할지, 그리고 어떤 출처를 사용할지 선택합니다. 출처는 Tips(팁)와 Promotions(프로모션)입니다. 스크롤을 끄거나 프로모션을 사용하려면 유효한 TurboEngine 구독이 필요합니다. 이 탭에는 현재 프로모션 내용도 나열됩니다.
TokenMonitor

TokenMonitor 데스크톱 앱에서 가져온 오늘의 토큰 사용량과 비용을 상태 표시줄에 표시합니다. 스위치를 끄면 아무것도 읽지 않습니다. 거의 실시간으로 갱신하려면 HostHub address(HostHub 주소)와 HostHub secret(HostHub 비밀 키)을 함께 입력하세요. 둘 중 하나라도 비어 있으면 TokenMonitor의 로컬 데이터 파일을 대신 읽습니다.
Mermaid Appearance(Mermaid 다이어그램 모양)

Mermaid 다이어그램의 모양을 Default(기본) 또는 Archify-inspired(Archify 스타일) 중에서 고릅니다. 이 선택은 현재 브라우저에만 저장되며, 시각적 표현만 바꿉니다.
Kanban Right Panel(칸반 오른쪽 패널)

세션 칸반의 오른쪽에 무엇을 표시할지 선택합니다. Hidden(숨김), GitHub Discussion(GitHub 토론), 또는 빠른 작업과 저장소 상태를 보여주는 Quick Operations Panel(빠른 작업 패널, 기본값) 중에서 고를 수 있습니다. 실시간 Preview(미리 보기)에서 설정 후 모습을 확인할 수 있습니다.
Sessions and conversation(세션 및 대화)
Session List(세션 목록)

- Project Scope(프로젝트 범위)에서는 All Sessions(모든 세션) 칸반에 포함될 프로젝트를 정합니다. All Projects(모든 프로젝트) 또는 Custom Selection(사용자 지정 선택) 중에서 고를 수 있습니다. 적용하려면 Save를 클릭합니다.
- Session Sorting(세션 정렬)에서는 Smart Sorting(스마트 정렬, 실행 상태와 최근 활동 기준)이나 Custom Sorting(사용자 지정 정렬, 직접 정한 우선순위 규칙 사용) 중에서 고릅니다.
- Session Display Settings(세션 표시 설정)에는 보관된 세션을 목록에 계속 표시할지 여부가 포함됩니다.
Chat View(채팅 보기)

- Default to Edit Mode for Normal Chats(일반 세션 기본값을 편집 모드로 설정)에서는 새로 만든 일반 세션을 편집 모드(Agent가 파일을 수정할 수 있음)로 시작할지, 읽기 전용 모드로 시작할지 정합니다.
- Show debug metadata entry points(디버그 메타데이터 진입점 표시)를 켜면 채팅 메시지에 디버그 진입점이 추가됩니다.
- Auto-collapse long messages(긴 메시지 자동 접기)를 켜면 길이가 긴 이전 메시지가 펼치기 컨트롤이 있는 미리 보기로 표시됩니다.
- Simplified historical tool calls(이전 도구 호출 간소화)를 켜면 오래된 도구 호출이 짧은 요약으로 접혀서 다음으로 보이는 메시지에 붙습니다.
AgentCLI Interactive Control(AgentCLI 대화형 제어)

Agent CLI마다 스위치가 하나씩 있으며, 생성되는 OpenSpec 및 HagiTask prompt에 이번 실행이 비대화형이라는 안내를 계속 포함할지 정합니다. 스위치가 꺼져 있으면(기본값) 이 안내가 포함됩니다. 이 설정은 생성되는 prompt의 문구만 바꿉니다.
Agent resource limits(Agent 리소스 한도)

각 Agent CLI와 그 Agent가 실행하는 명령이 최대 얼마만큼의 메모리와 CPU를 쓸 수 있는지 제한합니다. 변경한 한도는 이후에 시작되는 Agent에만 적용됩니다. 탭에는 Memory 그룹과 CPU 그룹이 있습니다.
- Limit memory per agent(Agent별 메모리 제한): 켜면 이후 새로 실행되는 Agent와 그 Agent가 시작하는 모든 프로세스가 아래 한도의 적용을 받습니다.
- Limit per agent(Agent별 한도): 드롭다운에서 한도를 고르며, 기본값은 4 GB입니다. 설명 문구에는 그에 해당하는 소프트 제한, Node.js 힙 크기, 스왑, 작업 수 상한이 나열됩니다. HagiCode는 이 제한을 구현하기 위해 systemd 사용자 스코프 안에서 Agent를 시작합니다.
- Limit CPU per agent(Agent별 CPU 제한): 켜면 이후 새로 실행되는 Agent와 그 Agent가 시작하는 모든 프로세스가 아래에서 정한 CPU 시간을 함께 나눠 씁니다.
- Virtual CPU cores per agent(Agent별 가상 CPU 코어 수): 이 호스트가 보고하는 논리 프로세서인 가상 코어 단위로 셉니다. 기본값은 1입니다. 설명 문구에는 호스트 전체 코어 수 중 선택한 코어 수가 표시됩니다.
현재 시스템이 이 제한 중 하나를 지원하지 않으면(Linux가 아니거나, systemd-run이 없거나, systemd가 사용자 스코프를 만들 수 없거나, cpu 컨트롤러가 위임되지 않은 경우) 탭에 이유가 표시되고, 해당 스위치를 사용할 수 없으며, Agent는 그 제한 없이 시작됩니다.
Error Retry(오류 재시도)

실패한 실행을 자동으로 다시 시도합니다. Default Policy(기본 정책)에서 최대 재시도 횟수와 각 재시도 전 대기 시간을 설정합니다. 마지막 대기 시간은 이후 모든 시도에 적용됩니다. 기본 재시도 간격은 순서대로 30초, 30초, 30초, 60초입니다. CLI Overrides(CLI 덮어쓰기)에서는 각 Agent CLI가 기본 정책을 그대로 따르게 하거나 자체 간격을 사용하게 할 수 있습니다.
Post-state actions(세션 상태 후 동작)

특정 종류의 세션이 어떤 상태에 도달한 뒤 HagiCode가 자동으로 무엇을 할지 정합니다. 규칙은 나열된 순서대로 실행됩니다. 현재 기본 제공되는 규칙은 Super Commit sessions(Super Commit 메시지로 시작된 세션)를 대상으로 합니다.
- Enabled(사용): 켜면 규칙이 적용됩니다.
- When the session reaches(세션이 다음 상태에 도달하면): 규칙을 실행하는 상태입니다. 예: Execution completed(실행 완료).
- Then(그러면): 실행할 동작입니다. 예: Archive session(세션 보관).
기본 규칙은 Super Commit 세션이 실행을 마치면 자동으로 보관해 세션 목록에서 사라지게 합니다.
Proposals and planning(제안 및 계획)
Proposal Creation(제안 생성)

제안 저장소 선택기 상단에 최근 저장소 카드를 몇 개나 표시할지 정합니다. 이 줄을 숨기려면 0을 선택합니다.
Planning Direction(계획 방향)

제안 흐름이 Agent CLI마다 기본으로 제안하는 계획 방향을 매트릭스로 보여줍니다. 방향에는 탐색 모드, 변경 맵, 상호작용 흐름, 프로토타입, 아키텍처, API 시퀀스와, 편집 가능 또는 참조 전용 저장소 범위가 있습니다. 개별 Agent는 이 기본값을 덮어쓸 수 있습니다.
Proposal Stage Diagram(제안 단계 다이어그램)

제안 서랍의 단계 목록을 얼마나 자세히 보여줄지 설정합니다. Full(전체)은 단계 이름과 설명을 모두 표시하고, Compact(간략)는 이름만 표시합니다. 이 설정은 서랍의 사이드바에만 적용되며 주 흐름 다이어그램에는 영향을 주지 않습니다.
Input and efficiency(입력 및 효율)
Haginput

스마트 입력입니다. Disabled(사용 안 함), Doubao Local Voice(Doubao 로컬 음성), Haginput Remote Mode(Haginput 원격 모드) 중에서 선택할 수 있습니다. 원격 모드를 사용하면 로컬 마이크를 열지 않고도 휴대폰이나 두 번째 기기에서 입력한 텍스트를 전달할 수 있습니다. 이 탭에는 모드 상태, 자동 연결 옵션, 텍스트를 받았을 때 재생되는 알림음, 테스트 입력란이 표시됩니다.
Common Phrases(자주 쓰는 문구)

이 탭은 예전의 Standard Phrases(표준 문구)와 Common Requirements(자주 쓰는 요구 사항)를 하나로 합친 것으로, 두 부분으로 나뉩니다.
문구: 메시지 입력창에서 재사용할 수 있는 @ 문구 태그를 관리합니다. 어떤 분류와 경로 출처(프로젝트, Vault, 제안 세션, 최근 프로젝트, 사용자 지정 경로)를 @ 선택기에 표시할지 정하고, Add Group(그룹 추가)으로 사용자 지정 문구 그룹을 만들 수 있습니다.
자주 쓰는 요구 사항:

제안 요구 사항에 한 번의 클릭으로 추가할 수 있는 재사용 가능한 조각입니다. 예를 들면 No docs / tests(문서 및 테스트 제외), Self commit(직접 커밋), Output English(출력 언어 지정, 인터페이스 언어에 따라 바뀜), Ask before edit(편집 전 확인), No backward compatibility(이전 버전 호환 없음)가 있습니다. 현재 인터페이스 언어에 해당하는 요구 사항만 표시됩니다. Add Common Requirement(자주 쓰는 요구 사항 추가)로 직접 요구 사항을 만들고, 편집 및 삭제 버튼으로 관리할 수 있습니다. 기본 제공 시스템 프리셋은 Restore missing system presets(누락된 시스템 프리셋 복원)로 되돌릴 수 있습니다.
Quick Actions(빠른 작업)

Configured Commands(구성된 명령)에는 Add Command(명령 추가)로 추가한 사용자 지정 명령이 나열됩니다. Execution History(실행 기록)에는 이 명령들이 언제 실행되었는지 기록됩니다.
Comments(주석)

자주 쓰는 주석 템플릿을 저장합니다. 템플릿은 Line Comments(행 주석)와 File Comments(파일 주석) 두 목록으로 나뉩니다. Add Comment(주석 추가)로 템플릿을 만들고, 수정 내용은 Save로 저장합니다.
Projects and integrations(프로젝트 및 통합)
Project Icon(프로젝트 아이콘)

- Project Icon Mode(프로젝트 아이콘 모드)에서는 새 프로젝트의 기본 스타일을 설정합니다. Game Icon(게임 아이콘, 무작위 컬러 아이콘이며 기본값)이나 Text Abbreviation(텍스트 약어, 프로젝트 이름의 첫 글자 사용) 중에서 고를 수 있습니다. 개별 프로젝트는 프로젝트 상세에서 이 설정을 덮어쓸 수 있습니다.
- Icon Collection(아이콘 세트)에서는 선택할 수 있는 아이콘을 정합니다. Show All(모두 보기), Enable All(모두 사용), Disable All(모두 사용 안 함), Random 50(무작위 50개), Refresh(새로 고침)를 사용할 수 있고, 아이콘을 클릭해 개별적으로 켜거나 끌 수도 있습니다.
GitHub

로컬 GitHub CLI(gh) 세션을 사용해 세션을 동기화하고 GitHub 데이터를 가져옵니다. 이 탭에는 연결 상태와 부여된 권한 범위가 표시되며, Refresh status(상태 새로 고침)와 Copy login command(로그인 명령 복사) 버튼이 있습니다. 토큰은 현재 페이지 세션 동안에만 메모리에 유지되며 로컬 스토리지에 저장되지 않습니다. gh에 아직 로그인하지 않았다면 탭에 표시된 Local gh setup(로컬 gh 설정 단계)을 따라 주세요.
Git

- Git Profiles에는 Super Commit에 사용할 수 있는 작성자 정보를 저장합니다. Super Commit을 시작하기 전에 최소 하나를 만들어 두면, prompt에 항상 명확한 작성자가 적힙니다.
- Automatically refresh and monitor Git status(Git 상태 자동 새로 고침 및 모니터링)는 활성 프로젝트를 주기적으로 확인합니다. 특히 Windows를 사용하거나 저장소가 많으면 디스크 활동이 늘어날 수 있습니다. Maximum monitored Git repositories(모니터링할 최대 Git 저장소 수)는 동시에 감시할 저장소 수를 제한합니다(기본값 15).
- Super Commit default behavior(Super Commit 버튼 기본 동작)는 주 Super Commit 버튼의 동작을 정합니다. Open confirmation panel(확인 패널 열기)로 먼저 확인하거나, 저장된 Profile과 기본값으로 Commit immediately(즉시 커밋)합니다. 그 밖의 옵션은 커밋 후 기본적으로 push할지 rebase할지를 설정합니다.
Code Server

해석된 Code Server 구성(호스트, 포트, 인증 모드, 출처)과 최신 실행 시점 스냅샷을 읽기 전용으로 보여 줍니다. 이 탭에서는 Code Server 설정을 편집할 수 없습니다.
OmniRoute

공유 OmniRoute 통합을 켭니다. API endpoint와 선택 사항인 API key(API 키)를 입력하고, Test connection(연결 테스트)을 실행한 다음, 어떤 Agent CLI가 OmniRoute 모델 카탈로그를 사용할지 선택합니다. 오른쪽에는 실행 상태와 캐시된 모델 카탈로그가 표시됩니다. 통합을 끄면 모델 관리는 처음 설정된 시스템 기본값으로 돌아갑니다. 설치 방법은 OmniRoute를 참고하세요.
Lifestyle and wellbeing(생활과 건강)
Achievements(업적)

상태 표시줄의 일일 업적 진행률 팝업을 켜거나 끕니다. 이 설정과 관계없이 전역 마일스톤 알림과 데이터 동기화는 계속 사용됩니다. 상태 표시줄 및 진행 상황을 참고하세요.
Break Reminder(휴식 알림)

물을 마시거나 스트레칭을 하거나 일어나서 움직이라고 알려 주는 타이머입니다. 이전 알림과 다음 알림 시각, 오늘의 반복 횟수를 보여 주며, Basic(기본 스타일) 같은 알림 테마를 선택할 수 있습니다. 알림은 상태 표시줄에 표시됩니다.
Salary Tracker(시급 계산기)

분 단위로 수입을 계산해 보여 주는 재미있는 카운터입니다. Daily salary(일급)와 Work hours per day(하루 근무 시간)를 입력합니다. 분당 수입은 일급을 (근무 시간 × 60)으로 나눈 값입니다. 일급을 0으로 두면 계산이 꺼집니다. 이모지 20개 중에서 단위 이모지를 고르고, 상태 표시줄에 이 표시를 보일지 선택할 수 있습니다.
System(시스템)
Data Management(데이터 관리)

현재 아카이브와 데이터 폴더(아카이브 루트, 구성 디렉터리, 데이터 디렉터리)를 표시합니다. Save Catalog(아카이브 목록)에서는 아카이브를 나열하고, 준비된 아카이브를 안전하게 활성화할 수 있습니다. Workspace(작업 영역) 전환기로 Primary Database(기본 데이터베이스), Message Database(메시지 데이터베이스), Image Storage(이미지 저장소) 도구 사이를 이동할 수 있습니다. Data Cleanup(데이터 정리)은 데이터베이스 정보를 보여 주고, 보관된 세션의 메시지 데이터를 정리해 저장 공간을 확보합니다.
Debug(디버그)

개발 빌드용 도구입니다.
- SignalR Log(SignalR 로그)는 SignalR 이벤트와 메시지를 콘솔에 실시간으로 출력합니다.
- HagiPower Adjustment(HagiPower 조정)는 개발 환경에서 공유 공용 풀을 직접 편집합니다. 정상 운영 환경의 계산은 바뀌지 않습니다.
- Enable DLC(DLC 활성화)는 백엔드 구성을 통해 TurboEngine DLC를 명시적으로 켜거나 끕니다. 로컬 개발 환경에는 내부 활성화 스위치가 없기 때문입니다.
일반적으로 사용할 때는 이 탭이 필요하지 않습니다.
Danger Zone(위험 영역)

Reset system data(시스템 데이터 초기화)는 영구 상태를 초기화하고, 현재 아카이브의 기본 데이터베이스 레코드와 메시지 샤드를 삭제합니다. 이미지, 플러그인, 저장소, 다른 아카이브는 영향을 받지 않습니다. 앱은 계속 실행되며, 이후에는 재시작하는 것을 권장합니다. 이 작업은 되돌릴 수 없습니다.
외관, 테마 및 언어
상단 바의 두 버튼을 사용하면 설정을 열지 않고도 HagiCode의 외관을 바꿀 수 있습니다.

Theme(테마)을 누르면 테마 선택기(Choose theme, 테마 선택)가 열립니다. 각 테마 계열에는 Light(라이트)와 Dark(다크) 두 가지 변형이 있으며, 선택하면 즉시 적용됩니다. 계열에는 Standard(표준), Spring(봄), Summer(여름), Vacation(방학), Autumn(가을), Winter(겨울), Lunar New Year(설날), Soccer(축구), Cyberpunk(사이버펑크), School(학교), Space Travel(우주 여행)이 있습니다. Auto-switch(자동 전환)는 1분에서 240분 사이의 고정 간격으로 라이트 테마와 다크 테마를 번갈아 적용합니다.

Language(언어)를 누르면 언어 대화상자(Select Language, 언어 선택)가 열립니다. 언어를 하나 선택하고 Confirm(확인)을 클릭하세요. HagiCode는 English, 简体中文, 繁體中文, 日本語, 한국어, Deutsch, Français, Español, Português (Brasil), Русский를 지원합니다.
HagiCode
HagiCode는 에이전트 코딩 작업 공간입니다. 풍부하고 편리한 UI 상호작용으로 계획 수립, 에이전트 실행, 프로젝트 작업을 쉽게 시작하고 따라가며 개발을 더 흥미로운 경험으로 만듭니다.
풍부하고 편리한 UI 상호작용으로 계획부터 프로젝트 작업까지 쉽게 따라갈 수 있습니다.
- 스마트OpenSpec 워크플로는 의도를 제안, 설계, 작업을 거쳐 배포까지 이어지는 실행 가능한 경로로 바꿉니다.
- 효율적다중 에이전트 실행으로 조사, 구현, 검토를 병렬로 진행하며 여러 저장소와 익숙한 Agent CLI를 지원합니다.
- 흥미로운풍부하고 편리한 UI 상호작용으로 계획 수립, 에이전트 실행, 프로젝트 작업을 쉽게 시작하고 따라갈 수 있습니다.
Windows용 다운로드
HagiCode 공유
아이디어를 실제로 배포되는 소프트웨어로.
HagiCode는 에이전트 코딩 작업 공간입니다. OpenSpec 워크플로로 변경을 계획하고, 다중 에이전트 실행으로 진행하며, Hero Scenario로 긴 작업의 진행 상황을 한눈에 보여 아이디어를 실제로 배포되는 소프트웨어로 만듭니다.
- 스마트
- OpenSpec 워크플로는 의도를 제안부터 배포까지 이어지는 실행 가능한 경로로 바꿉니다.
- 효율적
- 다중 에이전트 실행으로 조사, 구현, 검토를 병렬로 진행합니다.
- 즐거운
- 편리한 UI 상호작용으로 계획, 에이전트 실행, 프로젝트 작업을 쉽게 따라갈 수 있습니다.
© 2026 HagiCode | Powered By hagilight-starlight@0.21.0 | Branch: main | Commit: 3d2bbd9 | Built:

