给 Amp 配置自定义 API：CLIProxyAPI 接入教程

把 Amp 的请求转发到 CLIProxyAPI，由本地已登录的 Codex / Claude / Gemini 订阅承接，绕开 Amp 的 token 计费。

整体链路

Amp CLI / Amp IDE 插件
   │  AMP_URL=http://localhost:8317
   ▼
CLIProxyAPI
   ├─ 模型请求   ─► 本地登录的 Codex / Claude / Gemini
   └─ 登录/账户   ─► ampcode.com (反代)

CLIProxyAPI 给 Amp 单开了一组路由 /api/provider/{provider}/v1/... 处理模型请求，另外用反向代理把 /api/auth、/api/user 等控制面请求转发回 ampcode.com。

准备工作

需要先准备好以下三项：

• CLIProxyAPI 已安装并能正常启动（默认监听 8317）
• CLIProxyAPI 已登录至少一个上游账号（Codex / Claude Code / Gemini CLI）
• Amp CLI 已安装

1. 获取 Amp Access Token

打开 https://ampcode.com/settings，找到 Access Token 区块，点击 Copy Token。

这一步获取的是 Amp Access Token，用于 CLIProxyAPI 反代 Amp 控制面。与下面 CLIProxyAPI 自己的 api-keys 是两个不同的 key，不要混用。

2. 修改 CLIProxyAPI 配置

打开 config.yaml，添加或修改 ampcode: 段：

ampcode:
  upstream-url: "https://ampcode.com"
  # 第 1 步复制的 Amp Access Token
  upstream-api-key: "ampcode-apikey"
  restrict-management-to-localhost: false
  force-model-mappings: true
  model-mappings:
    - from: "claude-opus-4-7"
      to: "gpt-5.5"
    - from: "claude-opus-4-6"
      to: "gpt-5.5"
    - from: "claude-opus-4-5-20251101"
      to: "gpt-5.5"
    - from: "claude-sonnet-4-5-20250929"
      to: "gpt-5.5"
    - from: "claude-haiku-4-5-20251001"
      to: "gpt-5.5"
    - from: "gpt-5.4"
      to: "gpt-5.5"

字段说明：

字段	作用
upstream-url	Amp 控制面地址，固定为 https://ampcode.com
upstream-api-key	Amp Access Token
restrict-management-to-localhost	管理路由是否只允许本机访问，本地使用设 false
force-model-mappings	是否强制走映射表，见下节
model-mappings	模型重定向规则

保存后重启 CLIProxyAPI。

3. model-mappings 工作机制

Amp CLI 请求的模型名（如 claude-opus-4-7）未必与本地登录账号提供的型号一致。CLIProxyAPI 的处理逻辑：

• 本地有同名模型：直接用本地模型，model-mappings 不生效
• 本地无同名模型：报错；若映射表中配置了替身，则改请求替身模型
• force-model-mappings: true：无论本地是否有同名模型，都先走映射表

上面的配置开启了 force-model-mappings，将所有 Amp 请求统一映射到 gpt-5.5。

4. 配置环境变量

export AMP_URL=http://localhost:8317
export AMP_API_KEY=123456

AMP_API_KEY 的值必须与 CLIProxyAPI 配置顶部 api-keys 中的某一项匹配，不是 Amp 网站的 Access Token。

5. 启动 Amp

amp

发送一条消息，观察 CLIProxyAPI 日志：

• 请求路径包含 /api/provider/...
• 模型名按映射表改写
• 上游返回 200

以上三点都满足即接入成功。

6. IDE 插件接入

VS Code / Cursor / Windsurf 等编辑器需要在 settings.json 中追加：

{
  "amp.url": "http://localhost:8317",
  "amp.apiKey": "123456"
}

CLI 与 IDE 插件的配置互不继承，需各自设置。

7. AmpCode system-prompt

接了proxy之后顺便提取了 ampcode 的 system-prompt 可以参考学习

https://gist.github.com/cexll/dee771f91dc08a342ffff91421c2b557

常见问题

amp login 返回 401

CLIProxyAPI v6.6.15 - v6.6.17 存在 bug：/auth/* 路由被错误地套上 API key 鉴权（issue #554）。升级到更新版本或回退到 v6.6.14。

force-model-mappings: true 不生效

检查 from 字段拼写。Amp 的模型版本号更新较频繁，特别是带日期戳的名字。查看 CLIProxyAPI 日志中实际收到的模型字符串，照实抄入映射表。

Amp 已登录但聊天超时

检查两点：upstream-url 是否正确；Amp Access Token 是否仍有效（可能被 revoke 过）。后者到 https://ampcode.com/settings 重新生成。

模型映射后报上游模型不存在

to 字段必须是 CLIProxyAPI 本地实际可用的模型别名。通过 CLIProxyAPI 自身的 /v1/models 接口确认本地模型列表。

注意事项

本方案将订阅型 CLI 的额度转发给非预期客户端使用，是否符合各家服务的 ToS 需自行评估。建议仅用于个人本地开发，不建议用于团队、对外服务或商业产品。

---

参考：

• CLIProxyAPI 仓库：https://github.com/router-for-me/CLIProxyAPI
• Amp CLI 文档：https://help.router-for.me/agent-client/amp-cli
• AmpCode 完整教程：https://help.router-for.me/hands-on/tutorial-12
• Amp 官方手册：https://ampcode.com/manual