Presto 文档

简体中文

English

简体中文

English

主题

AI 编程入门 ​

这篇教程教什么 ​

你将学会用 AI 助手写代码——不需要任何编程基础，也不需要提前学任何编程语言。AI 助手会帮你把自然语言（就是你平时说的话）翻译成计算机能执行的代码。

  • 预计时间： 30-45 分钟
  • 最终产出物： 用 AI 写出一个能运行的 Python 倒计时小程序
  • 前置条件： 一台电脑（macOS 或 Windows）、网络连接

准备好了吗？我们开始。

第一部分：概念扫盲（5 分钟阅读） ​

在动手之前，先花几分钟了解几个你会反复遇到的概念。不用死记硬背，知道大概意思就行，后面用到的时候会越来越熟。

AI 编程助手 = 一个懂编程的聊天伙伴 ​

AI 编程助手不是搜索引擎（它不是帮你"搜答案"），也不是一个自动写代码的机器（它不能替你做所有事）。它更像一个随时在线的编程搭档：你用中文告诉它你想做什么，它帮你写代码、解释代码、找 bug。但最终决定权在你手上——你要判断它给的东西对不对。

详细解释见 术语表 - Claude Code

API = 程序之间的对话接口 ​

想象你去餐厅吃饭：你看菜单点菜（说中文），服务员把你的需求翻译给厨房（厨房有自己的"语言"），厨房做好菜再端给你。在这个过程中，菜单和服务员就是"API"——它定义了你和厨房之间怎么沟通。程序之间也是这样，通过 API 互相传递数据。

详细解释见 术语表 - API

API Key = 你的身份证 ​

就像图书馆借书需要借书证一样，使用 AI 服务需要一个 API Key 来证明"我是合法用户"。它是一串看起来像乱码的字符串，每个人的都不一样。拿到之后要妥善保管，不要分享给别人——就像你不会把银行卡密码告诉陌生人一样。

详细解释见 术语表 - Token（API Key 是 Token 的一种）

Token = AI 的计费单位 ​

AI 处理文字的时候，会把你的输入拆成一个个小片段，每个片段叫一个 token。你可以把它理解成手机流量——用多少扣多少。一个中文字大约是 1-2 个 token，一段 100 字的对话大约消耗 100-200 个 token。大多数平台会给新用户免费额度，足够你学习使用。

详细解释见 术语表 - Token

IDE = 写代码的工具 ​

Word 是写文章的工具，Photoshop 是修图的工具，而 IDE（集成开发环境）就是写代码的工具。目前最流行的是 VS Code——免费、好用、插件丰富。你可以把它理解成一个"高级记事本"，专门为写代码优化过：它会给代码上颜色、自动补全、帮你找错误。

本教程主要使用终端中的 AI 助手，VS Code 在后续教程中会用到。

终端/命令行 = 用文字操作电脑 ​

平时你用鼠标点图标来打开软件、复制文件。终端（也叫命令行）是另一种操作电脑的方式——用文字。你输入一行命令，按回车，电脑就执行。听起来很原始，但程序员每天都在用它，因为很多操作用命令比用鼠标快得多。

详细解释见 术语表 - CLI

第二部分：环境搭建 ​

这一步需要在你的电脑上安装一些工具。我们已经写好了一份详细的安装指南，按步骤操作就行。

请按照 环境搭建指南 完成步骤 1-7。 完成后回到这里继续。

✅ 验证点：在终端输入 claude --version，看到版本号说明安装成功。

如果安装过程中遇到问题，环境搭建指南的每一步都有"常见问题"折叠区，点开看看有没有你遇到的情况。

第三部分：注册智谱 AI 并获取 API Key ​

Claude Code 是一个"框架"，它需要连接一个 AI 模型才能工作。我们使用智谱 AI（国内平台，注册方便，有免费额度）。

以下步骤基于 2026 年 3 月的智谱开放平台界面，如有变化请以官网实际页面为准。

3.1 注册智谱账号 ​

  1. 打开浏览器，访问 智谱开放平台
  2. 点击右上角的"注册"按钮
  3. 使用手机号注册，输入验证码完成注册
  4. 注册成功后会自动登录

3.2 获取免费额度 ​

  1. 登录后进入控制台
  2. 新用户通常会获得免费的体验额度（具体金额以平台当前政策为准）
  3. 如果平台提供学生认证，可以尝试认证获取更多免费额度（需要学生证或教育邮箱）

3.3 创建 API Key ​

  1. 在控制台左侧菜单中找到"API Keys"或"API 密钥"
  2. 点击"创建 API Key"按钮
  3. 给你的 Key 起个名字（比如"学习用"），然后点击确认
  4. 页面会显示你的 API Key，立刻复制并保存到一个安全的地方（比如备忘录）

⚠️ 安全提示：

  • API Key 只会显示一次，关闭页面后无法再查看，只能重新创建
  • 不要把 API Key 分享给别人——别人用你的 Key 调用 API，扣的是你的额度
  • 不要把 API Key 提交到 Git 仓库——这是最常见的安全事故之一

✅ 验证点： 你的 API Key 格式类似 xxxxxxxx.xxxxxxxxxxxxxxxx（两段字符串，中间用点号分隔）。如果格式不对，可能复制错了。

第四部分：配置 Claude Code 使用智谱 ​

现在你有了 API Key，需要告诉 Claude Code 使用智谱的 AI 模型。我们用 cc-switch 工具来完成这个配置。

4.1 运行 cc-switch ​

打开终端，输入：

bash
cc-switch

你会看到一个交互式菜单，列出可用的 AI 服务商。

