1. 为什么零基础也要把 Claude Code 接上 DeepSeekClaude Code 是 Anthropic 推出的终端 AI 编程助手它跟网页版聊天最大的区别是它直接跑在你的项目目录里能读写文件、执行命令、搜索代码像一个坐在你旁边的程序员。但它默认只连 Anthropic 官方模型价格高、还要外币卡对刚入门的人不太友好。DeepSeek 的出现让这件事变得简单它的模型在代码理解上表现稳定价格却低很多微信支付宝就能充值。把 Claude Code 的请求地址改到统一通道再指定 DeepSeek 的模型 ID你就能用熟悉的终端工具跑国产模型。这篇教程面向零基础开发者覆盖 Windows 和 Mac 两条路径。我会从装 Node.js 开始一步步带你拿到 API Key、写好 settings.json、跑通第一次对话。每一步都给出可复制的命令和自查动作你照着做就能确认自己有没有成功。适合谁没写过终端命令的学生、刚转行做开发的新人、想低成本体验 AI 编程的独立开发者。全程不需要你懂 JavaScript也不需要你理解什么是环境变量照着敲就行。我试过在 Windows 11 和 macOS 上各装一遍踩过的坑主要集中在 Node.js 版本太低、终端没刷新、Key 复制不完整这三处。下面按顺序讲你按顺序做半小时内能跑通。2. 前置准备Node.js 安装与 TaoToken 通道获取 API KeyClaude Code 是用 JavaScript 写的运行它必须先有 Node.js。这一步在 Windows 和 Mac 上略有不同但都不难。2.1 Windows 安装 Node.js打开浏览器访问 nodejs.org页面上有两个绿色按钮点左边那个标着 LTS 的版本长期支持版更稳定。下载下来是一个 .msi 安装包双击运行一路点 Next所有选项保持默认装完点 Finish。关键动作装完之后关掉所有已经打开的终端窗口包括 cmd、PowerShell、VS Code 里的终端然后重新打开一个新的。这一步很多人忽略导致后面敲 node -v 提示「不是内部或外部命令」。2.2 Mac 安装 Node.jsMac 用户如果装了 Homebrew直接在终端里执行brew install node没装 Homebrew 的话去 nodejs.org 下载 .pkg 安装包双击安装也一样。装完同样关掉旧终端重开一个。2.3 验证 Node.js 是否装好不管哪个系统重开终端后输入node -v npm -v正常应该看到 v20.x 或更高以及 10.x 或更高。如果 node -v 报错说明 Node.js 没装好或者终端没刷新重启电脑再试一次。2.4 安装 Claude Code 本体Node.js 就绪后在终端里执行npm install -g anthropic-ai/claude-code等 1 到 2 分钟。如果卡住不动先换国内镜像再重试npm config set registry https://registry.npmmirror.com装完验证claude --version能显示版本号就说明 Claude Code 装好了。2.5 获取 API KeyClaude Code 需要一个 API Key 才能发请求。这里我们用 TaoToken 统一通道它把 DeepSeek 等模型的调用统一到一个地址配置起来更省事。打开 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 注册登录后创建一个 API Key复制下来保存到记事本。这个 Key 通常只显示一次丢了就得重新建。拿到 Key 之后你手里应该有三样东西一个 API Key、一个 Base URL统一通道地址、一个 Model ID比如 deepseek 系列的模型名。这三件套后面写配置要用到。3. 可复制配置settings.json 完整写法与参数说明Claude Code 读取配置的位置是用户目录下的 .claude 文件夹。Windows 和 Mac 路径不同先找到它。Windows按 WinR输入%USERPROFILE%\.claude回车。如果文件夹不存在手动新建一个。Mac终端输入open ~/.claude没有的话mkdir ~/.claude建一个。在这个文件夹里新建一个文件名字叫settings.json。注意扩展名是 .json不是 .txt。Windows 用户如果看不到扩展名先在文件资源管理器的「查看」里勾上「文件扩展名」。把下面这段配置粘贴进去{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro } }逐条解释这些参数你改的时候心里有数参数作用你要改的地方ANTHROPIC_AUTH_TOKEN身份凭证换成你刚复制的真实 KeyANTHROPIC_BASE_URL请求发往的地址保持统一通道地址不变ANTHROPIC_MODEL默认使用的模型按你选的 DeepSeek 模型填ANTHROPIC_DEFAULT_HAIKU_MODEL轻量任务用的模型一般填快速版ANTHROPIC_DEFAULT_SONNET_MODEL中等任务用的模型填主力模型ANTHROPIC_DEFAULT_OPUS_MODEL复杂任务用的模型填能力最强的那个注意ANTHROPIC_AUTH_TOKEN 的值必须完整以 sk- 开头前后不要有空格。粘贴时容易多带一个换行建议粘完检查一遍。如果你用的是 Claude Code 的 coding-plan 场景配置结构一样只是模型 ID 换成套餐里对应的名字。保存文件时确认编码是 UTF-8Windows 记事本默认就是不用额外设置。保存后关掉所有终端窗口重新打开一个。这一步是为了让新的环境变量生效不重开的话 Claude Code 读的还是旧配置。4. 验证请求从版本检查到首次对话回显配置写好了现在逐条验证确保每一步都真的通了。4.1 版本与安装检查重开终端后先确认工具在claude --version有版本号输出说明 Claude Code 可执行文件在 PATH 里。4.2 连通性测试在终端里直接测一下统一通道能不能通curl -I https://taotoken.net/apiMac 和 Windows 10 以上都自带 curl。如果返回 HTTP 状态码比如 200、401、404 都算通说明网络能到达。如果提示连接超时检查你的网络或者换个时间再试。4.3 启动 Claude Code在终端输入claude第一次启动会看到欢迎界面。进去之后输入斜杠命令查看状态/status这里会显示当前使用的模型、Base URL 等信息。确认模型显示为你配置的 DeepSeek 模型名Base URL 显示为统一通道地址。4.4 首次对话回显发一句话测试你好请用中文回复并告诉我你是什么模型如果收到中文回复并且模型自报的身份跟你配置的一致说明整条链路通了。这一步的成功标志是有回复、是中文、模型名对得上。4.5 在真实项目里跑一次光聊天还不够Claude Code 的价值在项目里。cd 到你的代码目录比如cd ~/projects/demo claude然后让它做一件小事比如「列出当前目录下所有 .js 文件并说明每个文件的作用」。看它能不能读到文件、给出合理回答。能读到文件说明工作目录权限正常。5. 本篇常见错排查401、local proxy failed 与 reading choices装的过程中最容易卡在几个报错上我按真实遇到的顺序列出来你对号入座。5.1 启动报 401报错长这样API Error: 401 Unauthorized原因基本是 Key 不对。检查三处Key 是否完整复制有没有漏掉尾部字符、Key 前后有没有空格或换行、Key 是否已经失效或余额不足。改完 settings.json 后必须重开终端。5.2 local proxy failed报错类似local proxy failed to connect这通常是 Base URL 写错或者网络到不了统一通道。先确认 ANTHROPIC_BASE_URL 的值没有多余斜杠、没有拼错。再用 4.2 的 curl 命令测连通性。如果 curl 也不通就是网络问题不是配置问题。5.3 reading choices 相关报错报错里出现error reading choices: unexpected end of JSON input这多半是返回内容被截断或格式异常常见于模型 ID 填错、通道返回了非预期内容。检查 ANTHROPIC_MODEL 等几个模型名是否跟通道支持的名称完全一致大小写、连字符都不能错。5.4 OAuth 相关提示如果启动时提示要走 OAuth 登录OAuth authentication required说明 Claude Code 没读到你的 settings.json走了默认的官方登录流程。检查文件路径对不对必须是用户目录下的 .claude/settings.json、文件名对不对不是 settings.json.txt、JSON 格式有没有语法错误少逗号、多逗号都会导致解析失败。可以用在线 JSON 校验工具粘进去检查。5.5 node 或 claude 不是命令node 不是内部或外部命令 claude 不是内部或外部命令前者是 Node.js 没装好或终端没刷新重启电脑重装。后者是 Claude Code 没装成功重新执行 npm install -g anthropic-ai/claude-code或者检查 npm 全局路径有没有加到 PATH。5.6 只回英文模型默认可能用英文回复。直接在对话里说「请始终用中文回复」或者在项目根目录建一个 CLAUDE.md 文件写上语言偏好Claude Code 会读取它作为上下文。排查完这些基本没有跑不通的情况。如果还卡着把报错原文复制下来对照上面几条找最接近的。6. 后续怎么用模型对话、Coding Plan 与接入文档跑通之后你可以按需求选不同的使用方式。想先验证模型能力、随便聊聊用模型对话页面最直接https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。不用配终端打开就能试 DeepSeek 的回答质量。打算长期在项目里用 Claude Code 写代码、跑 Agent 任务看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。套餐里会说明支持的模型和额度按你的使用频率选。需要管理多个 Key、查看用量进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。Key 丢了或者要换都在这里操作。配置过程中想核对参数写法接入文档有完整说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。遇到模型 ID 不确定、Base URL 要不要带路径这类问题文档里能查到。如果你用的是 Claude Code 之外的终端工具比如 Cline、Codex配置逻辑一样Base URL 填统一通道地址Key 填你的 API KeyModel ID 填 DeepSeek 模型名。三件套对齐基本都能接上。最后提醒一句settings.json 改完一定要重开终端这是最高频的「配置没生效」原因。把这条记牢能省你不少排查时间。
1. 为什么零基础也要把 Claude Code 接上 DeepSeekClaude Code 是 Anthropic 推出的终端 AI 编程助手它跟网页版聊天最大的区别是它直接跑在你的项目目录里能读写文件、执行命令、搜索代码像一个坐在你旁边的程序员。但它默认只连 Anthropic 官方模型价格高、还要外币卡对刚入门的人不太友好。DeepSeek 的出现让这件事变得简单它的模型在代码理解上表现稳定价格却低很多微信支付宝就能充值。把 Claude Code 的请求地址改到统一通道再指定 DeepSeek 的模型 ID你就能用熟悉的终端工具跑国产模型。这篇教程面向零基础开发者覆盖 Windows 和 Mac 两条路径。我会从装 Node.js 开始一步步带你拿到 API Key、写好 settings.json、跑通第一次对话。每一步都给出可复制的命令和自查动作你照着做就能确认自己有没有成功。适合谁没写过终端命令的学生、刚转行做开发的新人、想低成本体验 AI 编程的独立开发者。全程不需要你懂 JavaScript也不需要你理解什么是环境变量照着敲就行。我试过在 Windows 11 和 macOS 上各装一遍踩过的坑主要集中在 Node.js 版本太低、终端没刷新、Key 复制不完整这三处。下面按顺序讲你按顺序做半小时内能跑通。2. 前置准备Node.js 安装与 TaoToken 通道获取 API KeyClaude Code 是用 JavaScript 写的运行它必须先有 Node.js。这一步在 Windows 和 Mac 上略有不同但都不难。2.1 Windows 安装 Node.js打开浏览器访问 nodejs.org页面上有两个绿色按钮点左边那个标着 LTS 的版本长期支持版更稳定。下载下来是一个 .msi 安装包双击运行一路点 Next所有选项保持默认装完点 Finish。关键动作装完之后关掉所有已经打开的终端窗口包括 cmd、PowerShell、VS Code 里的终端然后重新打开一个新的。这一步很多人忽略导致后面敲 node -v 提示「不是内部或外部命令」。2.2 Mac 安装 Node.jsMac 用户如果装了 Homebrew直接在终端里执行brew install node没装 Homebrew 的话去 nodejs.org 下载 .pkg 安装包双击安装也一样。装完同样关掉旧终端重开一个。2.3 验证 Node.js 是否装好不管哪个系统重开终端后输入node -v npm -v正常应该看到 v20.x 或更高以及 10.x 或更高。如果 node -v 报错说明 Node.js 没装好或者终端没刷新重启电脑再试一次。2.4 安装 Claude Code 本体Node.js 就绪后在终端里执行npm install -g anthropic-ai/claude-code等 1 到 2 分钟。如果卡住不动先换国内镜像再重试npm config set registry https://registry.npmmirror.com装完验证claude --version能显示版本号就说明 Claude Code 装好了。2.5 获取 API KeyClaude Code 需要一个 API Key 才能发请求。这里我们用 TaoToken 统一通道它把 DeepSeek 等模型的调用统一到一个地址配置起来更省事。打开 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 注册登录后创建一个 API Key复制下来保存到记事本。这个 Key 通常只显示一次丢了就得重新建。拿到 Key 之后你手里应该有三样东西一个 API Key、一个 Base URL统一通道地址、一个 Model ID比如 deepseek 系列的模型名。这三件套后面写配置要用到。3. 可复制配置settings.json 完整写法与参数说明Claude Code 读取配置的位置是用户目录下的 .claude 文件夹。Windows 和 Mac 路径不同先找到它。Windows按 WinR输入%USERPROFILE%\.claude回车。如果文件夹不存在手动新建一个。Mac终端输入open ~/.claude没有的话mkdir ~/.claude建一个。在这个文件夹里新建一个文件名字叫settings.json。注意扩展名是 .json不是 .txt。Windows 用户如果看不到扩展名先在文件资源管理器的「查看」里勾上「文件扩展名」。把下面这段配置粘贴进去{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro } }逐条解释这些参数你改的时候心里有数参数作用你要改的地方ANTHROPIC_AUTH_TOKEN身份凭证换成你刚复制的真实 KeyANTHROPIC_BASE_URL请求发往的地址保持统一通道地址不变ANTHROPIC_MODEL默认使用的模型按你选的 DeepSeek 模型填ANTHROPIC_DEFAULT_HAIKU_MODEL轻量任务用的模型一般填快速版ANTHROPIC_DEFAULT_SONNET_MODEL中等任务用的模型填主力模型ANTHROPIC_DEFAULT_OPUS_MODEL复杂任务用的模型填能力最强的那个注意ANTHROPIC_AUTH_TOKEN 的值必须完整以 sk- 开头前后不要有空格。粘贴时容易多带一个换行建议粘完检查一遍。如果你用的是 Claude Code 的 coding-plan 场景配置结构一样只是模型 ID 换成套餐里对应的名字。保存文件时确认编码是 UTF-8Windows 记事本默认就是不用额外设置。保存后关掉所有终端窗口重新打开一个。这一步是为了让新的环境变量生效不重开的话 Claude Code 读的还是旧配置。4. 验证请求从版本检查到首次对话回显配置写好了现在逐条验证确保每一步都真的通了。4.1 版本与安装检查重开终端后先确认工具在claude --version有版本号输出说明 Claude Code 可执行文件在 PATH 里。4.2 连通性测试在终端里直接测一下统一通道能不能通curl -I https://taotoken.net/apiMac 和 Windows 10 以上都自带 curl。如果返回 HTTP 状态码比如 200、401、404 都算通说明网络能到达。如果提示连接超时检查你的网络或者换个时间再试。4.3 启动 Claude Code在终端输入claude第一次启动会看到欢迎界面。进去之后输入斜杠命令查看状态/status这里会显示当前使用的模型、Base URL 等信息。确认模型显示为你配置的 DeepSeek 模型名Base URL 显示为统一通道地址。4.4 首次对话回显发一句话测试你好请用中文回复并告诉我你是什么模型如果收到中文回复并且模型自报的身份跟你配置的一致说明整条链路通了。这一步的成功标志是有回复、是中文、模型名对得上。4.5 在真实项目里跑一次光聊天还不够Claude Code 的价值在项目里。cd 到你的代码目录比如cd ~/projects/demo claude然后让它做一件小事比如「列出当前目录下所有 .js 文件并说明每个文件的作用」。看它能不能读到文件、给出合理回答。能读到文件说明工作目录权限正常。5. 本篇常见错排查401、local proxy failed 与 reading choices装的过程中最容易卡在几个报错上我按真实遇到的顺序列出来你对号入座。5.1 启动报 401报错长这样API Error: 401 Unauthorized原因基本是 Key 不对。检查三处Key 是否完整复制有没有漏掉尾部字符、Key 前后有没有空格或换行、Key 是否已经失效或余额不足。改完 settings.json 后必须重开终端。5.2 local proxy failed报错类似local proxy failed to connect这通常是 Base URL 写错或者网络到不了统一通道。先确认 ANTHROPIC_BASE_URL 的值没有多余斜杠、没有拼错。再用 4.2 的 curl 命令测连通性。如果 curl 也不通就是网络问题不是配置问题。5.3 reading choices 相关报错报错里出现error reading choices: unexpected end of JSON input这多半是返回内容被截断或格式异常常见于模型 ID 填错、通道返回了非预期内容。检查 ANTHROPIC_MODEL 等几个模型名是否跟通道支持的名称完全一致大小写、连字符都不能错。5.4 OAuth 相关提示如果启动时提示要走 OAuth 登录OAuth authentication required说明 Claude Code 没读到你的 settings.json走了默认的官方登录流程。检查文件路径对不对必须是用户目录下的 .claude/settings.json、文件名对不对不是 settings.json.txt、JSON 格式有没有语法错误少逗号、多逗号都会导致解析失败。可以用在线 JSON 校验工具粘进去检查。5.5 node 或 claude 不是命令node 不是内部或外部命令 claude 不是内部或外部命令前者是 Node.js 没装好或终端没刷新重启电脑重装。后者是 Claude Code 没装成功重新执行 npm install -g anthropic-ai/claude-code或者检查 npm 全局路径有没有加到 PATH。5.6 只回英文模型默认可能用英文回复。直接在对话里说「请始终用中文回复」或者在项目根目录建一个 CLAUDE.md 文件写上语言偏好Claude Code 会读取它作为上下文。排查完这些基本没有跑不通的情况。如果还卡着把报错原文复制下来对照上面几条找最接近的。6. 后续怎么用模型对话、Coding Plan 与接入文档跑通之后你可以按需求选不同的使用方式。想先验证模型能力、随便聊聊用模型对话页面最直接https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。不用配终端打开就能试 DeepSeek 的回答质量。打算长期在项目里用 Claude Code 写代码、跑 Agent 任务看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。套餐里会说明支持的模型和额度按你的使用频率选。需要管理多个 Key、查看用量进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。Key 丢了或者要换都在这里操作。配置过程中想核对参数写法接入文档有完整说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。遇到模型 ID 不确定、Base URL 要不要带路径这类问题文档里能查到。如果你用的是 Claude Code 之外的终端工具比如 Cline、Codex配置逻辑一样Base URL 填统一通道地址Key 填你的 API KeyModel ID 填 DeepSeek 模型名。三件套对齐基本都能接上。最后提醒一句settings.json 改完一定要重开终端这是最高频的「配置没生效」原因。把这条记牢能省你不少排查时间。
