《零基础玩转AI编程:Claude Code + Codex 双神器实战手册》

作者:AI-xianyu 团队 版本:v1.0(2026年6月) 适合人群:完全没接触过编程的小白 / 想用AI提效的职场人 / 学生 预计学习时间:2~3 小时(含动手操作) 学会后你能:让AI帮你写代码、查资料、做自动化,从此告别加班


这本教程能带你做什么?

看完并跟着做完,你将能够:

教程不要求你懂任何编程。如果你会用智能手机、能打字、会上网,就能学会。


目录(按顺序学,不要跳)

第 0 章:开篇必读

第 1 章:准备工作(5分钟搞定)

第 2 章:安装 Claude Code(小白版)

第 3 章:安装 Codex CLI

第 4 章:VS Code 扩展篇(图形界面党必看)

第 5 章:cc switch —— 模型切换神器

第 6 章:多模型组合实战

第 7 章:3个超实用小项目

第 8 章:避坑指南 & 高频问题

附录


第 0 章:开篇必读

0.1 AI编程是什么?和ChatGPT有什么区别?

简单说:

打个比方:

ChatGPT 像一个坐在你旁边的顾问,你说一句它答一句 Claude Code 像一个坐在你电脑里的实习生,你让它干啥它就真去干

它能干啥?举几个真实例子:

听起来很神奇对吧?其实门槛很低,今天就能学会。

0.2 Claude Code 和 Codex 是什么?我该选哪个?

工具 开发商 强项 适合场景 价格
Claude Code Anthropic 推理强、代码质量高、安全 复杂逻辑、代码审查、长任务 按token计费(贵但值)
Codex CLI OpenAI 通用、生态成熟、响应快 日常写代码、快速迭代 按token计费
DeepSeek-Coder 深度求索 中文好、便宜、量大 不差钱就选它 1元/百万token(极便宜)
智谱 GLM-4 智谱AI 中文顶尖、备案合规 涉密/合规场景 有免费额度
MiniMax MiniMax 多模态、长上下文 需要读长文档 有免费额度

我的建议

0.3 学习路线图

flowchart TD A[开始] --> B{操作系统?} B -->|Windows| C[第1章: 准备工作] B -->|Mac| Z[Mac用户在另一份教程] C --> D[第2章: 安装 Claude Code] D --> E[第3章: 安装 Codex] E --> F[第4章: VS Code 扩展] F --> G[第5章: 安装 cc switch] G --> H[第6章: 多模型组合] H --> I[第7章: 实战项目] I --> J[毕业!] J --> K[做出自己的小工具]

第 1 章:准备工作(5分钟搞定)

1.1 检查你的电脑

Win + R,输入 winver,回车。弹出的窗口里看: - Windows 10:版本号 ≥ 1903 即可(2019年5月后) - Windows 11:任何版本都行 - 内存:建议 ≥ 8GB - 硬盘:剩余空间 ≥ 10GB

如果电脑太老也别慌,工具都吃资源很少,老电脑也能跑。

1.2 PowerShell:Windows 自带的"魔法棒"

PowerShell 是 Windows 自带的命令行工具。以后装软件、改配置全靠它。

打开方法: - 按 Win + X → 点 Windows PowerShell终端 - 或者按 Win + R → 输入 powershell → 回车

怎么知道版本够不够新

$PSVersionTable.PSVersion

如果显示 Major 是 5 或 7,都够用。Windows 11 默认就是新版。

小白提示:不要害怕黑色窗口!它只是看起来"程序员",其实你只需要复制粘贴命令。

1.3 安装 Node.js(必须)

Claude Code 和 Codex 都基于 Node.js,必须先装。

步骤

  1. 打开官网:https://nodejs.org/
  2. 下载 LTS 版本(左边那个大的、绿色按钮)
  3. 双击安装包,一路点 Next,什么都不用改
  4. 装完验证:
node --version
npm --version

两行都显示版本号(比如 v20.17.0)就成功了。

如果提示"不是内部命令",说明安装没生效,重启电脑再试。

1.4 安装 Python(强烈建议)

虽然不是必须,但 Python 是 AI 编程最常用的语言,建议装。

最简单的方法——装 Anaconda

  1. 打开 https://www.anaconda.com/download
  2. 下载 Windows 版(免费,700MB左右)
  3. 安装时勾选 "Add to PATH"(重要!)

或者用微软商店(更简单):

  1. 打开 Microsoft Store
  2. 搜 "Python 3.12"
  3. 点 "获取" → 等装完

验证

python --version

1.5 安装 VS Code(写代码神器)

