写给小白：怎么在你的电脑上用上 AI

一、网页版 AI vs 电脑版 AI

1.1 你可能已经在用的——网页版 AI

你在浏览器里打开 ChatGPT、DeepSeek、通义千问的网页版，打字聊天，AI 回答——这是网页版 AI。

它的局限：

• 只能聊天，不能帮你操作电脑上的文件
• 你让它写一篇文章，它只会把文字发在聊天框里，你得自己复制粘贴保存
• 不能读你电脑上的文件，不能上网帮你搜索
• 每开一个新对话，之前聊的全忘

1.2 这篇要教的——电脑版 AI（Coding Agent）

有一类工具叫 Coding Agent（编程智能体），虽然名字里有”编程”，但不是只有程序员才能用。它能：

• ✅ 直接在你电脑上创建文件、写文章、保存
• ✅ 读取你电脑上的文件内容并分析
• ✅ 上网搜索信息并整理成文档
• ✅ 批量处理文件（比如把 100 个文件按规则重命名）
• ✅ 记住你给它的指令（Skill），下次自动执行

和网页版最大的区别：你不是在”和 AI 聊天”，而是在”让 AI 帮你干活”。你告诉它做什么、存到哪，它直接执行。

1.3 两条路线

二、完全合规版：OpenCode + DeepSeek

2.0 这条路线不需要魔法

OpenCode 桌面版可以从国内下载，DeepSeek 是国内公司的 AI 服务，API 服务器在国内，全程不需要魔法。

如果你将来想升级到完整版（Claude Code），那时才需要科学上网——先看 这篇科普。

2.1 装 Git（必须）

Git 是版本管理工具，AI 工具靠它追踪文件的改动。不装的话部分功能用不了。

操作：

1. 打开 https://git-scm.com
2. 点 Download for Windows
3. 选 64-bit Git for Windows Setup
4. 安装：一路 Next（默认设置就是最优的，不用改任何选项）

2.2 装 OpenCode

1. 打开 https://opencode.ai/zh/download
2. 选你的系统版本（Windows / macOS）
3. 下载安装：一路 Next

2.3 创建项目

1. 启动 OpenCode
2. 建议在 D 盘建一个项目目录，比如 D:\Projects\first-prj
3. 在 OpenCode 里打开这个文件夹

2.4 用免费模型（零成本入门）

OpenCode 自带免费模型，不用任何配置、不用充钱、不用注册任何账号，装完就能用。

界面里选免费模型，直接开始对话。

试一下：输入「你好，帮我看看今天的新闻」，它会自动上网搜索并总结。

2.5 让 AI 做事，而不只是聊天

❌ 错误用法（只会回复文字）：

帮我写一篇文章

✅ 正确用法（会创建文件）：

请在当前项目下，用 md 文档格式，写一篇关于 XX 的文章并保存

记住：告诉它做什么 + 存到哪 + 什么格式，它才会帮你执行操作。

2.6 接入 DeepSeek API（可选，进阶）

免费模型有额度限制。想用更强的模型（DeepSeek-V4-Pro），可以接 DeepSeek 的 API。不需要翻墙，DeepSeek 是国内服务。

关于实名认证（重要，先看）

操作步骤

1. 打开 https://platform.deepseek.com，用手机号注册登录
2. 左侧菜单 → API Keys → 创建 API Key
3. 名称填 opencode，创建后立即复制保存到记事本（只显示一次！）
4. 充值：先少充一点试试（建议 5-10 元起步），别一次性充太多。用完再充，心里有数

在 OpenCode 里接入

1. 在 OpenCode 对话框里输入 /connect
2. 输入 deepseek 并选择
3. 填入你的 DeepSeek API Key
4. 选择 DeepSeek-V4-Pro 模型

费用参考

DeepSeek API 按使用量收费（Token 计费），日常写文章、整理资料的话，10 元能用很久。具体价格见 DeepSeek 官方定价。

三、完整版：Claude Code + DeepSeek（需要翻墙）

3.0 什么时候升级到完整版

• 免翻墙版玩明白了，想要更强功能
• 想用命令行工具（更快、资源占用更小）
• 需要 Claude Code 的高级功能（Web Search、更多 Skill 兼容）

3.1 前置条件

1. 科学上网：Claude Code 要访问境外服务器。如果没搞定，先看 这篇科普
2. Git：已装（免翻墙版装过了）
3. Node.js（可选）：打开 https://nodejs.org，选 LTS 版本下载，一路 Next 安装

3.2 环境变量是什么——小白最懵的概念

Claude Code 的配置会反复提到「环境变量」，先搞懂它。

环境变量就是 Windows 系统里存的一些「全局设置」。软件安装后会把自己的路径写进环境变量，这样你在任何地方输入命令名就能启动它。

打个比方：

• 环境变量 = Windows 的「通讯录」
• 你输入 claude → Windows 翻通讯录 → 找到 claude 在哪 → 启动它
• 如果通讯录里没有 claude 的记录 → Windows 说「找不到命令」

怎么打开环境变量设置：

1. 按 Win + S，输入「环境变量」
2. 点「编辑系统环境变量」
3. 弹出窗口右下角点「环境变量」
4. 上面是用户变量（只对你生效），下面是系统变量（对所有人生效）
5. 大部分情况配用户变量就够了

3.3 装 Claude Code

