# Amp

來源: https://docs.aicentos.com/zh-TW/clients/amp

Language: zh-TW

> 在 Amp 中使用 aicentos —— 透過設定檔覆蓋後端位址

Amp 是 Sourcegraph 推出的編碼代理，CLI 與 IDE 擴充套件共用同一套帳號與設定。它沒有常見的「OpenAI 相容 Base URL」輸入框，而是透過 `amp.url` 設定項把整個後端指向自訂端點，憑證另外存放在 secrets 檔案裡。

## 準備工作

先在控制台「API Key」頁面為 Amp 建立一個專用 Key（建議命名 `amp-cli`，方便追蹤用量）：

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 餘額不足時儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

## 需要填寫的設定

| 欄位       | 值                         |
| -------- | ------------------------- |
| API Key  | 控制台建立的 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"
```

**注意：** 一旦設定了這兩個變數，Amp 會跳過登入流程，優先順序高於設定檔。

## 測試

先發一條輕量請求，確認端點已經切過去：

```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/zh-TW/api/chat/claude)）與 OpenAI 相容介面（見 [Chat Completions](https://docs.aicentos.com/zh-TW/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)