VS Code 是微软出品的免费代码编辑器,也是全球程序员使用最多的工具。

步骤

  1. 打开 https://code.visualstudio.com/
  2. 点大大的 "Download for Windows"
  3. 双击安装,勾选 "添加到 PATH" 和 "将"通过 Code"操作添加到资源管理器目录上下文菜单"

装完要做的事

1.6 申请你的第一个 API Key(DeepSeek)

API Key 相当于"AI 工具的钥匙",有了它你的电脑才能调用 AI。

为什么先申请 DeepSeek: - 便宜:1元能买 200万 字(够用半年) - 不用翻墙:国内直连 - 中文好:专为中文优化 - 新用户有免费额度

步骤

  1. 打开 https://platform.deepseek.com/
  2. 用手机号注册
  3. 实名认证(不认证没法用)
  4. 进 "API Keys" 页面
  5. 点 "创建新 Key",复制保存(只显示一次!)

⚠️ 重要:API Key 相当于你的银行卡密码,不要发给别人,不要截图发群里。建议存到密码管理器(如 1Password、Bitwarden 免费版)。


第 2 章:安装 Claude Code(小白版)

2.1 一键安装命令

打开 PowerShell(普通模式即可,不需要管理员),粘贴:

npm install -g @anthropic-ai/claude-code

等 1-3 分钟,看到一堆 added xxx packages 就成功了。

验证

claude --version

看到版本号(比如 1.0.x)就成功。

2.2 第一次启动

随便进一个文件夹(比如桌面),在文件夹里按住 Shift + 右键,选"在此处打开 PowerShell 窗口"。

或者在 PowerShell 里输入:

cd Desktop
claude

第一次启动会问你几个问题,依次回答:

2.3 配置 API Key

如果你用第三方模型(比如 DeepSeek 替代 Claude),需要配置环境变量。

临时配置(关掉就没了)

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com"
$env:ANTHROPIC_AUTH_TOKEN="你的DeepSeek_API_Key"

永久配置(推荐)

# 这个命令把你的 Key 写进系统,以后不用每次都输
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的key", "User")

重启 PowerShell 让配置生效。

2.4 第一次对话

现在试试让 AI 写代码:

> 帮我写一个 Python 脚本,把当前文件夹下所有 .txt 文件的内容合并到一个 all.txt 里

Claude 会: 1. 思考几秒 2. 写出代码 3. 问你"是否要保存?" 4. 你说 "是" 它就保存 5. 还会自动帮你运行测试

这就是 AI 编程的魅力——你说需求,它干活

2.5 常见问题

问题 解决
提示 claude: command not found 重启 PowerShell;如果还不行,重装 Node.js
网络超时 配 API 中转站或开启代理(见第 5 章 cc switch)
提示 "rate limit" 你用免费 Key 太频繁,等几分钟
中文乱码 PowerShell 里 chcp 65001 切到 UTF-8

第 3 章:安装 Codex CLI

3.1 一键安装命令

npm install -g @openai/codex

验证

codex --version

3.2 第一次启动

cd Desktop
codex

第一次会让你登录 OpenAI 账号。如果你没有 OpenAI 账号,可以用 API Key 方式

用 API Key 启动(推荐,配合 DeepSeek 用):

$env:OPENAI_API_KEY="你的DeepSeek_Key"
$env:OPENAI_BASE_URL="https://api.deepseek.com/v1"
codex

3.3 第一次对话

> 用 Python 写一个函数,判断一个字符串是不是回文

3.4 Claude Code vs Codex:什么时候用哪个?

我自己的使用习惯(仅供参考):

cc switch 就是为了让你在它们之间一键切换,不用每次改配置。


第 4 章:VS Code 扩展篇(图形界面党必看)

如果你不喜欢黑色窗口,VS Code 扩展就是为你准备的。

4.1 安装 Continue 扩展

Continue 是 GitHub 上 star 最多的 AI 编程扩展,免费开源

步骤

  1. 打开 VS Code
  2. 点左侧边栏"扩展"图标(长得像 4 个方块)
  3. Continue
  4. 点 "Install"

4.2 接入 DeepSeek

装完 Continue 后,左边会多一个对话图标。点开它,右上角齿轮 → "Select model" → "Add custom model"。

填:

字段
Provider OpenAI 兼容
Base URL https://api.deepseek.com/v1
API Key sk-你的key
Model deepseek-coderdeepseek-chat

点 "Connect",看到 "Connected" 就成功了。

4.3 接入 Claude

同上,Provider 选 Anthropic,API Key 用你的 Claude Key。

如果你没有 Claude 官方账号,强烈建议直接用 DeepSeek——便宜、中文好、不用翻墙。

