AmpCode 食用指南：搭配 CLIProxyAPI 实现自定义模型自由

今天提到的 AmpCode 可能国内很少有人听过（大概是因为没有“白嫖”渠道？）。其实 AmpCode 凭借其独特的理念在 AI 编程领域已占有一席之地。它最核心的特点是“效率优先，成本次之”——用户无需关心模型选择，系统会自动调用当前最佳的模型来完成工作。因此，AmpCode 原生并不支持模型切换，更不用说使用第三方模型了。

AmpCode 主要有两种模式：

• Free 模式： 免费使用 Claude Haiku 4.5 模型，代价是包含广告（这可能是目前唯一带广告的 Agent 工具？）。
• Smart 模式： 自动选用当下最强的模型组合。在这个时间节点（2025年12月），Smart 模式通常会调用 Claude Opus 4.5 处理复杂任务，Claude Haiku 4.5 负责高频简单响应，并由 GPT 5.1 作为 SubAgent 进行多维度的逻辑补全。

这篇文章将教大家如何搭配 AmpCode + CLIProxyAPI，实现“在 AmpCode 中使用自己模型”的目标。

1. 配置 CLIProxyAPI

首先我们需要一个配置好的 CLIProxyAPI。具体的部署方法可以参考我之前的 CLIProxyAPI 系列教程，这里不再赘述。

常规配置完 CLIProxyAPI 之后，我们需要在配置文件中加入以下 AmpCode 相关的设置：

1
2
3
4
5
6
7
8
9
10
11

ampcode:
  upstream-url: "https://ampcode.com"
  restrict-management-to-localhost: false
  upstream-api-key: "sgamp_user_XXXX"
  model-mappings:
    - from: claude-opus-4-5-20251101
      to: gemini-claude-sonnet-4-5
    - from: claude-sonnet-4-5-20250929
      to: gemini-claude-sonnet-4-5
    - from: claude-haiku-4-5-20251001
      to: qwen3-coder-flash

配置项说明：

• upstream-url, restrict-management-to-localhost, upstream-api-key： 如果你拥有 AmpCode 账号，并希望在官网后台查看会话信息，请填入这三项。其中 upstream-api-key 可以在 AmpCode 后台复制（如下图）。如果你没有 AmpCode 账号，直接删除这三行即可。

• model-mappings （重点敲黑板！）： 这是配置中最关键的部分。我们需要理解 CLIProxyAPI 的处理逻辑： 当 AmpCode 请求某个特定模型（例如 claude-opus-4-5-20251101）时，CLIProxyAPI 会优先在已注册的模型列表中查找。
  • 情况 A： 如果该模型存在，直接请求该模型（model-mappings 不生效）。
  • 情况 B： 如果该模型不存在，CLIProxyAPI 本该报错，但通过配置 model-mappings，我们可以将请求重定向到我们指定的模型（例如 gemini-claude-sonnet-4-5）。

举个栗子帮助理解：

假设 AmpCode 请求 claude-opus-4-5-20251101，如果在 CLIProxyAPI 里有这个模型，那么 AmpCode 就会使用 CLIProxyAPI 中的 claude-opus-4-5-20251101 模型； 如果 CLIProxyAPI 里并没有配置这个模型，系统就会触发 model-mappings 规则，把请求转交给 gemini-claude-sonnet-4-5 来响应。 通过以上规则，我们就成功实现了“移花接木”，用自己的模型接管了 AmpCode 的请求。

（如果对这个逻辑还有疑问，建议把上面这段话多读几遍~）

完成以上配置，CLIProxyAPI 这一侧就算准备就绪了。

2. 安装与配置 AmpCode

AmpCode 支持多平台，以下以在 WSL2 Debian 中安装 Amp CLI 为例供大家参考。

复制官方提供的安装脚本进行安装： curl -fsSL https://ampcode.com/install.sh | bash

注意： 安装完成后先不要运行，我们需要编辑环境变量。 输入 nano ~/.bashrc，在文件最底部添加如下内容：

1
2

export AMP_URL="http://你的CPA部署地址:端口"
export AMP_API_KEY="你在CPA中设定的api-keys"

保存并退出后，运行 source ~/.bashrc 使配置生效。

3. 验证结果

现在，输入 amp 并尝试发送一段提示词，如果一切顺利，你将看到如下界面：

同时，在 CLIProxyAPI 的后台日志中，我们也能清晰地看到对应的请求已被成功转发：

大功告成！