好文集ChatGPT Plus¥119

国产模型的神 DeepSeek,从0到1 上手项目开发

文章目录

部分视频或图片暂未收录,已在正文保留提示;需要时可查看原文。查看原文 ↗

今天来看 DeepSeek,从0到1 教会你认识deepseeek,并且做一个小项目,新手小白上手无压力!

DeepSeek 这两个月动作很密: 8 月更新了 V4-Pro,10 月把 Flash 升到了 V4.1,还开源了自己的 Agent 工具 Harness,11 月初又放出一个会自己盯群聊干活的 Super-Agent。

模型便宜、接口兼容、工具开源——想低成本做项目,现在是上手的好时候。

本篇目录:

  1. DeepSeek 是什么·能做什么

  2. 有哪几个模型·怎么选

  3. 为什么这么便宜

  4. 注册·拿 API Key

  5. 写文章:直接用网页和 App

  6. 写代码:接进 Claude Code,或者用 Harness

  7. 接口使用:自己写程序调

  8. 实战:从 0 到 1 做一个小项目

  9. 常见坑

  10. 往后看:Super-Agent

前五节零基础就能看,第六节开始要用到终端。


一、DeepSeek 是什么·能做什么

DeepSeek 是杭州深度求索公司做的大模型,和 ChatGPT、Claude 是同一类东西。deepseek.com

文章配图

它有三个特点,放在一起就是别人很难替代的地方:

  • 便宜:API 按百万 token 算,最便宜的一档不到 1 美元(第三节有价格表)

  • 开源:模型权重公开,能下载下来自己部署

  • 兼容:接口同时兼容 OpenAI 和 Anthropic 两种格式,别人家的工具改个地址就能用

能做的事分三类,后面各占一节:

  • 写东西:文章、文案、翻译、总结长文档 → 第五节

  • 写代码:让 Agent 读项目、改代码、跑测试 → 第六节

  • 做产品:把它接进你自己的网站、脚本、机器人 → 第七节

普通用户用网页版和 App,免费。 开发者用 API,按用量付费。

怎么用地址收费
网页版chat.deepseek.com免费
手机 App应用商店搜 DeepSeek免费
APIplatform.deepseek.com按 token 计费
Harness 桌面版deepseek.com/en/harness软件免费,模型按 API 计费

Token 可以理解成「字数」,模型按读了多少、写了多少收钱。


二、有哪几个模型·怎么选

文章配图

API 里现在只有两个模型名,很好记:

模型名实际版本定位
deepseek-flashDeepSeek-V4.1-Flash-1017快、便宜,日常主力
deepseek-v4-proDeepSeek-V4-Pro-0813更强,贵三四倍

两个都是 1M 上下文——一次能塞进去大约一百万 token,几十个代码文件、一整本书都放得下。 单次最多输出 384K。

怎么选:

  • 写文章、问答、日常写代码 → deepseek-flash

  • 复杂的架构设计、难啃的 Bug → deepseek-v4-pro

  • 要传图片 → 只能用 deepseek-flash,Pro 不处理图片

两个模型都有「思考模式」:先在内部推理一遍再回答,慢一点,但难题答得更准。API 里加一个参数就能开,后面第七节有写法。

注意:以前的 deepseek-v4-flash 这个名字还能用,但背后的模型已经退役,请求会自动转给 V4.1 Flash。新项目直接写 deepseek-flash。


三、为什么这么便宜

文章配图

先看价格,单位是美元 / 每百万 token:

FlashPro
输入(缓存命中)0.003 – 0.0060.022 – 0.044
输入(缓存未命中)0.15 – 0.30.66 – 1.32
输出0.6 – 1.21.98 – 3.96

每一格两个数,前面是闲时价,后面是高峰价。闲时刚好打五折。

便宜的原因有三层。

1. 每次只动一小部分参数

DeepSeek 用的是 MoE 架构(混合专家)。 简单说,模型里养了几百个「专家」,每个字只叫其中几个来干活,其他人歇着。

