はじめかた

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

サインインする

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

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

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

置き場所を決める

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

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

ひとりで始めるなら、まずはパーソナルで十分です。チームに配る段になってから、ワークスペースへ移せます。詳しくはワークスペースと環境を読んでください。

最初のキーを預ける

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

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

手元に道具を入れる

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

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

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

aikagi login

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

aikagi init

AI エージェントに渡す

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

aikagi hook install

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

cd repo && claude

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

うまくいかないとき

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

aikagi doctor