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

# アカウントとキー

> 各エンジンにサインインし、APIキーを追加し、モデルを選び、ほかのツールのセットアップを取り込みます。

## エンジンにサインインする

**管理 → エージェントとモデル**を開きます。エンジンごとに行があり、インストール済みか、サインイン済みか、どのプランかが表示されます。

* **インストール**：入っていないエンジンをインストールします。
* **サインイン**：エンジン自身のサインインを実行します。Claude Code、Codex、Kimi Codeではブラウザが開きます。Antigravityでは、ターミナルで`agy`を実行します。OpenCodeはサインインせずに無料のモデルで始まります。
* **使用**：新しい会話を始めるときのエンジンにします。インストールされていない行、サインインしていない行には表示されません。

エンジンはそれぞれ、サインイン情報を自身のファイルに保持します。Archetypeはそれを読みません。**アカウントを追加**で、同じエンジンの別のアカウント（仕事用と個人用など）を追加し、どちらを使うかを選べます。

ブラウザのないサーバでは、`claude setup-token`で得たトークンを、envファイルの`CLAUDE_CODE_OAUTH_TOKEN`としてClaude Codeに渡します。

## APIキー

Archetype自身のモデルは、あなたのAPIキーかChatGPTアカウントで動きます。OpenAIの行で**サインイン**を押すと、ブラウザに入力するコードが表示されます。

プロバイダの行で**キーを追加**を押すとキーを保存します。**別のキーを追加**でもう1つ追加でき、キーが拒否されたり上限に達したりすると、順に次のキーを試します。キーは`~/.config/archetype/env`に1行に1つずつ書きます。

```bash theme={null}
ANTHROPIC_API_KEY=…
OPENAI_API_KEY=…
GEMINI_API_KEY=…        # or GOOGLE_API_KEY, from Google AI Studio
OPENROUTER_API_KEY=…
```

* このファイルを読めるのはあなただけにします（`chmod 600`）。そうでないと、バックグラウンドサービスは起動しません。
* シェルですでに設定されている変数は、ファイルより優先されます。
* ファイルを変更すると、バックグラウンドサービスは2秒以内に読み込み直します。

GeminiはAPIキーでのみ使えます。Googleアカウントでのサインインは提供されなくなりました。

エージェントがほかの用途でキーを必要とするときは、入力内容が隠れる欄のあるカードで求めます。キーが会話に入ることはありません。キーは`~/.local/share/archetype/secrets/`に保管されます。

## モデルを選ぶ

> [tab] アプリ
>
> メッセージ入力欄の下のチップで、エンジンとそのモデル、推論の強さを選びます。[エンジン](https://docs.archetype.ing/ja/use/engines.md)を参照してください。

> [tab] ターミナル
>
> ```bash theme={null}
> /backend                     # choose what runs the conversation
> /backend engine:claude       # an engine, or a provider of Archetype's own models
> /model                       # choose a model with a key
> /model NAME
> ```
>
> 起動時には、`archetype --backend claude`、`--provider anthropic`、`--model NAME`を使います。`archetype --list-models`でモデルの一覧を表示します。

切り替えたあとも、会話はそのまま続きます。デフォルトの`provider`と`model`はユーザ設定に書きます。プロジェクトの設定では指定できません。

**プロファイル**は、まとめて適用する設定を保持します。対象は、エンジン、モデル、推論の強さ、権限モード、トークンマキシングです。**管理 → プロファイル**で現在の設定を保存し、ステータスバーか`/profile NAME`で切り替えます。

## ほかのツールのセットアップを取り込む

初回起動時には**セットアップを取り込む**が表示されます。あとからは**管理 → 環境を読み込む**を使います。Archetypeがこのコンピュータにあるものを見つけ、何を取り込むかをあなたが選びます。

| 取り込み元 | 取り込まれるもの |
| - | - |
| Claude Code、Codex、Hermes、Cline、OpenCode、Goose、Aider | 指示、スキル、MCPサーバ |

* 指示は、ツールごとの名前の下に、書かれたとおりの内容で`AGENTS.md`の末尾に追加されます。要約はしません。
* MCPサーバが必要とするキーは、設定ファイルではなくenvファイルに入ります。
* 取り込まれないもの：モデルとプロバイダ、APIキー、サインイン情報、権限、フック、履歴。Archetypeで改めてサインインしてください。
* 探している間は何も実行されません。取り込んだMCPサーバは、**今すぐ適用**を押すと起動します。

このフォルダのClaude Codeの会話を続けるには、会話で`/import`と入力します。コピーから新しいセッションとして続きます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.