CLI：让你电脑上的 Agent 直接用本站的模型

先看你用的是哪一个

CLI 页下半部分每个客户端一张卡片，卡片下面写着最少的操作步骤。先找到你那一张：

建一把专用密钥，配进你的 Agent

六步。前三步在网页上点，第四步在你电脑上粘配置，后两步是验证和收尾。整个过程不花钱，本地 Agent 真正开始干活才扣。

1. 1

   打开 CLI 页

   点左侧栏最上面那排页签里的 CLI。

   页面分两段：第 1 段 准备一把密钥，第 2 段 配进你的 Agent。还没有任何密钥时，第 2 段会写「先在上面建一把密钥」。

   打开这一页
2. 2

   建一把带花费上限的专用密钥

   在虚线框里 新建专用密钥 · 花费上限（⚡ 算力） 那一格填一个金额，第一次填个小数就行，比如 20；然后点旁边黑色的「新建『本地 Agent』密钥」。

   提示「已创建专用密钥」，后面跟着最多能花多少。上面的 使用密钥 下拉框会自动选中它，后面写着还剩多少。这把密钥花到上限就停止服务，不会再往下扣你的余额。

   上限该填多少？

   • 怕填多了被一次花光这个数不是预充值，是从你账户余额里扣的上限。填多了不会多扣，只是允许它最多花到这么多。先填小一点，不够再加。
   • 想不设上限留空就是不限。但本地 Agent 会连续自动调用模型，跑一个大任务很快，强烈建议设一个。
   • 已经有别的密钥了，还要新建吗建议单独建一把。这样它花了多少一目了然，出问题只停这一把，不影响你别的程序。

   打开这一页
3. 3

   选一个默认模型

   第 2 段最上面 默认模型 第一次保持 按客户端自动选择：Claude Code 那几张卡片会挑 claude 开头的模型，Codex 那几张挑 gpt 开头的，其余挑排在最前面的对话模型。想指定，就在下拉里选一个。

   下拉里每一项括号里那串就是模型 ID，客户端里要填模型名时填的是它，不是界面上的名字。这里选的只是写进配置的默认值，装好以后在客户端里还能改。

   打开这一页
4. 4

   配进客户端

   找到你那张卡片。CC Switch：先打开 CC Switch，点 一键导入，浏览器问要不要打开 CC Switch 时选是，然后在 CC Switch 里切到这个供应商。Claude Code / Codex CLI / OpenCode：点 复制配置，按卡片下面列的三步做——粘进哪个文件、在终端里设哪个环境变量，卡片上都写着；Codex CLI 和 OpenCode 用什么命令启动，写在复制出来的配置最后一行。

   按按钮那一下才去取一次密钥，页面上不会显示出来。地址统一是你现在浏览器地址栏里这个网站：OpenAI 兼容的客户端填 /v1 结尾，Claude Code 填不带 /v1 的根地址——复制出来的配置已经替你写好了，照粘就行。配置里的供应商名称、标识和环境变量名都是按你现在访问的网站自动生成的，照抄就行，不用改。

   点了没反应？

   • 点「一键导入」，CC Switch 没弹出来确认 CC Switch 已经装好并且开着。还不行就点旁边的 复制链接，在 CC Switch 里手动粘贴导入。
   • 提示「复制失败，请改用 https 访问后再试」浏览器只在 https 网址下允许网页写剪贴板。把地址栏改成 https 开头再打开这一页。
   • 按钮是灰的点不了模型列表还没加载出来，等一两秒；一直是灰的就刷新一下。

   打开这一页
5. 5

   跑一句，回来看它扣了多少

   在客户端里让它干一件小事，比如解释一个文件。然后回到 CLI 页，点 管理全部密钥，找到「本地 Agent」那一行，点 使用明细。

   里面是这把密钥的每一次调用：什么时候、哪个模型、扣了多少，可以按近 7 天、近 30 天筛，也能导出。行里还写着这把密钥 已用 多少、剩余多少。第一次跑完一定来看一眼，心里有个数：本地 Agent 一个任务往往要连着调用很多次。

   客户端报错连不上？

   • 提示密钥无效看看这把密钥是不是被禁用、删除或者轮换过。轮换过的话，旧的立刻失效，用「一键接入」配过的客户端要重新导入一次。
   • 提示额度不够这把密钥花到上限了，或者账户余额不够。前一种看下面「藏在界面里」第三条。
   • 提示模型不存在客户端里的模型名要填模型 ID，回第 3 步的下拉里对一下括号里那串，大小写也要一样。

   打开这一页
6. 6

   不用了，或者怀疑泄露了，马上停

   还是在 管理全部密钥 里那一行：暂时不用点 禁用，以后点 启用 就恢复；彻底不要了点 删除；怀疑被别人拿到了点 轮换。

   轮换会换一把新密钥，名称、额度和限制不变，旧密钥立即失效，正在用旧密钥的客户端会马上调用失败，要换成新的（用一键接入配的，回 CLI 页重新导入一次）。到这一步，你已经会用了。

   打开这一页

藏在界面里、不说就不知道的四件事

前两条关系到密钥安全和看错余额，最容易出事。

本地 Agent 怎么扣钱

和你在网页上用是同一份余额、同一套价格。不同的是：本地 Agent 自己一轮轮地调用，没有网页上那种「出图前先问你」的确认卡。

还是不对？

接下来学什么

本地 Agent 用的是同一套接口和余额。想往深里走：

• 想自己写代码调接口拿齐地址、密钥、模型 ID，发出第一个请求，看懂报错。去学「进阶」
• 想弄清每一次调用扣了多少看懂消费记录里每一笔是怎么算的。去学「算力与计费」
• 想让网页上的超级智能体也有花钱上限单次任务上限、自动生成上限、Agent 记忆，一次讲清。去学「智能体进阶」