aicentosAmp
在 Amp 中使用 aicentos —— 透過設定檔覆蓋後端位址
最後更新於:
Amp 是 Sourcegraph 推出的編碼代理，CLI 與 IDE 擴充套件共用同一套帳號與設定。它沒有常見的「OpenAI 相容 Base URL」輸入框，而是透過 amp.url 設定項把整個後端指向自訂端點，憑證另外存放在 secrets 檔案裡。
準備工作
先在控制台「API Key」頁面為 Amp 建立一個專用 Key（建議命名 amp-cli，方便追蹤用量）：
- 控制台：https://aicentos.com
- 建立 Key：https://aicentos.com/keys
- 餘額不足時儲值：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
先建好目錄，再寫入後端位址：
mkdir -p ~/.config/amp ~/.local/share/amp{
"amp.url": "https://aicentos.com/v1"
}API Key 不寫在這個檔案裡，而是單獨放在 secrets 檔案中，鍵名為 apiKey@<你的 URL>：
{
"apiKey@https://aicentos.com/v1": "sk-你的-API-Key"
}設定生效後，amp login 不再需要執行，請求會直接走你指定的端點。如果之前登入過，建議先 amp logout 登出再重新啟動 amp，避免殘留的登入狀態覆蓋設定。
也可以用環境變數臨時覆蓋，適合先做一次性驗證：
export AMP_URL="https://aicentos.com/v1"
export AMP_API_KEY="sk-你的-API-Key"注意： 一旦設定了這兩個變數，Amp 會跳過登入流程，優先順序高於設定檔。
測試
先發一條輕量請求，確認端點已經切過去：
amp -x "用一句話回答：1+1 等於幾"能正常返回表示設定生效。若返回 401，多半是 secrets 檔案裡的鍵名與 amp.url 不完全一致（包括末尾是否帶 /v1）。
注意事項
- Amp 的後端協定是它自己的管理介面，並非通用的 OpenAI 相容協定，因此
amp.url必須指向同時提供 Anthropic Messages（/v1/messages）風格介面的端點。 - aicentos 提供原生 Claude 格式介面（見 原生 Claude 格式）與 OpenAI 相容介面（見 Chat Completions）；Amp 走的是前者。
- Amp 會請求固定的模型 ID，如果端點側沒有同名模型，會出現回落或報錯。遇到這種情況，請以控制台「模型廣場」為準核對模型名稱。
- IDE 擴充套件（VS Code / Cursor / Windsurf）的設定與 CLI 分開維護，需要單獨填寫 Amp URL 與 Amp API Key。
- 工作區裡的
.amp/settings.json會覆蓋使用者層級設定；排查問題時先確認目前目錄下沒有同名檔案。