我第一次敲下claude命令的时候预期很低觉得它无非是把网页聊天框搬进终端而已。直到某天我让它重构一个公共函数它自己翻了十几个文件改了二十多处引用最后还主动跑了一遍测试把结果摆到我面前——我才意识到这是个完全不同量级的工具。Claude Code 是新一代的终端编码智能体而当我把它接到 DeepSeek 上之后日常开发的体验和成本终于达到了我满意的平衡。这篇文章把我从零安装、配置 DeepSeek、到第一次跑通完整流程的每一步都写了下来适合想用上这套组合、又不想在配置上浪费时间的开发者。1. 为什么我要把 Claude Code 接上 DeepSeek1.1 Claude Code 不是终端里的聊天框第一次在项目目录里敲下claude的时候我预期很低一个聊天框而已能回答几个问题就差不多了。但真正用起来我才发现它的工作方式完全不一样。Claude Code 是一个驻留在终端里的编码智能体它基于当前项目目录做跨文件搜索、读取关键代码、修改文件、执行 shell 命令并且在每次操作之后继续观察结果、调整方案。也就是说它不是只在旁边给你出主意的军师而是能直接动手干活的外包工程师。一个典型的场景是重构。以前我重构一个公共函数得自己先找出所有调用点再一个个改。用 Claude Code 的时候我只需要描述需求把这个函数从 utils 模块迁到 helpers 模块更新所有引用保持对外行为不变。它会先用搜索工具把涉及的文件全部捞出来逐个打开确认上下文然后动手修改最后让我去跑测试验证。整个过程中每一步操作都展示在终端里就像有个助理坐在旁边每干一步跟你汇报一次。也正因为它是会动代码的代理而不是纯聊天的窗口它背后接的模型的能力就直接决定了实际产出质量。这就是为什么换模型这件事值得折腾。1.2 换模型这件事为什么可行很多人以为 Claude Code 只能用官方模型其实它对模型后端并不挑食。它把大模型 API 的调用抽象成了几个标准环境变量API 地址、认证 token、模型名。只要某个模型服务商提供了兼容 Anthropic 消息格式的接口把这三个变量指过去就能跑。DeepSeek 恰好提供了 Anthropic 兼容端点所以Claude Code DeepSeek不是强行魔改而是两边的设计刚好对上了。另外成本是我换模型的核心原因。DeepSeek 的 API 按量计费价格比主流闭源模型低一大截而且它的对话模型在代码理解、指令跟随上的表现相当能打日常需求完全够用。对于一天要在终端里高强度用七八个小时的人来说这个成本差距积累起来非常可观。如果你的需求只是让智能体帮你写测试、做重构、查文档DeepSeek 完全撑得住。1.3 什么人适合这个教程我把适合的人群划成四类对 API 成本敏感的个人开发者想给团队统一配置编码助手但担心账单失控的负责人手上已经有 DeepSeek 密钥、想一 key 多用的开发者以及单纯想搞懂 Claude Code 配置原理、喜欢折腾后端模型的人。反过来如果你的工作流重度依赖 Anthropic 特有的高级能力比如某些多模态输入或特殊的高级生成参数那么兼容端点可能覆盖不全这点需要提前知道边界。接下来的内容默认你已经具备基础的终端操作能力比如会 cd、会跑命令、会编辑配置文件。2. 开工前打地基账号、密钥和运行环境那些事2.1 注册 DeepSeek 账号并创建 API Key第一步是搞定调用凭证。打开 DeepSeek 开放平台用手机号注册账号按平台要求完成认证然后充值。这里有个重要细节DeepSeek 的 API 是预付费模式账户余额为 0 的时候请求会被直接拒绝所以别等报错了才想起来充值。充值的金额可以从小额开始跑通流程后再按实际用量追加。接下来在控制台里找到「API Keys」页面点击创建新密钥系统会生成一串sk-开头的字符串。这个密钥创建后通常只显示一次一定要立刻复制保存。我自己的习惯是复制到剪贴板后马上写进本地环境变量文件而不是粘贴进项目代码或提交到 Git 仓库。如果你用密码管理器也可以顺手存一份丢了只能重新创建。2.2 确认 Node.js 版本Claude Code 通过 npm 分发而 npm 由 Node.js 自带所以得先确认 Node 环境。打开终端执行node -vClaude Code 目前要求 Node.js 18 或更高版本。如果提示没有 node或者版本偏旧去官网下载 LTS 版本安装即可。我自己习惯用 nvm 管理 Node 版本切换、升级都方便nvm install --lts nvm use --lts一条龙搞定。装完记得重新打开一个终端确保node在 PATH 里。顺手再检查一下 npm 本身npm -v。如果遇到 npm 安装包速度很慢的情况常见做法是临时切换 npm 镜像源这属于常规操作不影响后续步骤。但注意不要为了加速而使用来历不明的第三方源安全第一。2.3 终端环境差异配置前先认清自己用的什么终端因为不同系统的环境变量写法不一样。macOS 下默认 shell 是 zsh环境变量写在~/.zshrc里Linux 如果是 bash就写~/.bashrc。如果你在服务器上通过 SSH 长时间跑任务强烈建议配合 tmux 保持会话否则终端连接一断正在进行的任务就一起没了重新连上还得从头再来。Windows 下最好用的方式是用 Windows Terminal 加 PowerShell环境变量可以通过系统设置面板设置也可以在 PowerShell 里用setx命令写入。不过更推荐的做法是直接装 WSL2这样所有命令、路径规则都和 Linux 保持一致能少踩很多编码和路径的坑。无论哪种系统改完配置文件后记得让配置生效source ~/.zshrc或直接重开终端。3. 安装 Claude Code两条路我都替你试过了3.1 路线 Anpm 全局安装推荐当 Node 环境就绪后安装其实就一条命令的事npm install -g anthropic-ai/claude-code装完直接就能用claude命令。以后更新也很简单npm update -g anthropic-ai/claude-code就行。npm 方式的优点在于依赖关系清晰、卸载方便没有任何额外的文件散落在系统里。我建议有 Node 环境的机器都用这条路线。这里有个常见的坑如果你是用系统自带的方式安装的 Nodenpm 全局目录可能在系统目录下普通用户没有写权限安装时会报 EACCES 权限错误。遇到这种情况不要急着用 sudo 硬装全局包更好的解决方式是改用 nvm 安装 Node让全局目录落到自己的用户目录下权限问题自然消失。3.2 路线 B原生安装脚本如果你不想装 Node或者机器上受限于公司策略不方便用 npm可以用官方提供的原生安装脚本curl -fsSL https://claude.ai/install.sh | bash脚本会把可执行文件放到~/.local/bin目录下。装完如果提示找不到命令多半是这个目录不在 PATH 里手动加上就行export PATH$HOME/.local/bin:$PATH两条路线我都实际测过。npm 版更新省事原生版更轻量。需要提醒的是用安装脚本这种方式未来升级也得重新跑脚本所以日常使用还是优先 npm。3.3 安装后的版本验证装完别急着配置先用下面的命令确认命令真的可用claude --version能看到版本号说明核心组件已经就位。如果报 command not found按顺序检查三件事PATH 里有没有对应的安装目录、终端有没有重开过、安装过程有没有权限报错。which claude可以查看可执行文件的具体位置方便定位问题。4. 把 DeepSeek 装进 Claude Code环境变量是全部秘密4.1 四个环境变量逐个解释Claude Code 对接 DeepSeek 的全部秘密就是环境变量。下面四个变量是必须配置的环境变量作用示例值ANTHROPIC_BASE_URLAPI 请求地址https://api.deepseek.com/anthropicANTHROPIC_AUTH_TOKEN认证凭证sk-你的密钥ANTHROPIC_MODEL主力模型deepseek-chatANTHROPIC_SMALL_FAST_MODEL轻量任务模型deepseek-chat逐个说明一下。ANTHROPIC_BASE_URL是整个替换方案的核心它决定 Claude Code 把请求发往哪里。DeepSeek 的 Anthropic 兼容端点路径就是https://api.deepseek.com/anthropic。ANTHROPIC_AUTH_TOKEN是认证信息Claude Code 会把它的值以 Bearer Token 的形式放进请求头DeepSeek 端认的就是这个。ANTHROPIC_MODEL是主力模型所有对话和编码任务默认走它。ANTHROPIC_SMALL_FAST_MODEL则用于那些轻量任务比如生成一句话摘要、给对话起标题之类的不需要动用大模型为的是省时间和 token。4.2 配置写进 shell 配置文件手动在终端里逐个 export 当然可以但只对当前会话生效重开终端就没了。正确做法是写进 shell 配置文件# ~/.zshrc 或 ~/.bashrc export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek密钥 export ANTHROPIC_MODELdeepseek-chat export ANTHROPIC_SMALL_FAST_MODELdeepseek-chat保存后执行source ~/.zshrc再echo $ANTHROPIC_BASE_URL确认变量已经加载。为什么推荐用环境变量而不是把密钥写进 Claude Code 的设置文件因为环境变量可以在不同环境间灵活注入在服务器上可以通过 secrets 机制传入不用担心密钥被提交到仓库。我的做法是本地开发机写死在 shell 配置里团队协作时则通过各自的环境变量注入互不干扰。4.3 模型选型deepseek-chat 还是 deepseek-reasonerDeepSeek 在兼容端点上开放了两个模型标识选择逻辑其实很简单模型标识对应模型特点适合场景deepseek-chatDeepSeek-V3响应快、成本低、指令跟随稳日常编码、重构、问答、写测试deepseek-reasonerDeepSeek-R1推理链长、擅长拆解复杂问题疑难 bug 定位、算法设计、架构取舍我的默认配置是deepseek-chat日常 90% 的任务它都能干净利落地完成。当遇到那种反复试了几次都找不到原因的诡异 bug、或者需要做复杂方案对比时再手动把ANTHROPIC_MODEL切到deepseek-reasoner并重启 Claude Code。两个模型在兼容端点上使用相同的消息格式所以对 Claude Code 来说切换只是改一个环境变量的事。5. 第一次跑通让组合干一个真实的活5.1 启动与首屏确认现在进入最激动人心的部分。在任意项目目录下执行claude首次启动会显示欢迎信息和一些使用提示。因为环境变量已经配好它不会再要求登录官方账号。这里有一个容易忽略的细节四个环境变量必须在同一个 shell 会话里生效。如果你之前用官方账号登录过 Claude Code只要环境变量存在优先级就更高会直接走 DeepSeek万一它还是引导你走登录流程多半是当前 shell 没加载配置检查一下变量再重开。5.2 从简单任务开始让 Claude Code 给你画项目结构第一次跑通别上来就让它干重活先来个摸底任务帮我对这个项目做一次快速摸底入口文件、构建脚本、核心模块分别有哪些你会看到它在终端里逐条展示工具调用过程先是列出目录文件然后逐个打开关键文件阅读最后组织成一段结构化回答。这个过程既是验证配置是否真的连通也是熟悉权限交互的好机会。它会询问你是否允许执行某些读取操作第一次遇到就选择允许一次观察它在干什么慢慢建立信任。5.3 让它动手改代码一个具体的 bug 修复摸底没问题后让它真正动手改一行代码。比如入口文件里处理空数组时会抛异常帮我定位并修复然后跑一下测试。这个任务会触发一系列动作搜索入口文件、阅读相关代码、修改文件、执行测试命令。第一次执行写文件和跑命令时Claude Code 都会弹出权限请求选项一般是允许一次、总是允许或拒绝。我的建议是测试命令这类安全的操作可以一路放行但涉及删除文件、改动全局配置的命令一定要先看清楚路径和内容再决定。提示第一次跑完整流程时全程盯着终端。工具会把每一步的意图都展示出来别按了回车就不管了。等你对它的行为模式有了把握再考虑放宽权限。5.4 非交互模式除了交互模式Claude Code 还支持非交互模式适合脚本化和批量场景claude -p 这个仓库的 README 有哪些可以改进的地方-p是 print 模式执行完直接输出结果不做任何等待。你可以把它接到其他命令的管道里实现让智能体写代码片段 - 输出给下一个工具处理的流水线。不过非交互模式没有权限确认环节风险控制完全靠你给它的任务边界所以不要让它执行具有破坏性的操作。6. 跑通之后的事记忆、权限与模型切换6.1 用 CLAUDE.md 建立项目记忆Claude Code 有一个非常实用的机制它会自动读取项目根目录下的CLAUDE.md文件以及用户全局目录~/.claude/CLAUDE.md把里面的内容当作项目的背景知识。这意味着你可以把构建命令、测试命令、代码风格约定、目录结构说明、容易犯的错全都写进去它每次启动都会先读一遍再开始干活。举个例子我的一个项目 CLAUDE.md 长这样# 项目约定 - 使用 pnpm 安装依赖不要用 npm - 测试命令pnpm test - 组件统一放在 src/components 目录下 - 不要在构造函数里发起网络请求 - 已废弃的 API 见 docs/legacy.md不要在新代码中使用写完之后Claude Code 的出错率肉眼可见地下降。以前它偶尔会自作主张用 npm 装依赖或者把新组件放错目录现在这些错基本绝迹。建议把项目级的 CLAUDE.md 纳入版本控制让团队成员共享同一套约定全局那个则记录你自己的通用偏好不用共享。6.2 权限管理allow / deny 规则交互模式下频繁弹权限框确实安全但弹多了也影响效率。Claude Code 支持通过 settings.json 预置权限规则指定哪些工具直接放行、哪些命令直接拒绝。配置文件有两个层级~/.claude/settings.json是用户级全局生效.claude/settings.json是项目级。我目前项目里用的是这样一份{ permissions: { allow: [ Read, Glob, Grep, Edit, Bash(npm test:*), Bash(pnpm test:*) ], deny: [ Bash(rm -rf *) ] } }allow 里放的是一些高频的只读工具和安全的测试命令deny 里把高危命令挡在门外。这样日常操作不再频繁打断你真正有风险的操作依然需要人工确认。有一点需要注意不同版本对 permissions 的支持细节略有差异如果某条规则不生效可以在交互界面里用/permissions查看当前实际规则。6.3 常用命令与上下文管理跑通之后有几个命令我几乎每天都在用。/clear清空当前会话上下文和 DeepSeek 搭配时尤其重要因为对话越长累计的 token 越多成本和时间都会上升任务完成就清一下是省钱的好习惯。/cost可以查看当前会话的消耗情况。想打断它正在执行的操作按 Esc 就行。另外ShiftTab 可以切换自动接受权限的模式但我在不熟悉的项目里一般保持手动确认。上下文管理也有门道。DeepSeek 的上下文窗口比官方旗舰模型要小一些所以面对大项目时别指望它一次性把所有代码都读进上下文。更好的方式是在 CLAUDE.md 里写清楚项目的结构和关键文件路径让它按需 Read 具体文件而不是把所有文件内容都塞进去这样既省 token也降低超限概率。7. 我踩过的坑报错现象、根因与解决顺序7.1 401 Unauthorized 鉴权失败这是最常见的报错现象是 Claude Code 启动后所有请求都返回 401。排查顺序我建议这样走先确认环境变量真的加载了echo $ANTHROPIC_AUTH_TOKEN看值是否完整。再确认ANTHROPIC_BASE_URL没写歪注意不要漏掉/anthropic这个路径。到 DeepSeek 控制台核对 key 是否一致复制时最容易带进空格或换行。检查账户余额DeepSeek 是预付费余额为 0 时请求也会被拒报错可能是 401 也可能是其他 4xx。最后用 curl 直接打一次 DeepSeek 的兼容端点把 Claude Code 排除在外curl https://api.deepseek.com/anthropic/v1/messages \ -H Authorization: Bearer sk-你的密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:deepseek-chat,max_tokens:20,messages:[{role:user,content:ping}]}如果 curl 返回了正常的内容字段说明密钥和端点都没问题问题在 Claude Code 侧的配置如果 curl 也报错那就是 key、余额或端点的问题逐个排除。7.2 模型不存在或请求 404另一种常见报错是模型不存在。很多人会凭直觉把ANTHROPIC_MODEL配成deepseek-v3或deepseek-r1但 DeepSeek 的 Anthropic 兼容端点只认两个标识deepseek-chat和deepseek-reasoner。使用其他名称都会导致请求 404。这个问题本身很好解决把环境变量改回官方标识即可。我踩过一次之后就把正确写法注释在了 shell 配置里防止下次又手滑。7.3 限流与并发控制高频并发使用时会撞上 429 限流。我遇到的情况是同时在多个终端窗口里开了好几个会话每个会话又连续发出大量请求很快就触发了速率限制。解决思路有三个减少同时运行的会话数量遇到限流报错后等待片刻再继续对于不着急的任务把请求节奏放慢。另外批量任务尽量放进同一个会话里串行执行不要并行开一堆窗口这样既能避开限流也方便统一观察和管理。7.4 上下文过长导致请求被拒长会话是隐形的坑。一开始我没意识到一个任务接着一个任务聊聊了很长时间之后突然某个请求就开始报上下文长度超限。这是因为对话的历史记录一直在累计 token最终顶到了模型的窗口上限。解决方式最简单有效任务告一段落就/clear开新会话继续。复杂任务也不要试图一次聊完拆成几步每步一个干净上下文效果更好。这不光是为了避免超限也是为了控制成本。7.5 工具调用偶发异常最后说一个偶发问题DeepSeek 的兼容端点偶尔会在工具调用上和 Claude Code 的预期不完全一致表现为任务进行到一半突然卡住、或者模型返回了 Claude Code 解析不了的结构。毕竟兼容层不可能做到像素级一致这是所有换后端模型方案都要面对的现实。我遇到时的处理顺序是先重试一次很多时候重试就过了如果同样位置再次失败就把任务拆小换一种表述让它重新尝试还不行就检查是否有新版 Claude Code升级后再试。整体来说这种问题出现的频率不高用兼容方案省下的成本完全覆盖这点小麻烦。8. 用了一个月之后的几点体会这套组合我用了大概一个月整体感受是值得折腾。最深的体会是CLAUDE.md 的价值被大多数人低估了。我花了半小时把项目的约定、命令、易错点写清楚之后Claude Code 的输出质量提升了一个台阶甚至比我去研究模型参数更有效。这也是我反复在文章里强调它的原因工具再强背景知识的质量直接决定它的发挥。第二个体会是模型分工。日常开发默认deepseek-chat速度跟手、成本可控遇到真正难缠的问题才切deepseek-reasoner。与其全程用贵的模型不如训练自己判断这个任务值不值得上重武器这也是一种成本控制的能力。最后分享一个能提升幸福感的小技巧给 Claude Code 起个别名。alias ccclaude以后在项目里敲cc就能进入智能体模式省了三个字母但每天敲十几次省下的时间的心理满足感很实在。另外一个隐藏技巧是在全局~/.claude/CLAUDE.md里写一句话动手改代码之前先阅读 README 和相关测试再开始修改。这句话让我的组合行为明显变得更谨慎、更不容易改坏东西。工具是拿来干活的这套组合真正跑顺之后你会发现原来很多繁琐的编码杂活确实可以放心交给它去做了。