快速入门：15分钟跑通你的第一个 AI 程序（使用 DeepSeek）

菅志平

90人浏览 · 2026-03-25 14:09:53

菅志平 · 2026-03-25 14:09:53 发布

快速入门：15分钟跑通你的第一个 AI 程序（使用 DeepSeek）

给第一次接触 AI 开发的你

不需要看完整本书，不需要理解所有原理。这篇文档只有一个目标：

让你尽快用自己的代码，和 AI 说上第一句话。

顺利的话15分钟，网络慢或遇到问题30分钟以内。看到 AI 的回复那一刻，你会明白为什么这件事值得学。

为什么选 DeepSeek？ 国内可直接访问（无需代理），新账号有免费额度，性价比高。如果你已有 OpenAI Key，代码只需改两行（见文末说明）。

你需要准备什么

一台电脑（Windows / Mac / Linux 都行）
Python 3.11 或以上（不确定有没有？下面有检查方法）
一个 DeepSeek API Key（注册即可获取，有免费额度）
大约 15 分钟

就这些。不需要 AI 背景，不需要数学基础。

第一步：检查 Python 版本（2分钟）

打开命令行（Windows 叫"命令提示符"或"PowerShell"，Mac/Linux 叫"终端"），输入：

python --version

看到 Python 3.11.x 或更高版本？ 太好了，跳到第二步。

看到 Python 3.10 或更低？ 去 python.org 下载最新版本，安装时勾选"Add Python to PATH"。

报错"找不到命令"？ 试试 python3 --version，如果还是不行，去 python.org 安装。

第二步：获取 DeepSeek API Key（5分钟）

打开 platform.deepseek.com
注册账号（或登录）
点击左侧 “API Keys”
点击 “Create Key”，给它起个名字（比如 “学习用”）
复制这个 Key，它只显示一次！ 格式是 sk-...

关于费用：新账号有免费额度，学习阶段花费极少。DeepSeek 是目前性价比最高的大模型 API 之一，一次普通对话费用不到一分钱。

第三步：安装依赖（3分钟）

在命令行运行：

pip install openai python-dotenv

看到 “Successfully installed” 就成功了。

如果安装很慢（国内网络），加上国内镜像：
pip install openai python-dotenv -i https://pypi.tuna.tsinghua.edu.cn/simple

第四步：配置 API Key（2分钟）

在你想放代码的文件夹里，创建一个名为 .env 的文件（注意有个点），内容是：

DEEPSEEK_API_KEY=sk-你的key粘贴在这里

重要：把 .env 加入 .gitignore，不要把 Key 提交到 GitHub。

第五步：写第一个程序（1分钟）

在同一个文件夹，创建 hello_ai.py，粘贴以下代码：

import os
import openai
from dotenv import load_dotenv

# 从 .env 文件加载 API Key
load_dotenv()

# 创建 DeepSeek 客户端（兼容 OpenAI SDK）
client = openai.OpenAI(
    base_url="https://api.deepseek.com",
    api_key=os.environ.get("DEEPSEEK_API_KEY")
)

# 向 AI 发送第一条消息
response = client.chat.completions.create(
    model="deepseek-chat",             # 使用的模型
    max_tokens=1024,                   # 最多生成多少字
    messages=[
        {
            "role": "user",            # 这是用户说的话
            "content": "你好！请用一句话介绍你自己。"
        }
    ]
)

# 打印 AI 的回复
print("AI 说：", response.choices[0].message.content)

第六步：运行！（1分钟）

python hello_ai.py

如果看到类似这样的输出，你成功了！

AI 说：我是 DeepSeek，一个由深度求索公司开发的 AI 助手，擅长回答问题、写作、分析和编程。

恭喜！你刚刚做了什么？

你刚才：

调用了一个 AI API — 这和调用天气 API、地图 API 本质上一样，只是返回的是智能文字
发送了一条消息 — messages 列表就是对话历史，可以加更多消息实现多轮对话
接收了 AI 的回复 — response.choices[0].message.content 就是 AI 说的话

这三件事，就是 AI 应用开发的核心。后面课程里所有的 Agent、RAG、工具调用，都是在这个基础上扩展的。

试试更有趣的事

把 hello_ai.py 里的问题换成你感兴趣的：

# 试试让 AI 写一首诗
"用 5 行写一首关于编程的诗"

# 试试让 AI 解释概念
"用一个生活中的例子解释什么是机器学习"

# 试试让 AI 帮你写代码
"写一个 Python 函数，计算列表里所有数字的平均值"

如果遇到问题

ModuleNotFoundError: No module named 'openai'
→ 包没装上。重新运行 pip install openai python-dotenv

AuthenticationError: 401
→ API Key 不对。检查 .env 文件里的 Key 是否完整，前后有没有多余空格

FileNotFoundError: .env
→ .env 文件和 hello_ai.py 不在同一个文件夹，或者文件名多了 .txt 后缀

代码运行没有输出，卡住了
→ 网络问题。等待 30 秒，如果还不行，检查网络连接。DeepSeek API 在国内可直接访问，无需代理。

更多问题见常见问题与故障排查。

下一步：进入正式学习

跑通了第一个程序，现在你有两个选择：

选择 A：我想快速做出有用的东西（推荐）

按这个顺序学：

第1章（AI全景，2小时）→ 第6章（LLM基础，2-6小时）→ 第7章（API调用，4小时）
→ 第8章（Prompt工程，5小时）→ 第11章（RAG知识库，8小时）→ 第12章（Agent，10小时）

选择 B：我想系统学完整技术栈

从第1章开始，按顺序学，跳过第3-5章（数学/ML/深度学习）也没关系。

附：如果你已有 OpenAI Key

只需改两行代码：

# 把这两行
client = openai.OpenAI(
    base_url="https://api.deepseek.com",
    api_key=os.environ.get("DEEPSEEK_API_KEY")
)
response = client.chat.completions.create(
    model="deepseek-chat",

# 改成这两行
client = openai.OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY")
)
response = client.chat.completions.create(
    model="gpt-4o-mini",