4.4 像聊天一样写代码

选中一段代码,按 Ctrl + L,左侧弹出输入框。输入:

给这段代码加注释,解释每一行在做什么

AI 会自动把注释加进去。

快捷键速记: - Ctrl + L:问关于选中代码的问题 - Ctrl + I:让 AI 直接改写代码 - Ctrl + Shift + L:看 AI 的"理解"(解释整个文件)

4.5 高亮代码 & 一键改写

选中代码 → 右键 → "Continue: Edit" → 输入你的要求,AI 会生成一个 diff(差异对比),你可以逐段接受或拒绝

这个功能对小白特别友好——你不会写没关系,AI 改一行你确认一行。


第 5 章:cc switch —— 模型切换神器

5.1 cc switch 是什么?为什么必须有?

cc switch(也写作 cc-switch)是一个专为 AI 编程工具设计的模型切换器

它解决什么问题

flowchart LR A[Claude Code] --> M{cc switch} C[Codex] --> M M --> D[DeepSeek] M --> E[智谱 GLM] M --> F[MiniMax] M --> G[Claude 官方] M --> H[其他模型]

5.2 下载与安装

方式 A:从 GitHub 下载(推荐)

  1. 打开 https://github.com/sun-sw/Cc-Switch
  2. 点 "Releases"(右边栏)
  3. 下载最新版本的 Cc-Switch-X.X.X-windows-x64.exe.zip
  4. 解压/双击安装

方式 B:从 Gitee 下载(国内快)

  1. 打开 https://gitee.com/sun-sw/cc-switch
  2. 同样下载最新版本

5.3 配置你的第一个模型

打开 cc switch,主界面应该长这样(文字版):

+---------------------------------------+
|  AI 模型切换中心 v1.x.x               |
+---------------------------------------+
|  当前激活: <未配置>                    |
|                                       |
|  [+] 添加新模型                       |
|  [↻] 测试所有连接                      |
|  [⚙] 高级设置                          |
+---------------------------------------+

点 "+ 添加新模型":

字段 填什么(以 DeepSeek 为例)
模型名称 DeepSeek-V3
类型 Anthropic 兼容OpenAI 兼容(按 CLI 工具选)
Base URL https://api.deepseek.com
API Key sk-你的key
模型 ID deepseek-chat

保存。回到主界面,选中它,点"应用"。

5.4 添加更多模型

智谱 GLM-4: - Base URL: https://open.bigmodel.cn/api/paas/v4 - 模型 ID: glm-4-plus

MiniMax(长上下文): - Base URL: 按官方文档 - 模型 ID: MiniMax-Text-01

Claude 官方(如果你有海外卡): - Base URL: https://api.anthropic.com - 模型 ID: claude-3-5-sonnet-20241022

5.5 一键切换

装好 cc switch 后,你的 Claude Code 命令不用改,cc switch 会在后台自动路由:

这才是 AI 编程的"正确打开方式"——不依赖任何单一服务商。


第 6 章:多模型组合实战

6.1 思路

flowchart TD A[一个任务] --> B{任务类型} B -->|中文写作/翻译| C[DeepSeek 或 智谱] B -->|复杂逻辑/代码审查| D[Claude] B -->|长文档分析| E[MiniMax] B -->|日常问答| F[DeepSeek 便宜量大] C --> G[结果] D --> G E --> G F --> G

黄金法则: - 便宜的模型做"打杂"(写注释、改格式、查文档) - 贵的模型做"决策"(架构设计、复杂推理) - 跑批量任务用 DeepSeek,省 90% 成本

6.2 实战 1:用 DeepSeek 写 + Claude 审查

假设你让 DeepSeek 写了段代码,不放心质量:

[用 cc switch 切到 DeepSeek]
> 写一个 Python 函数,检查邮箱格式是否合法

[AI 写完后]
[用 cc switch 切到 Claude]
> 请审查下面这段代码,给出改进建议:
> [粘贴代码]

好处:DeepSeek 写代码便宜(几分钱),Claude 审查质量高(只花少量 token 用来读)。

6.3 实战 2:智谱 GLM 处理中文

> 帮我把这段技术文档改写成面向小白的中文教程

GLM-4 在中文改写、润色、生成方面是国内顶尖。

6.4 实战 3:MiniMax 通用备份

当你发现其他模型都"挤爆"了(高峰期限流),切到 MiniMax 顶上。永远有一个 Plan B


第 7 章:3个超实用小项目

7.1 项目一:批量重命名照片

场景:你有一堆照片叫 IMG_001.jpgIMG_002.jpg... 想按拍摄日期重命名。

