今天刷微博的朋友应该都看到了：DeepSeek 的 GitHub 代码仓库里被人扒出了三个没公开的 V5 测试模型文件，话题直接冲上热搜，一堆人在问"蓝色小肥鱼是不是又要放大招了"。

与此同时，现在日常用得最多的 DeepSeek V4.1 Flash，速度快、价格便宜，已经成了很多人手机和电脑里的常驻 AI。但每次发评论区、私信都有人问：这小肥鱼到底怎么装？为什么我网页能用，自己软件里接不上？API Key 去哪领？Cherry Studio、NextChat、Claude Code 这些工具到底怎么配？

这篇教程一次性讲透：从零开始安装 DeepSeek、注册拿 Key、接入主流软件和平台，每一步都写清楚，小白照着点就行。全程不藏私，看完你自己就能搞定，不用再到处求人。

一、先搞明白："蓝色小肥鱼"到底是个啥

先给刚接触的朋友补个基础，免得后面看懵。

DeepSeek（深度求索）是咱们国内的大模型公司，官方 Logo 就是一条圆滚滚的蓝色小鱼，网友亲切地叫它"蓝色小肥鱼""蓝鱼"。它的模型分两条线：

- deepseek-flash（就是现在的 V4.1 Flash）：速度快、便宜，日常聊天、写文案、改稿子、做总结首选。

- deepseek-v4-pro：旗舰推理模型，写代码、做数学题、搞复杂逻辑、长文档分析更强，价格也更高。

而今天上热搜的 V5，目前只是开发者预览仓库里出现了测试文件，官方还没正式发布。本文教程基于当前线上可用的 V4.1 Flash 和 V4 Pro，V5 一旦上线，配置方式基本不变，到时候换个模型名就行。

先分清两个概念：

- 官方网页版 / App：注册就能免费聊，面向普通用户，不用管 API。

- API 接口：把小肥鱼"装"进你自己用的各种软件里（比如电脑上的 AI 客户端、编程工具、自己搭的聊天站），按用量计费，要去开放平台单独领 Key、充值。

下面这两部分我们都会讲。

二、零门槛使用：5种安装方式，从手机到电脑全覆盖

方式1：网页版（最省事，什么都不用装）

如果你只是想日常问问题、写东西，根本不用下载任何软件，打开浏览器就行。

1. 浏览器访问 DeepSeek 官网（deepseek.com），点"开始对话 / 与 DeepSeek 免费对话"。

2. 第一次进入，用手机号注册登录，收个验证码即可。

3. 登录后直接在对话框输入问题，网页版自带深度思考、联网搜索等能力，免费额度日常够用。

优点：不用安装、不占内存、电脑手机都能开。缺点：不能装进第三方软件里用。

方式2：iPhone / iPad 安装官方 App

1. 打开 App Store，直接搜索"DeepSeek"。

2. 认准开发者"杭州深度求索人工智能基础技术研究有限公司"，别下到山寨套壳软件。

3. 点获取，下载安装，打开后手机号登录，跟网页版账号互通。

方式3：安卓手机安装

安卓渠道分两种情况：

- 手机自带应用商店（华为、小米、OPPO、vivo 等）：直接搜"DeepSeek"下载官方包即可。

- 商店里搜不到或想用最新版：去 DeepSeek 官网下载官方 APK 安装包，传到手机上点击安装；第一次安装需要在系统设置里允许"安装未知来源应用"。安装完记得关掉这个权限，安全第一。

注意：APK 只从官网下，乱七八糟的第三方下载站容易被捆垃圾软件。

方式4：电脑桌面使用

Windows 和 Mac 用户，最方便的有两条路：

- 直接用网页版，效果和桌面客户端几乎一样。

- 想要独立窗口、更好的本地体验，可以先看后面第三部分：安装 Cherry Studio 或 ChatBox 这类第三方桌面客户端，再接入 DeepSeek API，体验比网页版还顺手。

方式5：浏览器插件 / 输入法侧边栏

