# Cline

Source: https://docs.aiand.com/ja/integrations/cline/

[Cline](https://github.com/cline/cline) は、ターミナルで動作する AI
コーディングエージェントです。ai& は組み込み provider として含まれ、id は
`aiand`、base URL は `https://api.aiand.com/v1` です。

<Aside type="note">
  リポジトリ作業には `moonshotai/kimi-k3` から始めてください。より安価なループには
  `deepseek-ai/deepseek-v4-flash` を使います。Cline はコンテキスト長、ツール対応、
  prompt cache の価格を[モデルカタログ](/ja/models/catalog/)から読むため、
  これらの値を手入力する必要はありません。
</Aside>

## 1. CLI をインストール

```bash
npm install -g cline
```

## 2. API キーを設定

[ai& console](https://console.aiand.com/api-keys) でキーを作成し、shell
に設定します:

<Tabs syncKey="os">
<TabItem label="macOS / Linux">

```bash
export AIAND_API_KEY="sk-your-aiand-api-key"
```

</TabItem>
<TabItem label="Windows (PowerShell)">

```powershell
$env:AIAND_API_KEY = "sk-your-aiand-api-key"
```

</TabItem>
</Tabs>

## 3. ai& を選ぶ

provider とモデルを保存します。API キーは Cline のローカル設定に書き込まれます:

```bash
cline auth --provider aiand --apikey "$AIAND_API_KEY" --modelid moonshotai/kimi-k3
```

モデル id はカタログの id です。例: `moonshotai/kimi-k3`。`aiand/` は付けません。

保存するモデルを変える場合:

```bash
cline auth --provider aiand --apikey "$AIAND_API_KEY" --modelid deepseek-ai/deepseek-v4-flash
```

## 4. Cline を実行

保存した provider でタスクを始めます:

```bash
cline "inspect this repository and fix the failing test"
```

prompt を渡すと act mode で起動し、ツールは自動承認されます。1 回だけモデルを変える場合:

```bash
cline -P aiand -m moonshotai/kimi-k3 "reply with only: ok"
```

`AIAND_API_KEY` が設定されていれば、この one-shot の前に `cline auth` は不要です。

## 動作確認

```bash
cline "reply with only: ok"
```

Cline はそのターンのトークン数を表示します。モデルが prompt cache に対応している場合は、キャッシュされた入力トークンも含まれます。

## トラブルシューティング

- **Unauthorized request** — 同じ shell に `AIAND_API_KEY` を設定するか、[ai& console](https://console.aiand.com/api-keys) のキーで `cline auth` をやり直してください。
- **Model not found** — [モデルカタログ](/ja/models/catalog/)の id を使ってください。`aiand/` は付けません。
- **返答はあるがファイルを編集しない** — `moonshotai/kimi-k3` や `deepseek-ai/deepseek-v4-flash` のように、ツール呼び出しに対応したモデルを選んでください。
