워크벤치 개요

이 섹션은 HagiCode 워크벤치의 사용 설명서로, 인터페이스 모듈별로 하나씩 설명합니다. 현재 사용 중인 기능에 해당하는 페이지를 바로 열어 보셔도 됩니다.

워크벤치 한눈에 보기

워크벤치는 기본적으로 세션 보드를 엽니다. 아래 그림은 orbit-notes라는 작은 데모 프로젝트를 사용하며, 이 프로젝트에는 완료된 세션이 하나 있습니다.

인터페이스는 다섯 개 영역으로 나뉩니다:

영역	위치	용도	가이드
상단 바（Header）	상단 가장자리	워크스페이스 단위 모듈을 엽니다: Agents, Wizard, Skills, HagiTask, Vault, 설정, 언어, 테마, 프로필	상단 바
프로젝트 레일（Project rail）	왼쪽 가장자리	전체 프로젝트와 개별 프로젝트 사이를 전환하고 새 프로젝트를 만듭니다	프로젝트
세션 보드（Session board）	가운데	레인으로 세션을 보여 주고 새 세션 버튼을 제공합니다	세션
프로젝트 패널（Project panel）	오른쪽	선택한 프로젝트의 빠른 작업과 저장소 상태를 보여 줍니다	프로젝트
상태 바（Status bar）	하단 가장자리	팁, Agent CLI 상태, 실행 중인 세션, 휴식 알림, 일당 카운터, 빌드 버전을 보여 줍니다	상태 바와 진행 상황

상단 바

상단 바는 항상 표시됩니다. 여기의 버튼은 현재 페이지 위에 드로어나 대화상자를 열기 때문에 보드에서 보던 위치를 잃지 않습니다.

버튼	열리는 내용
Agents（한국어 인터페이스: Agents）	Agents 워크벤치: 내 Agent, 실행 시나리오, AgentCLI 목록, 모델 카탈로그, 문구 테마, 아바타 갤러리. Agents를 참고하세요.
Wizard（마법사）	4단계 초기화 마법사. 첫 실행을 참고하세요.
Refresh（새로고침）	현재 페이지의 내용을 다시 불러옵니다.
Skills（스킬）	Local Skills, Gallery, Trusted Providers를 포함한 통합 스킬 모듈. 스킬과 HagiTask를 참고하세요.
HagiTask（한국어 인터페이스: HagiTask）	작업 프리셋을 관리하는 HagiTask 관리 화면. 스킬과 HagiTask를 참고하세요.
Vault（한국어 인터페이스: Vault）	HagiCode가 탐색하고 미리 볼 수 있는 폴더를 관리하는 Vault 관리자. Vault를 참고하세요.
Get Support（기술 지원 받기）	브라우저에서 커뮤니티 및 지원 페이지를 엽니다.
Language（언어）	인터페이스 언어를 전환합니다. HagiCode는 简体中文을 포함해 열 가지 인터페이스 언어를 제공합니다.
Theme（테마, 잎 아이콘）	테마 선택기를 엽니다. 외관, 테마 및 언어를 참고하세요.
Settings（설정, 톱니바퀴 아이콘; 열리는 대화상자 제목은 “설정”）	설정 대화상자를 엽니다. 설정을 참고하세요.
Profile（프로필, 원형 아바타）	포인트, 기록 타임라인, 빠른 진입점이 있는 프로필 드로어를 엽니다. 상태 바와 진행 상황을 참고하세요.

첫 실행: 초기화 마법사

새로 설치하면 Initialization wizard（초기화 마법사）가 자동으로 열립니다. 언제든지 상단 바의 Wizard 버튼으로 다시 열 수 있습니다. 마법사는 총 네 단계이며, 필수 세 단계 중 준비가 끝난 항목 수를 표시합니다.

1. Language & theme（언어와 테마） – 인터페이스 언어와 계절별 색상 테마를 선택합니다. 두 설정 모두 즉시 적용됩니다.
2. Hagicoder – 로컬 Agent CLI와 모델을 선택하고, 첫 Agent를 만든 뒤 Fallback Crew（대체 팀）에 추가합니다. 연결 테스트를 권장하지만 필수는 아닙니다.
3. Project（프로젝트） – 첫 프로젝트의 폴더를 등록합니다.
4. Community（커뮤니티）（선택 사항） – 첫 대화를 시작하거나 “정보” 페이지를 엽니다.

전체 과정과 각 필드의 의미는 초기화 마법사 설정을 참고하세요.

다음으로 가볼 곳

프로젝트새 프로젝트를 만들고, 상세 정보, MonoSpecs, 표준 용어, Git 상태를 확인합니다.

세션새 아이디어와 대화를 시작하고, 보드를 읽고, 세션 안에서 작업합니다.

AgentsAgent를 만들고, 실행 시나리오에 배정하고, AgentCLI 상태를 확인합니다.

스킬과 HagiTask갤러리에서 스킬과 작업 프리셋을 설치합니다.

Vault세션이 읽고 쓸 수 있는 폴더를 등록합니다.

설정알림부터 Git과 OmniRoute까지 모든 설정을 그룹별로 설명합니다.

상태 바와 진행 상황Agent CLI 상태, 동시 실행, 업적, 휴식 알림, 일당 카운터를 확인합니다.