五分钟备好环境：拿 API Key + 装好 Python 库
想跑后面那些"复制即跑"的代码？先花 5 分钟备齐这三样
前面你用低代码就造出了小雅,很爽——如果你只想走低代码这条路,这一节可以先跳过,以后想写代码再回来。
但这门课后面有很多"复制即可运行"的代码(让你真正看懂智能体怎么造)。要让它们跑起来,得先备好三样东西。5 分钟,一次准备,后面全程通用。
你需要的三样东西
为什么用 DeepSeek?国内直接能用、不用 VPN、便宜(充几块钱够你学完整门课),而且和 OpenAI 接口兼容——以后想换别家,改一行地址就行。
🙌 三步走
第 1 步:拿 API Key
- 打开 platform.deepseek.com,手机号注册。
- 左侧 API Keys → 创建,复制那串
sk-开头的钥匙(只显示一次,存好)。 - 充值几元(够学很久)。
第 2 步:装 Python
- 已经装过就跳过。没装去 python.org 下载 3.10 以上版本,一路下一步。
- 验证:终端敲
python --version,能看到版本号就行。
先说清楚终端是什么:它是一个让你敲命令的黑框框,不是 Python 本身。
- Windows:开始菜单搜「PowerShell」或「命令提示符」,打开它。
- macOS:聚焦搜索(⌘+空格)敲「终端」/「Terminal」。
最常见的坑:装完 Python 后,很多人从开始菜单点开的是 Python 交互环境—— 它的提示符长这样:
>>>
看到 >>> 就说明你在 Python 里面,不在终端。 这时候敲 python --version,
你会看到:
NameError: name 'python' is not defined
这不是你装错了,是敲错地方了——Python 把 python 当成了一个变量名,当然找不到。
怎么出去:敲 exit() 回车(或按 Ctrl+Z 再回车 / macOS 按 Ctrl+D),回到终端再敲一次。
一句话记住:>>> 里敲 Python 代码,终端里敲 python、pip 这类命令。
第 3 步:装库
pip install openai
🔧 跑通第一次调用
把下面这段存成 hello.py,把 你的KEY 换成你的钥匙,运行 python hello.py：
from openai import OpenAI
client = OpenAI(
api_key="你的KEY", # 换成你的 sk- 钥匙
base_url="https://api.deepseek.com", # 换别家就改这一行
)
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)
看到它回了你一句话?🎉 环境通了——后面所有代码都用这同一套写法,你再也不用为"跑不起来"发愁。
教学里为了简单，我们把 你的KEY 直接写在代码里。但真实项目千万别这样：Key 等于你的账户余额,泄露了会被人刷爆。
正确做法:把 Key 放到环境变量里读(os.environ["DEEPSEEK_KEY"]),代码里不出现明文;.env 文件加进 .gitignore,绝不提交到 GitHub。(这跟做网站要藏好密钥是一个道理。)
我在跑 Python 调用大模型的代码时报错了,错误信息是：『___』(我贴上来)。请帮我判断是 API Key、网络、库版本还是代码的问题,并给出最可能的解决办法。
环境备好了:一把 API Key + Python + 一个库,后面所有"复制即跑"的代码你都能亲手验证了。
现在,我们正式开始给小雅"升级大脑"。下一节(第 1 章开篇)先给你看一个扎心的现场——给小雅一个真实任务,看它当场翻车。看清它差在哪,你才会真正明白后面那套方法有多关键。
