← 返回内容

我的 AI 打工人们 2:给实习生办张工牌,一篇讲懂 API 和 key

  • AI
  • 教程
  • 入门
目录8 节

先说句实话:上篇写完,好几个人来问我”API key 到底是啥,我打开 agent 看到这三个字就慌”。我当时答应单独写一篇,这篇就来兑现。

如果你刚看完上篇,应该还记得那个比喻:agent 是你雇的实习生。这篇接着讲——实习生要开始干活了,得先给他办张工牌。这张工牌,就叫 API key。


一、agent、模型、key,先把三件事分清

上篇说过:agent 是个壳,自己没脑子,干活靠背后的模型。模型不住在你电脑里,住在”模型公司”——DeepSeek、阿里百炼、智谱、硅基流动,都是干这个的。

那 key 是啥?一句话:

key 就是给你家实习生办的工牌。 他拿着这张工牌去模型公司,报你的名号,模型公司才肯给他干活,账记在你头上。

所以记住一个直觉,后面全靠它:key = 钱。

顺便埋个伏笔:一家模型公司通常有几十上百个模型,同一个 key,能调他们家的所有模型。阿里百炼一个账号底下就挂着几百个模型。这个第 3 节还会讲到。


二、实操:用 DeepSeek,五步跑通

讲道理不如动手。挑 DeepSeek 当示范,就三个理由:便宜、好用、简单,而且国内注册和充值最方便,支付宝微信都行。

上篇答应过你”怎么选便宜的”,这里顺手一起兑现:免费额度先薅,不够再充几块,按量计费,几块钱能用很久。

第一步:注册。 打开 platform.deepseek.com,手机号注册就行。认准官网,别点广告里的”加速""代充”。

第二步:充值。 开放平台里找到”充值”,充十块二十块就够玩很久。按量计费,用多少算多少,不像会员那样按月扣钱。

第三步:创建 key。 控制台里找”API Keys”,点”创建”,会生成一串 sk- 开头的字符。

⚠️ 这串字符只完整显示一次。 创建完赶紧复制,存到安全的地方(备忘录、密码软件都行)。DeepSeek 就是这种,key 只给你看一次——不是它小气,是它自己也不知道完整内容,它只知道”这串 key 是某人的”。

真弄丢了也没事,回控制台删掉旧的、新建一个,一分钟的事,不麻烦。

第四步:填进 agent。 拿 OpenCode 举例(上篇的主角,你应该刚装好):打开设置,找到模型 / API 配置那一栏,把服务商选成 DeepSeek,把 key 粘贴进去,保存。