按 V4 技术报告的数:

  • V4-Flash 总共 2840 亿参数,每个 token 只激活 130 亿

  • V4-Pro 总共 1.6 万亿参数,每个 token 只激活 490 亿

总参数决定它懂多少,激活参数决定每次算多少——后者小,电费就低。

2. 长文本不用逐字回看

普通模型每写一个字,都要把前面所有内容重新看一遍。上下文越长,越慢越贵。

V4 换了一种「压缩 + 挑重点」的看法:把前文压缩,只挑最相关的那部分细看。 NVIDIA 的模型卡给了一个数:在 1M 上下文下,每个 token 的计算量只有上一代 V3.2 的 27%。

3. 重复的内容只收一次钱

缓存命中的价格,是未命中的五十分之一左右。

什么叫命中:这次请求的开头,和之前某次请求的开头一模一样。 比如每次都带同一段系统提示、同一批项目文件,这部分第二次起就按缓存价算。

写代码的 Agent 每一轮都会把整个对话重新发一遍,命中率很高。这也是 DeepSeek 跑 Agent 特别省钱的原因。

再加上高峰期以外半价,账单还能再砍一刀。


四、注册·拿 API Key

只用网页版和 App 的话,手机号注册就行,这一节可以跳过。超级省钱非订阅制,用多少花多少!

文章配图

要写代码、调接口,需要 API Key:

  1. 打开 platform.deepseek.com,注册登录

  2. 先充值,余额为零调不通

  3. 找到 API Keys 页面,点创建

  4. 复制下来存好——这串 key 只显示一次,关掉页面就看不到了

API Key 等于你账户的钥匙,谁拿到谁就能花你的钱。别发群里,别传到 GitHub。

在电脑上存成环境变量,后面几节都会用到:

# Mac / Linux,写进 ~/.zshrc 后重开终端
export DEEPSEEK_API_KEY="sk-你的key"
# Windows PowerShell
$env:DEEPSEEK_API_KEY="sk-你的key"

五、写文章:直接用网页和 App

写文章、改文案、做翻译,不用碰 API,网页版就够了。

打开 chat.deepseek.com,直接说需求。

文章配图

说得越具体,出来的东西越能用:

帮我写一篇小红书笔记,主题是「新手怎么选第一台咖啡机」。
读者:刚工作、预算 2000 以内。
要求:口语化,600 字以内,开头一句话抓人,结尾给 3 个具体型号建议。

几个让结果变好的小办法:

  • 给读者:写给谁看,决定用词深浅

  • 给字数:不给字数,它会写得又长又空

  • 给例子:贴一段你喜欢的文风,让它照着写

  • 难题开思考模式:输入框附近有「深度思考」之类的开关,打开后会先推理再写

1M 的上下文在这里也有用——一整份报告、一本电子书直接丢进去,让它总结、提问、改写。


六、写代码:接进 Claude Code,或者用 Harness

先把 Agent 讲清:普通聊天是你问一句它答一句;Agent 是你给一个任务,它自己读文件、写代码、跑命令、看结果,一直做到完成。

写代码用 Agent,有两条路:

接进 Claude CodeDeepSeek Harness
是谁做的Anthropic 做工具,DeepSeek 出模型DeepSeek 全套
界面终端桌面版 / 网页 / 终端
成熟度正式版开发者预览
适合已经会用终端、用过 Claude Code想要图形界面、想玩插件

api-docs.deepseek.com/zh-cn

文章配图

方法一:接进 Claude Code

Claude Code 是目前用的人最多的编程 Agent 之一。不用换工具,把背后的模型换成 DeepSeek 就行。

原理是第一节说的「兼容」:DeepSeek 提供了一个 Anthropic 格式的接口,Claude Code 以为自己在跟 Claude 说话,其实对面是 DeepSeek。

还没装 Claude Code

# 需要 Node.js 18 以上;Windows 还要先装 Git for Windows
npm install -g @anthropic-ai/claude-code   # 安装
claude --version                           # 出现版本号就是装好了