4.2 选择智谱并输入 API Key ​

  1. 用方向键选择 zhipu（智谱），按回车确认
  2. 按提示输入你刚才保存的 API Key，按回车
text
? Select provider: zhipu
? Enter API Key: xxxxxxxx.xxxxxxxxxxxxxxxx
✓ Configuration saved

4.3 验证配置是否成功 ​

在终端输入：

bash
claude "你好，请用一句话介绍自己"

等几秒钟，如果一切正常，AI 会回复一段自我介绍，类似：

text
你好！我是一个 AI 语言模型，可以帮你回答问题、写代码、分析文本等各种任务。

✅ 验证点： 看到 AI 的中文回复，说明配置成功。如果报错，检查以下几点：

  • API Key 是否复制完整（没有多余的空格或缺少字符）
  • 网络是否正常（能不能打开 bigmodel.cn）
  • 再运行一次 cc-switch 重新配置试试

第五部分：用 AI 完成第一个编程任务 ​

环境准备好了，现在来做点有意思的事——用 AI 写一个 Python 倒计时程序。

5.1 安装 Python ​

如果你还没有安装 Python，先装一下。

macOS：

bash
brew install python

Windows（在管理员 PowerShell 中）：

powershell
winget install Python.Python.3.12

验证安装：

bash
python3 --version

看到 Python 3.x.x 就行。Windows 上可能需要用 python 而不是 python3。

5.2 开始和 AI 对话 ​

打开终端，输入 claude 进入对话模式。然后像聊天一样告诉它你想做什么：

👤 你：

帮我写一个 Python 倒计时程序，从 10 倒数到 0，每秒显示一个数字

🤖 AI：

好的，这是一个简单的倒计时程序：

python
import time

for i in range(10, -1, -1):
    print(i)
    time.sleep(1)

print("倒计时结束！")

这段代码的逻辑：

  • range(10, -1, -1) 生成从 10 到 0 的数字序列
  • print(i) 把当前数字显示在屏幕上
  • time.sleep(1) 让程序暂停 1 秒再继续
  • 最后打印"倒计时结束！"

5.3 运行程序 ​

让 AI 帮你把代码保存成文件并运行：

👤 你：

把这段代码保存成 countdown.py 并运行

🤖 AI：

已创建文件 countdown.py，运行结果：

text
10
9
8
7
6
5
4
3
2
1
0
倒计时结束！

✅ 验证点： 终端显示从 10 到 0 的倒计时，每个数字之间间隔约 1 秒。

5.4 用自然语言修改程序 ​

这才是 AI 编程最有意思的地方——你不需要学语法，直接用中文告诉 AI 你想改什么。

试试这些修改：

👤 你：

把倒计时改成从 30 开始

🤖 AI：

已修改，把 range(10, -1, -1) 改成了 range(30, -1, -1)。运行结果会从 30 开始倒数。

再试一个更有趣的：

👤 你：

倒计时结束后播放一个提示音

🤖 AI：

已修改 countdown.py：

python
import time
import os
import platform

for i in range(30, -1, -1):
    print(i)
    time.sleep(1)

print("倒计时结束！")

# 播放提示音
if platform.system() == "Darwin":  # macOS
    os.system("afplay /System/Library/Sounds/Glass.aiff")
elif platform.system() == "Windows":
    import winsound
    winsound.Beep(1000, 500)
else:
    print("\a")  # 通用的终端响铃

程序会根据你的操作系统选择合适的方式播放提示音。

感受到了吗？你没有学任何编程语法，但已经在"写程序"了。你负责想法，AI 负责翻译成代码。这就是 AI 编程的核心体验。

第六部分：AI 编程的基本原则 ​

在你继续探索之前，有四条原则需要记住。它们会帮你避开大多数新手踩的坑。

原则 1：AI 不是万能的——它会犯错，你需要验证 ​

AI 会自信满满地给你一段有 bug 的代码，就像一个很热心但偶尔粗心的朋友。所以每次拿到 AI 的代码，先运行一下看看结果对不对。如果结果不对，告诉 AI 哪里不对，让它修改。

正确心态：把 AI 的输出当作"初稿"，不是"终稿"。

原则 2：好的提问 = 好的结果 ​

AI 的回答质量取决于你的提问质量。"帮我写个程序"太模糊，"帮我写一个 Python 倒计时程序，从 10 倒数到 0，每秒显示一个数字"就清楚多了。

几个提问技巧：

  • 说清楚你要什么（功能描述）
  • 说清楚用什么（编程语言、工具）
  • 说清楚限制条件（比如"不要用第三方库"）

原则 3：迭代是正常的——第一次不完美很正常 ​

就像写作文一样，第一稿很少是完美的。和 AI 的对话是一个来回修改的过程：你提需求 → AI 写代码 → 你测试 → 发现问题 → 告诉 AI 修改 → 再测试。这个循环是正常的工作流程，不是"AI 不行"。

原则 4：先理解再使用——不要盲目复制 AI 的代码 ​

AI 给你的代码，至少要大概看懂它在做什么。不需要理解每一行语法，但要知道整体逻辑。这样当代码出问题时，你才能告诉 AI 哪里不对。

想深入了解这些原则和更多工作流模式，请阅读 AI 工作流模式。

下一步 ​

恭喜你完成了第一个 AI 编程任务！回顾一下你学到了什么：

  • AI 编程助手是什么、怎么用
  • 如何搭建环境、配置 AI 服务
  • 如何用自然语言让 AI 写代码、改代码
  • AI 编程的四条基本原则

下一篇教程，我们会用 AI 来开发一个 Presto 模板——把你的排版想法变成真正可用的文档模板。

继续阅读：用 AI 开发 Presto 模板

Presto — Markdown to PDF