找不到你的供应商?用”自定义”。 有些 agent 的预设列表里没有 DeepSeek 这些名字,别慌,找”自定义 / Custom”入口,点进去一般只需要填三个字段:

  • Base URL(有的叫 API 地址)——模型公司的”门牌号”,告诉 agent 去谁家干活。去哪找:服务商官网的接口文档(开发者文档)里搜”Base URL”或”接口地址”,以文档写的为准(DeepSeek 是 https://api.deepseek.com)。
  • Model ID(模型 ID / 模型名)——具体找哪个”员工”,比如 deepseek-chat、deepseek-reasoner。去哪找:服务商接口文档里的模型列表,照着抄全名。
  • API Key——就是刚办的工牌。

三个字段各管一件事:去哪(地址)、找谁(模型 ID)、证明你是谁(key)。顺便说,同一个 Base URL、同一个 key,只把 Model ID 换成别的模型名就能换模型——这就是为什么一个账号能挂几百个模型,全看你想调谁。

第五步:验证。 随便发一句话,比如”你好,介绍一下你自己”。回话了,就是配对成功,收工。

要是没回话,别慌,报错就两种:

  • 提示 key 无效 / 认证失败 → key 复制错了,或者多了个空格,重新粘一遍;
  • 提示余额不足 → 该充值了。

三、key 的两种来路,别买错

市面上的 API key,来路分两种,差价很大,坑也藏在这。

官方直营:DeepSeek、阿里百炼、智谱、硅基流动……key 背后就是他们自家的模型,一手货源,最靠谱。

🎓 这里有个大福利:阿里百炼对学生有 300 元额度,省着用能用非常久。学生党别错过,先认证先薅。

中转站 / 聚合平台:把别人家的模型打包来卖,一个 key 底下挂很多模型。前面说的阿里百炼其实就是这种形态——一个账号几百个模型,很常见。

⚠️ 重点来了:低价中转站,不要信。 价格低到离谱的,通常靠两件事赚钱:

  • 掺水:你以为在调好模型,实际给你换成便宜的小模型,结果当然”不聪明”;
  • 隐私:你的对话、你的 key 都从它手里过,出问题你都不知道找谁。

这种站说跑就跑,投诉无门。真想用聚合平台,选 OpenRouter 这种大型的、有背书的——不一定完美,但至少出事了找得到人。

一句话选型:不是学生 → DeepSeek 起步,够用又便宜;是学生 → 先薅阿里百炼的 300 元;不管哪种,别碰来路不明的低价站。


四、让老牌 agent 也用上你的 key

前面都是在 OpenCode 里填。但你可能听过 Claude Code、Codex 这些名字——上篇科普过,它们是 CLI 老牌 agent,默认只认自家的官方账号和模型,不让你随便填别的 key。怎么办?两条路。

路一:直接改配置(免费,稍微动点手)

Claude Code 这类是命令行工具,没有设置界面,只能靠环境变量——其实就是把刚才那三个字段,换成在终端里写。打开终端,敲:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=你的key

把”你的key”换成真的,然后敲 claude 启动。原理和自定义供应商一模一样:Base URL 管去哪,key 管你是谁;Model ID 一般不用管,会用默认的,想指定就再加一行 export ANTHROPIC_MODEL=deepseek-chat。Codex 同理,只是变量名换成 OPENAI_BASE_URL 和 OPENAI_API_KEY。

小疑问:为什么这里的地址多了个 /anthropic?因为 Claude Code 走的是 Anthropic 家的协议,DeepSeek 专门为它开了一个兼容口;在 OpenCode 这类界面里填通用的 https://api.deepseek.com 就行,两边都是对的。

注:这两行只在当前终端窗口有效,关掉就没了。想省事,可以把它们写进终端配置文件(macOS 是 ~/.zshrc,Windows 是”环境变量”设置),以后就不用每次敲了。

路二:用 CC Switch 一键切换(有界面,适合配置多的人)

CC Switch 是个免费的开源小工具,专门干这件事:给 Claude Code、Codex、OpenCode 这些 agent 换 key,图形界面点一点就行,不用碰配置文件。官方站 ccswitch.io,GitHub 上搜 farion1231/cc-switch(125k star,放心)。macOS 下个 .dmg 装好。

用法三步:装好打开 → 添加一个供应商,把服务商和 key 填进去 → 点启用,重启一下终端就生效。以后想换哪家的模型,点一下切换,比手改配置省事多了。

⚠️ 两个预防针:

  1. CC Switch 的 GitHub 页面上挂着一些赞助商广告,全是”超低价中转站”。别点。 上篇说过,只信官网。它只是个帮你切换配置的工具,不代表它推荐的商家可信。
  2. 第三方模型在 Claude Code 里不一定有官方模型聪明——Claude Code 是按自家模型调校的,换 DeepSeek 之后”感觉变笨了”很正常,不是你没配对。

五、顺手说几个我自己踩过的坑

上篇讲了一些习惯,这篇针对 key 再补几条,都是我自己的血泪:

  • key 等于钱,泄露了就是别人拿你的饭卡白吃。 一旦发现 key 发过群里、贴过帖子、或者机器给不熟的人用过,别犹豫,回控制台删除重建,一分钟的事。
  • 别把 key 写进代码传 GitHub。 很多人栽在这:key 写死在脚本里,往 GitHub 一传,几分钟就被盗刷。脚本里要用 key,放环境变量,别写死。
  • 只从官方控制台创建 key。 任何”帮忙代充""低价车""拼车”都别碰。
  • 新服务商先充小钱试水。 充个十块,跑通了再考虑多充。

结尾

到这儿,“给实习生办工牌”这件事就齐了:知道 key 是啥、会注册会充值、填进 agent 跑通、还能让老牌 agent 用上便宜模型。有了 key,你的打工人们才算真正上了工。

下一篇写点啥,我还没想好。候选:怎么挑模型(便宜好用 vs 聪明)、报错排查大全,或者你们评论区想看啥,评论区见。

留言板

来都来了,说点什么再走。