部分 AI 浏览器、输入法插件内置了 DeepSeek 通道，在插件市场搜索"DeepSeek"，按提示登录官方账号就能在浏览器侧边栏随时调用，适合一边浏览网页一边复制问题提问。

三、进阶必做：注册开放平台 + 领取 API Key + 充值

想把小肥鱼接进 Cherry Studio、NextChat、编程工具这些第三方软件，必须走这一步。整个过程十分钟以内。

第1步：注册开放平台账号

1. 浏览器打开 DeepSeek 开放平台（platform.deepseek.com）。

2. 用和 App 一样的手机号登录，新用户按提示完成注册。

3. 首次进入会让你阅读用户协议，勾选同意即可。

第2步：创建 API Key

1. 登录后，在左侧菜单找到"API Keys"（API 密钥）。

2. 点"创建 API Key / 创建新密钥"，给密钥起个名字，比如"我的电脑客户端"，方便以后区分用途。

3. 创建成功后，页面会弹出一串以 sk- 开头的密钥。这串字符只显示这一次，关掉窗口就再也看不到了，立刻复制粘贴到备忘录或记事本里保存好。

4. Key 等于你的账户钥匙，任何人拿到它都能花你账户里的额度，千万别发到群里、截图发网上。泄露了就回这个页面把旧 Key 删除，重新建一个。

第3步：充值（最低1元即可开通调用）

1. 在平台里找到"充值 / 用量管理"。

2. 第一次使用 API，需要充值任意金额，最低 1 元就能开通调用资格，不用充一大笔。

3. 充值后在"用量"页面可以实时看到每次调用消耗了多少 token、剩多少钱，方便控制成本。

计费小提示：DeepSeek 采用峰谷定价，闲时价格是高峰时段的一半；同样的模型，任务不着急可以安排在价格低的时段跑，能省不少钱。缓存命中也会大幅降价，反复问相似问题时费用会低很多。

先记住三个关键参数（后面所有工具都用这一套）

不管接哪个软件，要填的东西基本就这三样：

- 接口地址（Base URL，OpenAI 格式）：https://api.deepseek.com

- 接口地址（Anthropic 格式）：https://api.deepseek.com/anthropic

- API Key：你刚保存的 sk- 开头那串

- 模型名：日常聊天填 deepseek-flash；复杂推理、写代码填 deepseek-v4-pro。

四、接入主流平台手把手教程（重点部分）

1. 接入 Cherry Studio（Windows / Mac 最推荐的桌面客户端）

Cherry Studio 是目前国内用得最多的开源 AI 桌面客户端，界面清爽，自带 DeepSeek 专属配置入口。

安装：去 Cherry Studio 官方网站下载对应系统版本（Windows 选 .exe，Mac 选 dmg），安装后打开。

配置步骤：

1. 点左下角"设置"，进入"模型服务"。

2. 在服务商列表里找到 DeepSeek，点进去。

3. "API 密钥"那一栏，粘贴你的 sk- 开头 Key。

4. "API 地址"保持默认 https://api.deepseek.com，不用改。

5. 点"获取模型列表"，软件会自动把 deepseek-flash、deepseek-v4-pro 拉下来。

6. 回到对话页面，顶部模型选择器挑一个模型，发一句"你好"测试，能正常回复就说明接好了。

模型怎么选：日常问答、写文案、翻译、总结用 deepseek-flash；写代码、解数学题、做长文档深度分析用 deepseek-v4-pro。带联网图标的模型可以直接开原生联网搜索。

小提示：DeepSeek 本身没有自己的知识库嵌入模型，如果你想在 Cherry Studio 里建本地知识库，嵌入模型可以另外选其他服务商的，对话模型继续用 DeepSeek 就行。

2. 接入 NextChat（ChatGPT Next Web，网页 / 自部署）

NextChat 是经典的开源聊天前端，很多人自己搭网页站给朋友用，也有很多在线版本。

在线版配置：

1. 打开 NextChat 页面，进入"设置 → 模型服务 / 自定义模型"。

