国产模型的神 DeepSeek,从0到1 上手项目开发
文章目录
部分视频或图片暂未收录,已在正文保留提示;需要时可查看原文。查看原文 ↗
今天来看 DeepSeek,从0到1 教会你认识deepseeek,并且做一个小项目,新手小白上手无压力!
DeepSeek 这两个月动作很密: 8 月更新了 V4-Pro,10 月把 Flash 升到了 V4.1,还开源了自己的 Agent 工具 Harness,11 月初又放出一个会自己盯群聊干活的 Super-Agent。
模型便宜、接口兼容、工具开源——想低成本做项目,现在是上手的好时候。
本篇目录:
-
DeepSeek 是什么·能做什么
-
有哪几个模型·怎么选
-
为什么这么便宜
-
注册·拿 API Key
-
写文章:直接用网页和 App
-
写代码:接进 Claude Code,或者用 Harness
-
接口使用:自己写程序调
-
实战:从 0 到 1 做一个小项目
-
常见坑
-
往后看:Super-Agent
前五节零基础就能看,第六节开始要用到终端。
一、DeepSeek 是什么·能做什么
DeepSeek 是杭州深度求索公司做的大模型,和 ChatGPT、Claude 是同一类东西。deepseek.com
它有三个特点,放在一起就是别人很难替代的地方:
-
便宜:API 按百万 token 算,最便宜的一档不到 1 美元(第三节有价格表)
-
开源:模型权重公开,能下载下来自己部署
-
兼容:接口同时兼容 OpenAI 和 Anthropic 两种格式,别人家的工具改个地址就能用
能做的事分三类,后面各占一节:
-
写东西:文章、文案、翻译、总结长文档 → 第五节
-
写代码:让 Agent 读项目、改代码、跑测试 → 第六节
-
做产品:把它接进你自己的网站、脚本、机器人 → 第七节
普通用户用网页版和 App,免费。 开发者用 API,按用量付费。
| 怎么用 | 地址 | 收费 |
|---|---|---|
| 网页版 | chat.deepseek.com | 免费 |
| 手机 App | 应用商店搜 DeepSeek | 免费 |
| API | platform.deepseek.com | 按 token 计费 |
| Harness 桌面版 | deepseek.com/en/harness | 软件免费,模型按 API 计费 |
Token 可以理解成「字数」,模型按读了多少、写了多少收钱。
二、有哪几个模型·怎么选
API 里现在只有两个模型名,很好记:
| 模型名 | 实际版本 | 定位 |
|---|---|---|
deepseek-flash | DeepSeek-V4.1-Flash-1017 | 快、便宜,日常主力 |
deepseek-v4-pro | DeepSeek-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:
| Flash | Pro | |
|---|---|---|
| 输入(缓存命中) | 0.003 – 0.006 | 0.022 – 0.044 |
| 输入(缓存未命中) | 0.15 – 0.3 | 0.66 – 1.32 |
| 输出 | 0.6 – 1.2 | 1.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:
-
打开 platform.deepseek.com,注册登录
-
先充值,余额为零调不通
-
找到 API Keys 页面,点创建
-
复制下来存好——这串 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 Code | DeepSeek 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 内部版本也不完全一样。拿来学思路可以,接生产仓库要先自己审一遍。
附录:来源
-
DeepSeek API 文档(模型、价格、高峰时段、接口格式):https://api-docs.deepseek.com/
-
接入 Claude Code:https://api-docs.deepseek.com/quickstart/agentintegrations/claude_code
-
DeepSeek Harness 官网:https://www.deepseek.com/en/harness/
-
DeepSeek Harness 仓库:https://github.com/deepseek-ai/deepseek-harness
-
Super-Agent 仓库:https://github.com/deepseek-ai/dsh-superagent-prototype
-
V4 技术报告(参数、注意力机制):https://arxiv.org/abs/2606.19348
最后
如果你用不了Claude或者Codex , 国内强烈推荐Workbuddy 和 Deepseek!
Deepseek 非常简洁明了,模型就两个,目前只有API付费使用,用多少付多少,我是用来做替补的,文章、代码都可以,大半年一直用才不到300块。
本人优秀文章精选
Codex 自媒体运营 Skill 大全|20 个装完,一个人顶一个团队
出海基础设施系列文章:
Wise 入门到精通|2026年10月亲测,个人可申请港户和美户
出海手机卡 RedPocket 使用大全,从0到1 获取美国原生IP
我是想风@xaiwind,一个关注出海与 AI、AIGC 的创作者。
本文基于AI辅助与个人实践融合创作,如果文章对你有帮助,欢迎点赞、收藏、关注。
本人文章持续维护,欢迎联系或者评论区见,每天进步一点,我们终会到达目的地!
沿着这个主题继续读
从一篇文章,找到相关的教程、经验和阅读路径。


