换成 DeepSeek

简单可以用 cc-switch. https://github.com/farion1231/cc-switch

文章配图

手动配置:下面是 DeepSeek 官方文档给的配置,原样照抄。

Mac / Linux:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic   # 接口地址换成 DeepSeek
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API Key>            # 填你的 DeepSeek key
export ANTHROPIC_MODEL=deepseek-flash[1m]                      # 主模型,[1m] 表示开 1M 上下文
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash               # 子 Agent 用的模型
export CLAUDE_CODE_EFFORT_LEVEL=max                            # 推理力度拉满
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432                  # 上下文到这么长才自动压缩

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<your DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

然后进项目目录启动:

cd /path/to/my-project   # 换成你的项目路径
claude

想用 Pro,把上面的 deepseek-flash 换成 deepseek-v4-pro。

注意:export 只在当前终端窗口有效,关掉就没了。想一直用,写进 ~/.zshrc。 想切回 Claude,开一个没设这些变量的新窗口就行。

方法二:DeepSeek Harness

Harness 是 DeepSeek 自己做的开源 Agent 工具,2026 年开放开发者预览,MIT 许可。

Claude Code、Codex 都是这一类。Harness 是 DeepSeek 自家的,不想碰终端的可以直接装桌面版。 链接: www.deepseek.com/harness

文章配图

能干什么

官网列了四类:

  • 日常工作:整理文件、分析数据、写文档、做幻灯片

  • 编程:读代码仓库、修 Bug、写新功能、跑测试

  • 研究:查资料、核实、标出处

  • 后台任务:跑脚本、批量处理文件、定时任务(比如每周五下午五点自动出周报)

它的设计思路是「一切皆插件」——模型、工具、Agent 的循环逻辑都能换。 官方给了一批实验性插件:多 Agent 协作、自动审批、定时任务、语音输入、终端、子 Agent。

还有一个 Creator mode:用对话的方式让它给自己写新插件。

怎么装

方法一:桌面版,最省事。 去 deepseek.com/en/harness 下载安装包,有 macOS(Apple 芯片)和 Windows 64 位两个版本。

方法二:一行命令,装了 Node.js 就能跑:

npx @deepseek-ai/dsh web   # 下载并启动网页界面

启动后自动打开浏览器,地址是 http://127.0.0.1:3080。

方法三:从源码装,想改代码的人用:

git clone https://github.com/deepseek-ai/deepseek-harness.git   # 下载源码
cd deepseek-harness
pnpm install       # 装依赖
pnpm run build     # 构建
pnpm dsh web       # 启动

注意:仓库首页原文写着 THERE WILL BE COMPATIBILITY-BREAKING CHANGES——还在预览期,后面会有不兼容的改动。升级前看一眼更新说明。


七、接口使用:自己写程序调

文章配图

做自己的产品——网站里的 AI 客服、批量改写文案的脚本、自动回复机器人——就要直接调 API。

两个地址:

格式base_url
OpenAI 格式https://api.deepseek.com
Anthropic 格式https://api.deepseek.com/anthropic

用哪个格式都行。手上的代码原来是接 OpenAI 的,就用第一个;原来接 Claude 的,就用第二个。

curl:先确认能通

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

返回一段 JSON,里面有模型的回答,就是通了。

Python:OpenAI SDK

pip install openai   # 装官方 SDK,DeepSeek 直接兼容
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],   # 从环境变量读 key,别写死在代码里
    base_url="https://api.deepseek.com",      # 只改这一行,就从 OpenAI 换成了 DeepSeek
)

resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "你是一个小红书文案助手"},
        {"role": "user", "content": "写三个关于咖啡机的标题"},
    ],
    extra_body={"thinking": {"type": "enabled"}},   # 开思考模式,不需要就删掉这行
)

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

思考模式还能配一个 reasoning_effort,填 "high" 想得更深,也更慢更贵。