做这件事的"老方法": - 用 Excel 改 → 累死 - 写个 Python 脚本 → 不会写

用 AI 的方法

[打开 PowerShell,进到照片文件夹]
> claude

> 帮我把当前文件夹下所有 .jpg 文件,按修改时间重命名为 "2024-01-15_IMG_001.jpg" 这种格式

AI 会: 1. 写出 Python 脚本 2. 问你是否运行 3. 运行前会先备份(默认行为,安全) 4. 你说"是",搞定

7.2 项目二:自动整理 Excel

场景:你有个 销售数据.xlsx,1万行,5列。想按"城市"分组求和,输出新表。

对话

> 我有份销售数据 Excel,请帮我:
> 1. 按"城市"分组
> 2. 求每个城市的销售总额
> 3. 找出销售额 Top 5 的城市
> 4. 生成一个可视化图表
> 5. 另存为 "销售汇总_按城市.xlsx"

AI 会自动选库(pandas)、写代码、运行、生成图表。整个过程你只动嘴。

7.3 项目三:抓取网页信息

场景:你想每天早上 8 点,自动抓取某个新闻网站的"今日头条"标题,发到微信。

对话

> 帮我写一个 Python 脚本:
> 1. 抓取 https://example.com/news 的今日头条
> 2. 提取前 10 条标题和链接
> 3. 存到 today_news.md 文件
> 4. 每天早上 8 点自动运行(用 Windows 任务计划程序)

AI 不仅会写代码,还会教你怎么配置 Windows 任务计划——一步一步告诉你点哪里。


第 8 章:避坑指南 & 高频问题

8.1 网络问题

现象 原因 解决
一直转圈 网络不通 用 cc switch 切到国内模型
提示 timeout 服务器抽风 换模型或加代理
部分功能用不了 协议不一致 用 OpenAI 兼容模式重试

8.2 API Key 报错

8.3 速度慢 / 余额不足

8.4 账号安全

8.5 模型"胡说八道"

AI 编程也会犯错。怎么办

  1. 永远自己跑一遍:AI 写的代码必须测试
  2. 加断言和测试:让 AI 帮你写测试用例
  3. 多模型对比:同一个问题问 2-3 个模型,结果差异大就要小心
  4. 小步迭代:一次只让 AI 改一处,不要大改

附录

A. 推荐资源

B. 20个提示词模板

(直接复制就能用)

代码类: 1. "请帮我写一个 [语言] 函数,功能是 [描述]" 2. "这段代码报错了:[粘贴错误],怎么修?" 3. "请重构这段代码,让它更易读" 4. "给这段代码加详细注释" 5. "请给这段代码写 5 个单元测试用例"

文件操作类: 6. "把当前文件夹下所有 [扩展名] 文件合并成一个" 7. "把 [文件名] 里的数据导出为 [格式]" 8. "重命名 [文件夹] 里所有 [条件] 的文件"

学习类: 9. "用通俗的话解释 [概念],举个生活中的例子" 10. "教我 [技术],从零开始,3 分钟讲清楚" 11. "下面这段代码在做什么?一步步分析"

效率类: 12. "我每天要重复做 [事],怎么自动化?" 13. "帮我写个 Excel 公式实现 [需求]" 14. "把这个 [格式A] 转成 [格式B]"

调试类: 15. "我运行 [代码] 后报错 [错误],可能的原因有哪些?" 16. "这段代码的性能瓶颈在哪?怎么优化?" 17. "为什么 [现象] 发生了?"

进阶类: 18. "我想要 [效果],请给我 3 个不同技术方案,分析优缺点" 19. "用 5 句话总结 [文章/文档] 的核心观点" 20. "扮演一个 [角色],和我演练 [场景]"

C. 全部命令速查表

# Node.js
node --version
npm --version

# Python
python --version
pip --version

# Claude Code
npm install -g @anthropic-ai/claude-code
claude --version
claude

# Codex
npm install -g @openai/codex
codex --version
codex

# 环境变量配置(PowerShell)
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxx"
$env:OPENAI_API_KEY="sk-xxx"
$env:OPENAI_BASE_URL="https://api.deepseek.com/v1"

# 永久配置
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")

# 文件操作
cd Desktop
cd ..
Get-ChildItem
New-Item -ItemType Directory -Name "test"
Remove-Item "test.txt"

D. 更新日志


写在最后

AI 编程不是程序员的专利。

它是每个人的"能力放大器"——

未来的分界线不是"会不会编程",而是"会不会用 AI"

这本教程只是开始。

希望它能帮你打开这扇门。

— AI-xianyu 团队