# Amp

出典: https://docs.aicentos.com/ja/clients/amp

Language: ja

> Amp で aicentos を使う —— 設定ファイルによるバックエンドアドレスの上書き

Amp は Sourcegraph がリリースしたコーディングエージェントで、CLI と IDE 拡張は同じアカウントと設定を共有します。一般的な「OpenAI 互換 Base URL」の入力欄はなく、`amp.url` 設定項目でバックエンド全体をカスタムエンドポイントに向けます。資格情報は別途 secrets ファイルに保存されます。

## 準備

まずコンソールの「API キー」ページで、Amp 専用のキーを作成してください（名前は `amp-cli` のようにすると使用量の追跡に便利です）：

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[https://aicentos.com/keys](https://aicentos.com/keys)
* 残高不足のときのチャージ：[https://aicentos.com/wallet](https://aicentos.com/wallet)

## 設定値

| 項目       | 値                         |
| -------- | ------------------------- |
| API Key  | コンソールで作成したキー              |
| Base URL | `https://aicentos.com/v1` |
| モデル      | コンソール「モデル広場」のモデル名         |

## 設定手順

Amp の設定項目はすべて `amp.` 接頭辞を持ち、ユーザーレベルの設定ファイルは次の場所にあります：

* macOS / Linux：`~/.config/amp/settings.json`
* Windows：`%USERPROFILE%\.config\amp\settings.json`

先にディレクトリを作成し、バックエンドアドレスを書き込みます：

```bash
mkdir -p ~/.config/amp ~/.local/share/amp
```

```json
{
  "amp.url": "https://aicentos.com/v1"
}
```

API Key はこのファイルには書かず、secrets ファイルに別途保存します。キー名は `apiKey@<あなたの URL>` です：

```json
{
  "apiKey@https://aicentos.com/v1": "sk-あなたの-API-Key"
}
```

設定が有効になると、`amp login` を実行する必要はなく、リクエストは指定したエンドポイントを直接使います。以前にログインしていた場合は、先に `amp logout` でログアウトしてから `amp` を再起動することをおすすめします。残ったログイン状態が設定を上書きするのを避けるためです。

環境変数で一時的に上書きすることもでき、一回きりの検証に向いています：

```bash
export AMP_URL="https://aicentos.com/v1"
export AMP_API_KEY="sk-あなたの-API-Key"
```

**注意：** この 2 つの変数を設定すると、Amp はログインフローをスキップし、設定ファイルより優先されます。

## テスト

まず軽量なリクエストを 1 つ送り、エンドポイントが切り替わっていることを確認します：

```bash
amp -x "1+1 はいくつですか？一文で答えてください"
```

正常に返れば設定は有効です。401 が返る場合は、多くは secrets ファイルのキー名が `amp.url` と完全に一致していないためです（末尾に `/v1` が付くかどうかも含みます）。

## 注意事項

* Amp のバックエンドプロトコルは独自の管理インターフェースであり、汎用の OpenAI 互換プロトコルではありません。そのため `amp.url` は、Anthropic Messages（`/v1/messages`）スタイルのインターフェースも同時に提供するエンドポイントを指す必要があります。
* aicentos はネイティブ Claude 形式インターフェース（[ネイティブ Claude 形式](https://docs.aicentos.com/ja/api/chat/claude) を参照）と OpenAI 互換インターフェース（[Chat Completions](https://docs.aicentos.com/ja/api/chat/openai/chat-completions) を参照）を提供しています。Amp が使うのは前者です。
* Amp は固定のモデル ID をリクエストします。エンドポイント側に同じ名前のモデルがないと、フォールバックやエラーが発生します。その場合は、コンソール「モデル広場」を基準にモデル名を確認してください。
* IDE 拡張（VS Code / Cursor / Windsurf）の設定は CLI とは別に管理されており、Amp URL と Amp API Key を個別に入力する必要があります。
* ワークスペース内の `.amp/settings.json` はユーザーレベルの設定を上書きします。切り分けの際は、現在のディレクトリに同名ファイルがないか先に確認してください。

## 関連リンク

* 公式設定ドキュメント：[https://ampcode.com/docs/cli/settings](https://ampcode.com/docs/cli/settings)