顺带:搜索和抓网页

10 月 DeepSeek 还开了 Search(搜索)和 Fetch(抓网页)两个接口,按次收费,每 1000 次成功请求 0.75 美元。 做需要联网查资料的 Agent,可以不用再接第三方搜索。


八、实战:从 0 到 1 做一个小项目

前面七节是零件,这一节把它们串起来,完整做一个能用的东西。

做什么:一个批量改写标题的小脚本。 把一堆旧标题放进 titles.txt,脚本逐条调 DeepSeek,改写成小红书风格,结果存进 result.csv,Excel 直接能打开。

用到的:第四节的 API Key、第六节的 Claude Code + DeepSeek、第七节的接口。 要准备:Python 3、Claude Code、已充值的 DeepSeek 账户。

1. 建项目文件夹

mkdir title-rewriter   # 新建项目文件夹
cd title-rewriter
claude                 # 启动 Claude Code,背后是第六节配好的 DeepSeek

文章配图

2. 把需求说清楚

直接把下面这段丢给它:

帮我写一个 Python 脚本 rewrite.py:
1. 读取同目录下的 titles.txt,每行一个标题,如果没有这个文件就新建,随机写几个AI自媒体标题
2. 逐条调用 DeepSeek API(模型 deepseek-flash,base_url 用 https://api.deepseek.com),
   把标题改写成小红书风格,每条给 3 个版本
3. API Key 从环境变量 DEEPSEEK_API_KEY 读取,不要写死在代码里
4. 结果保存成 result.csv,列为:原标题、版本1、版本2、版本3
5. 某一条调用失败时跳过并打印原因,不要整个脚本中断
顺便生成一个 titles.txt,放 5 条示例标题,然后运行一次给我看结果。

需求写成编号清单,Agent 不容易漏。 第 3 条和第 5 条是新手最容易忘的:一个防 key 泄露,一个防跑到一半崩掉。

3. 看它干活

它会自己建文件、写代码、装依赖、运行。

每一步执行命令前会问你要不要允许,看一眼再点同意。

媒体暂未收录,可在原文中查看

4. 检查结果

根据执行效果 新建窗口运行查看结果, 密钥去deepseek 后台申请。

cd /Users/xiao1024/Code/demo/title-rewriter
export DEEPSEEK_API_KEY=sk-你的密钥 
python3 rewrite.py

打开 result.csv,看改写得怎么样。

文章配图

5. 不满意就接着提

遇到脚本出错,原因:deepseek-flash 是推理模型,它把 512 个 token 全花在"思考"上了,最终答案字段 content 返回的是空字符串,脚本拿不到内容,就判定这条失败并跳过——5 条全这样,所以 result.csv 只剩表头。 直接让AI 帮你修改就是了,不要手动了!

不用自己改代码,直接说:

改写风格再吸引人一点,让人有点击的欲望,每条标题控制在  30字左右。 加上 /你的路径/result.csv 

文章配图

6. 看花了多少钱

做完某个任务,你可以回 platform.deepseek.com 看用量,花了多少,但deepseek 非常省钱不用担心。

本次只是简单演示,如何使用deepseek 做一点工作,多用你就会越来越得心应手!

做完这一个,换成你自己的需求——批量写商品描述、批量翻译、批量回评论——套路是一样的。


九、常见坑

文章配图

坑一:工作日白天是高峰价。 高峰时段是 UTC 01:00–04:00 和 06:00–10:00,周一到周五。 换成北京时间,就是工作日上午 9 点到 12 点、下午 2 点到 6 点。 这两段贵一倍。批量跑的任务,放到晚上或周末,账单直接减半。

坑二:缓存要「开头一样」才命中。 系统提示里放了当前时间、随机数,每次开头都不一样,缓存就全废了。 固定不变的内容放最前面,会变的放后面。

坑三:Pro 看不了图。 给 deepseek-v4-pro 传图片,图片会被换成一段文字占位符,不会报错——模型根本没看到图,回答却照样给你。 有图的任务用 deepseek-flash。

坑四:Anthropic 格式不是百分百兼容。 cache_control、citations 这些字段会被直接忽略,document 类型的内容块不支持。 从 Claude 迁过来的代码,用了这些功能的要单独测一遍。

坑五:API Key 泄露。 key 写死在代码里传上 GitHub,很快就会被扫描程序扫走盗刷。 一律用环境变量,.env 文件加进 .gitignore。

坑六:Harness 和 Super-Agent 都还在早期。 一个是开发者预览,一个是研究原型。版本更新可能改坏配置,重要项目先固定版本号。


十、往后看:Super-Agent

文章配图

这一节不是上手必需的,是看 DeepSeek 下一步往哪走。

11 月初,DeepSeek 在 GitHub 放出了 dsh-superagent-prototype。

https://github.com/deepseek-ai/dsh-superagent-prototype

前面的 Agent 都是你叫一声它动一下。 Super-Agent 不一样:它守着一个 GitHub 仓库和团队群聊,看到有人提需求就自己接活,写代码、跑测试、提 PR(合并请求),最后由人审核合并。

DeepSeek Harness 团队在 10 月 31 日的文章里讲了为什么要做它:一个人同时盯着的 Agent 会话,通常也就三到五个。再多就顾不过来,所以干脆让一个 Agent 负责接需求、分派活。

几个关键设定

  • 谁能派活:只有名单上的人可以;群里的消息、引用的文档,都没法扩大它的权限

  • 默认很保守:没被点名的消息,它只记下「这个我本来会接」,一个都不真接。看过记录、放心了,再切到自动模式

  • 默认不自动合并:GitHub 会把合并记在开启自动合并的那个账号头上,所以默认留给人来合

  • 支持的平台:GitHub,加上可选的飞书

怎么装

README 没有给逐条命令,给的是一句话——让你的编程 Agent 去读安装文档,跟你一起装:

Read https://github.com/deepseek-ai/dsh-superagent-prototype/blob/main/SETUP.md in this repository and set up dsh-superagent with me.

把这句丢给 Claude Code 或 Harness,它会一步步带你配。

注意: 仓库首页原文 Research prototype for reference only, not an official DeepSeek product. ——仅供参考的研究原型,不是 DeepSeek 官方产品。 它还写明可能有 Bug,和 DeepSeek 内部版本也不完全一样。拿来学思路可以,接生产仓库要先自己审一遍。


附录:来源


最后

如果你用不了Claude或者Codex , 国内强烈推荐Workbuddy 和 Deepseek!

Deepseek 非常简洁明了,模型就两个,目前只有API付费使用,用多少付多少,我是用来做替补的,文章、代码都可以,大半年一直用才不到300块。

本人优秀文章精选

超详细Codex上手教程,从入门到精通

超简单 Grok Bot ,入门到一键构建机器人团

从0到1 构建AI 知识工作流,Obsidian笔记入门

超简单剪映使用,从小白到用Skill,剪辑第一个爆款视频

Codex 自媒体运营 Skill 大全|20 个装完,一个人顶一个团队

出海基础设施系列文章:

Giffgaff 购买激活使用大全,及账号被封如何退款?

Wise 入门到精通|2026年10月亲测,个人可申请港户和美户

出海手机卡 RedPocket 使用大全,从0到1 获取美国原生IP

我是想风@xaiwind,一个关注出海与 AI、AIGC 的创作者。

本文基于AI辅助与个人实践融合创作,如果文章对你有帮助,欢迎点赞、收藏、关注。

本人文章持续维护,欢迎联系或者评论区见,每天进步一点,我们终会到达目的地!

文章配图

全文完
查看原文

沿着这个主题继续读

从一篇文章,找到相关的教程、经验和阅读路径。

DeepSeek 与国产大模型DeepSeek、豆包、Kimi、Qwen、MiniMax 等国产大模型的实测、Agent 用法与本地部署。