> ## 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.

# 最初のエージェント

> 普段の terminal から agent を起動し、managed-session guarantee が必要な場面を選びます。

## 必要なもの

* Apple Silicon Mac
* インストールとログインを済ませた対応コーディングエージェントCLI
* worktreeベースのエージェントで使うGitリポジトリ

未インストールの場合は先に [Dure をインストール](/jp/install)してください。

<Warning>
  Dureはalphaソフトウェアです。現在の公開ビルドは未署名で、製品名をDureへ
  移行している間、公開artifactには従来の`Hebbian`アプリidentityが残っています。
</Warning>

## 初回起動：最近の作業から始める

DureはこのMacと接続可能なSSHホストから最近のproviderネイティブ会話を検出し、
リポジトリごとのデスクトップとpane配置を提案します。読み取り専用の提案を
確認し、デスクトップの名前変更や統合、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は次のパスとbranchを作成または再利用します。

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

管理paneはそのworktreeから起動します。別のエージェントとGit indexや作業
ファイルを共有しません。

## 6. セッション保証を確認する

promptを送り、出力が始まってからDureを閉じ、もう一度開きます。管理された
ローカルエージェントは、新しいprovider processを起動せず、同じ実行中の
セッションと画面へ再接続するはずです。

<Tip>
  自動認識だけではworktree分離や管理セッションの生存は保証されません。
  必ず継続させたい作業は管理セッションへ変換するか、agent paneから起動します。
</Tip>

## 次に読む

* [セッション、snapshot、復旧の違い](/jp/session-model)
* [複数のエージェントを連携させる](/jp/orchestration)
* [Provider対応レベル](/jp/providers)
* [永続性とプラットフォームの現在の制約](/jp/current-limits)