在 Claude 应用中设置 Adapty CLI

Adapty 开发者 CLI 可以在 Claude 应用中使用，让你直接通过对话窗口管理 Adapty 账户，而无需打开终端。Claude 在沙盒环境中运行命令，该环境只能访问白名单域名，因此在首次登录账户之前，需要在 Claude 中完成一次性配置。

所需条件：

• Claude 应用
• Adapty 账户
• 对于企业版 Claude 工作区，需要工作区管理员的协助——请参阅允许 Adapty 域名

添加 Adapty 插件

Adapty 插件包含 Claude 用于安装、鉴权和驱动 CLI 的技能，其中包括用于广告管理工作的 Apple Ads 技能。

添加插件的步骤：

1. 在 Claude 中，打开 Settings → Plugins。
2. 点击 Add → Add marketplace。
3. 选择 Add from a repository。
4. 在 URL 字段中，粘贴 https://github.com/adaptyteam/apple-ads-cli。
5. 点击 Sync。

Adapty 插件会显示在插件目录的 Personal 下。

将 Adapty 域名加入允许列表

在沙盒的域名允许列表中添加 Adapty 之前，CLI 无法登录或读取你的账户信息。

请同时允许 adapty.io 和 *.adapty.io。在大多数允许列表实现中，通配符不涵盖顶级域名。CLI 本身会访问 api.adapty.io，而在工作过程中读取 Adapty 文档的 Agent 则会访问顶级域名。

Claude 在对话开始时应用这些设置。如果你在对话过程中更改了访问模式或添加了域名，该对话仍会保留其启动时的设置——请开启新对话。

个人账户

您可以自行设置白名单：

1. 在 Claude 中，打开 Settings → Capabilities。
2. 开启 Code execution and file creation。Allow network egress 区块在此之前会保持隐藏。
3. 开启 Allow network egress。
4. 在 Domain allowlist 中，选择 Package managers only。
5. 在 Additional allowed domains 下，添加 adapty.io，然后添加 *.adapty.io。

另一种访问模式 All domains，允许沙盒访问任何站点。选择该模式后，无需添加 Adapty 域名。

企业工作区

由管理员控制许可名单。请让他们为工作区添加这两个域名。

安装并授权 CLI

每次对话都在一台全新的机器上开始：没有 CLI、没有令牌，也没有配置会从上一次对话中延续下来，因此安装和登录步骤需要在每次对话开始时重复执行。

安装并授权 CLI 的步骤如下：

1. 在 Claude 中开启一个新对话。

2. 让 Claude 安装 Adapty CLI——例如，输入”Install the Adapty CLI”。Claude 可能会请求权限以打开安装链接——允许即可。

   

3. 安装完成后，Claude 会提示你登录 Adapty——同意后，它会发布一个包含设备码的授权链接。该设备码有效期约为 15 分钟。

   

4. 打开该链接，浏览器会跳转到 Adapty CLI 授权页面。

5. 确认页面上显示的验证码与 Claude 给出的一致，然后点击 Authorize。如果两者不匹配，请点击 Deny 并让 Claude 重新生成链接。

   

6. 返回聊天，告知 Claude 你已完成授权——例如，输入”done”。Claude 会验证登录信息并显示你的账号详情。

CLI 已准备就绪。如需通过聊天设置应用、产品和付费墙，请参阅快速入门指南。

故障排查