> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dureai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 첫 에이전트

> 평소 쓰던 터미널에서 에이전트를 시작하고 언제 관리형 세션 보장이 필요한지 선택합니다.

## 요구 사항

* Apple Silicon Mac
* 설치와 로그인을 마친 지원 대상 코딩 에이전트 CLI 하나 이상
* worktree 기반 에이전트에 사용할 Git 저장소

아직 설치하지 않았다면 먼저 [Dure 설치](/ko/install)를 진행한다.

<Warning>
  Dure는 alpha 소프트웨어다. 현재 공개 빌드는 서명되지 않았고, 제품명을
  Dure로 전환하는 동안 배포 파일에는 기존 `Hebbian` 앱 identity가 남아 있다.
</Warning>

## 첫 실행: 최근 작업에서 시작

Dure는 이 Mac과 연결 가능한 SSH host에서 최근 provider-native 대화를 찾아
repository별 desktop과 pane 배치 초안을 만든다. 읽기 전용 제안을 검토하면서
desktop 이름을 바꾸거나 합치고 pane을 옮긴 뒤, 원하는 workspace가 됐을 때만
확인한다.

<video autoPlay controls loop muted playsInline title="최근 로컬·SSH 코딩 에이전트 세션에서 시작하는 Dure 온보딩" className="w-full aspect-video rounded-xl" poster="/images/onboarding-walkthrough.png" src="https://mintcdn.com/hebbian/gBhXllKfo-gr_XE_/videos/onboarding-walkthrough.webm?fit=max&auto=format&n=gBhXllKfo-gr_XE_&q=85&s=ce727f944da53a954302b32161ff2e56" data-path="videos/onboarding-walkthrough.webm">
  브라우저가 내장 영상을 지원하지 않는다.
  <a href="/videos/onboarding-walkthrough.webm">온보딩 영상을 연다.</a>
</video>

## 1. 다운로드와 설치

[공개 릴리스 피드](https://github.com/hebbianai/hebbian-releases/releases/latest)에서
최신 disk image를 내려받고 앱을 `/Applications`로 옮긴 다음, quarantine
attribute를 한 번 제거한다.

```sh theme={"system"}
xattr -dr com.apple.quarantine /Applications/Hebbian.app
```

기존 설치 경로는 updater와 로컬 상태 호환성을 위해 유지된다. app bundle의
이름을 직접 바꾸지 않는다.

## 2. 에이전트 CLI 준비

먼저 Dure 밖에서 provider CLI를 설치하고 로그인한다. 예를 들어 login shell에서
`claude`, `codex` 또는 다른 지원 command가 정상적으로 시작되는지 확인한다.

Dure는 같은 login-shell 환경에서 설치된 provider를 감지한다. provider CLI를
대신 설치하거나 구독을 제공하지는 않는다.

## 3. 프로젝트 추가

Dure를 열고 Git 저장소가 있는 로컬 폴더를 추가한다. 프로젝트는 Spaces에
표시되고 새 agent pane의 작업 범위가 된다.

## 4. 평소처럼 터미널에서 시작

프로젝트의 일반 terminal pane을 열고 `claude`, `codex` 또는 지원 provider
command를 평소처럼 실행한다. Dure는 live process tree와 terminal 증거를 보고
provider와 활동을 자동 인식해 Spaces에 표시한다. 먼저 에이전트를 추가하거나
수동 등록할 필요가 없다.

## 5. 필요할 때 관리형으로 전환

worktree 격리와 세션 생존 보장이 필요하면 에이전트 추가 동작에서 provider를
고르고 서로 구분되는 이름을 붙인 뒤 worktree 격리를 켠다. 검토된 provider와
상태에서는 이미 인식된 terminal pane에 표시되는 관리형 전환 동작을 사용할 수도
있다. Dure는 다음 경로와 브랜치를 만들거나 재사용한다.

```text theme={"system"}
repo/.worktrees/<agent-name>
agent/<agent-name>
```

관리형 pane은 그 worktree에서 시작한다. 다른 에이전트와 Git index나 작업 파일을
공유하지 않는다.

## 6. 세션 보장 확인

프롬프트를 보내 출력이 나오는 동안 Dure를 닫았다가 다시 연다. 관리형 로컬
에이전트라면 새 provider process를 시작하는 대신 같은 실행 중 세션과 화면에
다시 붙어야 한다.

<Tip>
  자동 인식만으로 worktree 격리나 관리형 세션 생존이 보장되는 것은 아니다.
  반드시 살아남아야 하는 작업은 관리형으로 전환하거나 agent pane에서 시작한다.
</Tip>

## 다음 문서

* [세션·snapshot·복구의 차이](/ko/session-model)
* [여러 에이전트 조율하기](/ko/orchestration)
* [Provider 지원 수준](/ko/providers)
* [영속성과 플랫폼의 현재 한계](/ko/current-limits)