方式一：原生安装（推荐）

1. 右键左下角开始菜单 → 选「终端管理员」
2. 复制粘贴这行命令，回车：

irm https://claude.ai/install.ps1 | iex

3. 装完关闭终端，重新打开

方式二：npm 安装（方式一失败时用）

# 先设置执行策略（只需一次）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 安装
npm install -g @anthropic-ai/claude-code

3.4 添加 Path 环境变量

装完后如果输入 claude 没反应，说明环境变量没加。

1. 按 Win+S 搜「环境变量」→ 打开
2. 在用户变量里找 Path，双击
3. 新建一条：%USERPROFILE%\.local\bin
4. 在系统变量的 Path 里也加一条同样的
5. 确定，关掉终端重新打开
6. 输入 claude 回车 → 看到启动界面就成功了

3.5 接入 DeepSeek（核心步骤）

Claude Code 默认要用 Anthropic 官方账号（贵且有封号风险）。通过环境变量接入 DeepSeek，不用买 Claude 会员，10 元能用很久。

第 1 步：获取 DeepSeek API Key

如果你在免翻墙版已经注册过 DeepSeek 并拿到 Key，直接用那个，不用重新注册。

1. 打开 https://platform.deepseek.com
2. 左侧 → API Keys → 创建 API Key
3. 名称填 claude-code
4. 复制生成的 Key 立即保存到记事本（只显示一次！）
5. 充值（10 元起步）

第 2 步：配置环境变量

打开终端管理员，把下面命令里的 <你的 DeepSeek API Key> 替换成你的 Key，逐条执行：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 DeepSeek API Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-flash", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")

第 3 步：验证

1. 关掉所有终端窗口，重新打开（环境变量要重开才生效）
2. 进入你的项目目录（比如 cd D:\Projects\first-prj）
3. 输入 claude 回车
4. 不再弹出登录提示，直接进入对话界面 = 配置成功

四、通用：基础使用

4.1 让 AI 做事的核心原则

无论 OpenCode 还是 Claude Code，核心都是：告诉它做什么 + 存到哪 + 什么格式。

请在当前项目下，用 md 文档格式，写一篇关于 XX 的文章并保存

4.2 查看生成的文件

• OpenCode：右侧 Files 面板
• 文件管理器：右键项目文件夹 → 在文件管理器中打开
• Obsidian（推荐）：专门看 Markdown 文件的工具，见下文

4.3 斜杠命令

在对话框里输入 /，会弹出可用命令列表。装了 Skill 后也会出现在这里。

4.4 Git 版本追踪

装了 Git 后，AI 每次修改文件都会被追踪。不满意可以撤销。

五、通用：Skill 是什么

5.1 问题

每次新开会话，AI 都是从零开始，你之前教的它全忘了。比如你每次都要说「用口语风格写、每段不超过 3 句」——太累。

5.2 解决

Skill = 预先写好的提示词模板。装一次，以后用 / 命令一键加载。

5.3 怎么装

方法一：让 AI 帮你找

帮我去 https://skills.sh 找一个写分镜的 skill，安装到当前项目

方法二：输入 / 搜索已安装的 Skill

5.4 npm 镜像（装 Skill 卡住时用）

npm config set registry https://registry.npmmirror.com

六、通用：Obsidian 看文档

6.1 什么是 Obsidian

专门看和管理 Markdown（.md）文件的工具。AI 生成的文件都是 md 格式，文件多了用记事本一个个开很麻烦，Obsidian 能统一预览。

6.2 安装

1. 打开 https://obsidian.md
2. 下载对应系统版本
3. 安装：一路 Next

6.3 打开项目文件夹

1. 启动 Obsidian
2. 选「打开本地仓库（Open folder as vault）」
3. 选你之前建的项目文件夹（比如 D:\Projects\first-prj）
4. 所有 md 文件都会列出来，点击即可预览

七、常见问题排障

npm config set registry https://registry.npmmirror.com

八、想体验 Claude 模型？推荐 Cursor

上面两条路线都是用 DeepSeek 的模型。如果你非常想体验 Anthropic Claude 原版模型（目前最强的 AI 模型之一），直接买 Claude 官方账号有封号风险（检测中国 IP）。

推荐方案：买 Cursor。

8.1 Cursor 是什么

Cursor 是一款内置 AI 的代码编辑器（基于 VS Code 改的），内置了 Claude、GPT、Gemini 等多家前沿模型。你不用自己接 API、不用配环境变量、不用担心封号——Cursor 帮你搞定一切。

8.2 费用

8.3 和本教程其他路线的对比

8.4 怎么装

1. 打开 https://www.cursor.com
2. 点 Download 下载对应系统版本
3. 安装：一路 Next
4. 启动后登录（用 Google/邮箱注册）
5. 免费版直接用；想用 Claude 等前沿模型 → 升级 Pro（$20/月）

8.5 适合谁

• 想体验 Claude 原版模型、不怕花 $20/月的人
• 想要开箱即用、不想折腾环境变量的人
• 既是写代码又是写文章的人（Cursor 本质是代码编辑器，但也能帮你写 md 文件）

九、三条路线总结

相关笔记

• 写给小白：翻墙、代理、Tun 模式到底是什么 — 完整版的前置条件
• LTSC 安装教程 — 系统层面的配置
• 环境配置 SOP — 技术向的环境配置