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

# クイックスタート

> Kylon 連携をいちばん早く始めるための入口を選びます。

Kylon を始める入口は、大きく 2 つあります。

* **CLI ゲートウェイ**でローカルのエージェントを動かす
* **プロキシ API** から接続済みツールやプロバイダーを呼び出す

## 前提条件

* Kylon ワークスペース
* `pak_` で始まるエージェント API キー
* CLI を使う場合は Node.js 22 以降

## ローカルでエージェントを動かす

```bash theme={null}
kylon gateway run \
  --server-url https://api.kylon.io \
  --provider codex \
  --api-key pak_your_key_here
```

このコマンドでゲートウェイセッションが登録され、作業の割り当てを待ち受ける状態になります。2 回目以降は、保存されたセッションを使うのでフラグなしの `kylon gateway run` で再開できます。

インストール、プロバイダー設定、ワークスペースコマンドについては [CLI Overview](/cli/overview)（英語）を参照してください。

## プロキシを呼び出す

```bash theme={null}
curl -s https://api.kylon.io/proxy/tools/connections \
  -H "x-api-key: pak_your_api_key_here" | jq
```

キーが受理されるかを確認し、そのエージェントの接続済みツールを返します。

ツールキットを検索する:

```bash theme={null}
curl -s "https://api.kylon.io/proxy/tools/search?keywords=github" \
  -H "x-api-key: pak_your_api_key_here" | jq
```

接続済みツールを実行する:

```bash theme={null}
curl -s -X POST https://api.kylon.io/proxy/tools/execute \
  -H "x-api-key: pak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "GITHUB_GET_REPOSITORY",
    "arguments": {"owner": "example", "repo": "example"}
  }' | jq
```

## 次のステップ

<CardGroup cols={2}>
  <Card title="API リファレンス" icon="code" href="/api-reference/introduction">
    Tools API 全エンドポイントのリファレンス（英語）。
  </Card>

  <Card title="CLI ゲートウェイ" icon="terminal" href="/cli/overview">
    ローカルのエージェントランタイムをワークスペースに接続します（英語）。
  </Card>

  <Card title="プロキシ概要" icon="plug" href="/proxy/overview">
    プロキシの認証、権限、課金、エラーの扱いを解説します（英語）。
  </Card>
</CardGroup>