2. 服务商选择"自定义 / OpenAI 兼容"。

3. 接口地址填 https://api.deepseek.com（注意有些版本要求末尾带 /v1，填的时候看页面示例）。

4. API Key 填你的 sk- 密钥。

5. 模型名称手动填：deepseek-flash 或 deepseek-v4-pro，保存。

6. 新建对话，选好模型测试。

自部署用户：在 .env 环境变量里把 OPENAI_API_KEY 填成 DeepSeek Key，把接口地址指向 https://api.deepseek.com，模型名按上面填，重启服务即可。

3. 接入 ChatBox（轻量桌面客户端）

ChatBox 体积小、启动快，适合不想要复杂功能的用户。

1. 打开 ChatBox，进入"设置 → AI 提供商"。

2. 提供商选择"DeepSeek"；如果列表里没有，就选"OpenAI 兼容 / Custom"。

3. API 密钥粘贴 sk- Key；API 地址填 https://api.deepseek.com。

4. 模型选择 deepseek-flash（或手动输入 deepseek-v4-pro）。

5. 保存后回到聊天窗口测试一句话。

4. 接入 Claude Code（命令行 AI 编程工具）

程序员最关心的部分来了。Claude Code 可以把后端模型换成 DeepSeek，等于用小肥鱼在终端里写代码。

前置条件：电脑装好 Node.js 18 以上版本；Windows 用户需要先安装 Git for Windows。

安装 Claude Code：

打开终端（Mac 用终端，Windows 用 PowerShell 或 CMD），执行：

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

装完输入 claude --version，能显示版本号就说明安装成功。

切换到 DeepSeek 后端：

Mac / Linux 终端执行：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

export ANTHROPIC_AUTH_TOKEN=你的DeepSeek API Key

export ANTHROPIC_MODEL=deepseek-v4-pro

Windows PowerShell 执行：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

$env:ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"

$env:ANTHROPIC_MODEL="deepseek-v4-pro"

然后在项目文件夹里运行 claude，就能让 DeepSeek 在命令行里帮你读代码、写功能、改 bug 了。写代码用 v4-pro，速度优先的简单任务可以换 deepseek-flash 省钱。

5. 接入 GitHub Copilot 与 Copilot CLI

图形界面版：打开 VS Code 或 IDE 里的 Copilot Chat（快捷键 Ctrl+Shift+I / Cmd+Shift+I），点聊天面板右上角模型选择器，直接选择 DeepSeek V4 Pro 或 DeepSeek V4 Flash，即可开始对话。

Copilot CLI 命令行版：在终端设置以下环境变量：

export COPILOT_PROVIDER_TYPE=anthropic

export COPILOT_PROVIDER_BASE_URL=https://api.deepseek.com/anthropic

export COPILOT_PROVIDER_API_KEY=你的DeepSeek API Key

export COPILOT_MODEL=deepseek-v4-pro

Windows PowerShell 对应改成 $env: 开头的写法，和上面 Claude Code 一样。配置完成后启动 Copilot CLI 即可使用。

6. 其他兼容 OpenAI 格式的工具（通用万能配置法）

Obsidian 插件、各种聊天机器人、网页脚本、自己开发的小工具……只要软件支持"自定义 OpenAI 接口"，全都能这么填：

- 服务商类型：OpenAI 兼容 / OpenAI-Compatible

- API 地址：https://api.deepseek.com

- API Key：sk- 你的密钥

- 模型：deepseek-flash 或 deepseek-v4-pro

99% 的工具这一套参数通用，区别只在界面按钮名字不一样。填完发一条测试消息，通了就完事。

五、开发者：直接写代码调用（Python / Node.js）

如果你要自己在程序里调 DeepSeek，下面是两套最小可用示例。

Python 版本

先装 SDK：pip3 install openai

然后这样写：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get('DEEPSEEK_API_KEY'),
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "你是一个有用的助手"},
        {"role": "user", "content": "你好，介绍一下你自己"},
    ],
    stream=False,
)

print(response.choices[0].message.content)

