# はじめかた

サインインして、最初のキーを預けて、AI エージェントに渡すところまでを通しで説明します。5 分ほどで終わります。

## サインインする

[app.aikagi.dev](https://app.aikagi.dev) を開いて、Google アカウントで入ります。aikagi 専用のパスワードはありません。

だれかのワークスペースに招かれている方は、招かれたメールアドレスの Google アカウントでそのまま入れます。招待の心当たりがない場合は、招いた人に「どのメールアドレスで招いたか」を確かめてください。

はじめて入ると「あと 3 ステップで使えます」という画面が出ます。あとで読み返せるので、閉じてしまっても大丈夫です。

## 置き場所を決める

キーの置き場所は 2 とおりです。

- **パーソナル**。自分だけの保管庫です。ほかの人を招くことはできません。
- **ワークスペース**。チームで使う場所です。中はプロジェクトに分かれ、プロジェクトは開発・検証・本番の環境に分かれます。

ひとりで始めるなら、まずはパーソナルで十分です。チームに配る段になってから、ワークスペースへ移せます。詳しくは[ワークスペースと環境](https://aikagi.dev/guide/workspaces.md)を読んでください。

## 最初のキーを預ける

画面の左のメニューから置き場所を選ぶと、キーの一覧が出ます。表の最終行がそのまま入力欄になっているので、名前と値を打って Enter を押せば 1 行増えます。

![キーの一覧。名前と値の 2 列が並び、値は伏せ字になっている](https://aikagi.dev/guide/img/keys.webp)

*キーの一覧。最終行に名前と値を打つと、その場で 1 行増えます。*

名前は英字ではじめ、英数字と `_` `-` が使えます。値は預けたあとは伏せ字になり、押したときだけ表示されます。

## 手元に道具を入れる

ここから先はターミナルです。次の 1 行で `aikagi` が `~/.local/bin` に入ります。

```sh
curl -fsSL https://aikagi.dev/install.sh | sh
```

入ったら、この端末をあなたのアカウントに結びつけます。ブラウザが開いて、承認の画面が 1 枚出ます。

```sh
aikagi login
```

続けて、いま居るリポジトリをどのプロジェクトに結びつけるかを決めます。対話で聞かれるとおりに答えると `.aikagi.toml` が 1 つできます。このファイルに秘密は入らないので、そのままリポジトリに入れて構いません。

```sh
aikagi init
```

## AI エージェントに渡す

最後に、いつも使っているコマンドを aikagi 経由にします。

```sh
aikagi hook install
```

あとは、これまでどおり起動するだけです。

```sh
cd repo && claude
```

aikagi がそのリポジトリの設定を読み、あなたが読めるキーを環境変数にして本物の `claude` を起動します。ファイルは作りません。しくみは[AI エージェントとの接続](https://aikagi.dev/guide/agents.md)にあります。

## うまくいかないとき

手元の状態はこれ 1 つで見られます。資格情報の出所、PATH の並び、シェルの設定、サーバへ届くかどうかをまとめて調べて、直し方を 1 行ずつ出します。

```sh
aikagi doctor
```

---

出典: https://aikagi.dev/guide/start/