需要深度思考时，可以在请求里带上 thinking 与 reasoning_effort 参数；想要流式输出（像网页版那样一个字一个字蹦出来），把 stream 改成 True，按流式接口读取即可。

Node.js 版本

npm install openai，代码骨架：

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: 'https://api.deepseek.com',
  apiKey: process.env.DEEPSEEK_API_KEY,
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "user", content: "你好" }],
    model: "deepseek-flash",
  });
  console.log(completion.choices[0].message.content);
}

main();

Anthropic SDK 生态的开发者，把 base_url 换成 https://api.deepseek.com/anthropic，其他调用方式保持不变即可，官方已经做了格式兼容。

六、两个模型到底怎么选？价格怎么省？

很多人接好了软件，却不知道每次提问该选哪个模型，这里给个直白建议：

选 deepseek-flash 的场景：日常聊天、写朋友圈文案、邮件润色、翻译、总结文章、客服问答、头脑风暴。速度快、延迟低、价格便宜，绝大多数日常需求这一个就够了。

选 deepseek-v4-pro 的场景：写代码并调试、复杂数学与逻辑推理、长文档深度分析、方案设计、难题攻坚。愿意多等一会儿、追求答案质量时再用。

省钱技巧：

1. 简单任务别硬上 Pro，白白多花钱。

2. 不着急的批量任务，放到闲时运行，单价直接减半。

3. 重复提问相似内容时，利用上下文缓存，缓存命中部分价格大幅降低。

4. 在开放平台用量页面定期查看余额和消耗曲线，发现异常调用及时检查是不是 Key 泄露被人盗刷。

七、常见报错与排查清单（卡住先看这里）

教程写到这，把大家最容易踩的坑集中列出来，对照排查就能解决八成问题。

1. 报 401 / Unauthorized / 无效的密钥：先检查 Key 有没有复制全（sk- 开头一长串不能少字符）；前后有没有多空格；账户是否已经充值；Key 是否在后台被删除。都没问题就重新创建一个 Key 替换。

2. 提示余额不足 / insufficient balance：去开放平台充值；检查是不是选了高单价模型；看看用量页面有没有异常消耗。

3. 模型不存在 / model not found：模型名拼错了。正确写法是 deepseek-flash 和 deepseek-v4-pro，注意横杠和小写；旧模型名已经下线，不要再填 deepseek-v4-flash 之类的老名字。

4. 接口地址填错导致连不上：OpenAI 格式填 https://api.deepseek.com；Anthropic 格式（Claude Code、Copilot CLI）填 https://api.deepseek.com/anthropic，两套地址别混用。

5. 网络超时 / 一直转圈：先确认本机网络正常；公司内网、代理环境下可能拦截了接口域名，关掉代理或换网络测试；服务器部署的检查防火墙和出网规则。

6. 回复前面一大段思考过程：这是深度思考模型的正常行为，思考内容可以在客户端设置里折叠，不影响最终答案。

7. 软件能登录官方账号，但接 API 不通：官方账号密码和开放平台 API Key 是两套东西，聊天账号登录不了 API，必须用 sk- 密钥。

八、最后几句实在提醒

第一，只从官网下载客户端和 APK，市面上一堆套壳 App 偷 Key、盗额度，越是"破解版""免费无限用"越要警惕。

第二，Key 当密码保管，不要贴进公开文档、聊天群、截图里；项目代码上传 Git 仓库前，记得把 Key 挪到环境变量或配置文件里，别硬编码提交上去。

第三，这次 V5 测试文件曝光说明新版本已经在路上，等正式发布后，你现在配好的 Cherry Studio、NextChat、编程工具基本不用动，只需要在模型列表里把模型换成新版即可。

DeepSeek 这只蓝色小肥鱼，从网页聊天到写代码、接平台、做自己的 AI 应用，门槛其实已经压得很低了。按照这篇教程走一遍，从安装到接入一条龙就能搞定。哪一步卡住了，对照第七部分的报错清单查一遍，基本都能自己解决。