年初我折腾过一段时间的命令行AI编程助手最后把我的Claude Code跑到了DeepSeek的模型上从安装到配通花了不到半小时后面连续几周写脚本、改代码都在用它。这篇东西就是当时的完整记录Claude Code是什么、为什么能和DeepSeek组合在一起、每一步怎么操作、中途会遇到哪些幺蛾子全部按我实际走过的流程写。适合被命令行劝退过、但想试试AI编程助手的人也适合已经在用Claude Code、想换个模型控制成本的人照着一步步来就行。1. 先弄明白这两个工具在这一组合里各管哪一段1.1 Claude Code是干什么的Claude Code是Anthropic系工具链里的一套命令行AI编程助手跟网页版聊天机器人最大的区别是它能真正“上手碰你的项目”读文件、改代码、新建文件、执行shell命令、运行测试甚至帮你提交代码。简单说你给它一个任务它会在你的项目目录里自己翻资料、写方案、动手改改完还能跑命令验证。我比较常用的场景是这几个批量重构比如把一堆函数的参数统一改成字典格式直接描述规则它会把涉及的十几个文件全部改完。写一次性脚本临时要分析日志、整理数据用对话描述需求比手写省不少事。解释陌生项目丢一个很久没动过的仓库给它让它概括模块结构、指出关键入口。执行多步骤任务先读代码、再改逻辑、最后跑测试一条龙完成。如果你习惯用IDE里的AI插件那Claude Code的体验会更“硬核”一点没有图形界面所有交互都发生在终端里靠对话和权限确认推进。1.2 DeepSeek怎么就被接进来了这里的关键在于DeepSeek开放平台提供了与Anthropic接口格式兼容的API端点。Claude Code本身是按照Anthropic的API规范来“说话”的只要我们把请求地址指向DeepSeek提供的兼容端点再配上DeepSeek的密钥Claude Code就能用DeepSeek的模型来干活。打个比方Claude Code就像一个只认某种规格插头的设备DeepSeek这边提供了一个转接头规格正好匹配插上就能用。不需要改Claude Code的代码也不需要做任何逆向工程配置层面就能完成。实际操作中只需要告诉Claude Code三件事去哪连指向DeepSeek的兼容端点地址。你是谁填DeepSeek的API Key。用哪个模型指定deepseek-chat或deepseek-reasoner。这三个信息分别对应三个环境变量后面第3章会一个个说清楚。1.3 这套组合适合谁不适合谁先说适合什么人。第一类是成本敏感的个人开发者或小团队用Claude Code的交互方式干活但模型走DeepSeek的按量付费整体开销相对友好。第二类是想在统一工具链里切换不同模型的人把环境变量改一改就能换脑子不用换工具。第三类是喜欢命令行效率、愿意花十分钟配置环境的人。不适合的人也有完全没碰过终端、看到命令行就头疼的朋友建议先用带界面的工具上手Claude Code的学习曲线确实更陡还有对某些特定模型能力有硬性要求的场景比如你就需要某个模型独有的一些复杂能力那先用官方链路兼容接口毕竟是后接的个别能力会有差距。2. 真正动手前的清单环境、密钥、终端配置2.1 三分钟检查Node环境Claude Code是通过npm安装的所以系统里得有Node.js环境。先打开终端跑下面两条命令看看node -v npm -v如果输出了版本号比如v18.x、v20.x说明环境是好的。建议Node版本在18以上太老的版本可能会碰上依赖安装失败。如果提示找不到命令去Node.js官网下载LTS版本装上装完重新开一个终端窗口再验证。我见过的情况是很多人明明装了Node但终端里依然提示找不到多半是安装时没把路径写进环境变量或者安装完没重启终端。这属于最常见的起步问题先确认这两条命令能输出结果再往下走能省很多排查时间。2.2 拿一把DeepSeek的API Key去DeepSeek开放平台注册账号登录后进控制台找到API Key管理页面创建一个新的Key。创建的时候可以起个名字便于区分用途比如就叫“claude-code”。创建完成后页面会显示一串以sk-开头的字符串这就是后面要用的密钥。注意两点提示API Key通常只在创建时完整显示一次页面刷新后就看不到了。一定先复制保存到本地临时文件里再继续操作。另外DeepSeek平台一般会为新账号赠送少量体验额度够你跑完这篇教程里的所有任务后面再按量付费。付费这块按官方计费规则走就行没有固定月费用多少算多少对低频使用者非常友好。2.3 提前想清楚你在哪个终端里配置环境变量这东西不同操作系统、不同终端shell的配置方式不一样而且只在当前终端会话里临时生效。这意味着你在这个窗口里配置好、启动Claude Code能连上DeepSeek但关掉这个窗口重新开一个配置又没了。要永久生效得写进shell的配置文件。提前确认你的环境属于哪一类系统常见shell配置文件macOSzsh默认~/.zshrcmacOSbash~/.bash_profile 或 ~/.bashrcLinuxbash~/.bashrcLinuxzsh~/.zshrcWindowsPowerShell配置文件路径较复杂建议用WSL或直接在会话里设置WindowsWSL按Linux的shell配置方式Windows用户我给个更省心的建议直接用WSLWindows Subsystem for Linux在WSL里的操作方式和Linux完全一致少踩PowerShell环境变量格式的坑。本篇后面主要按macOS/Linux的bash/zsh来写。3. 一条条命令装起来安装、环境变量、首次启动3.1 全局安装Claude Code环境没问题之后安装本身非常简单一条npm命令npm install -g anthropic-ai/claude-code这里有个常见的权限问题如果系统提示permission denied或EACCES说明当前用户没有全局目录的写权限。两个选择一是加sudosudo npm install -g anthropic-ai/claude-code二是不打全局安装改成用npx直接跑每次启动稍慢一点但不需要权限改动。我自己的习惯是直接全局安装毕竟每天都要用启动速度快很重要。安装完验证一下claude --version能输出版本号说明装好了。如果提示找不到claude命令多半是npm全局bin目录没在PATH里去查一下npm config get prefix再把对应的bin目录加进PATH。3.2 配置环境变量三个变量各管什么这一节是整篇教程的核心。我们需要告诉Claude Code三件事连哪里、我是谁、用哪个模型。对应三个环境变量环境变量值作用ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic把Claude Code的请求地址指向DeepSeek的兼容端点ANTHROPIC_AUTH_TOKENsk-你复制的Key身份认证相当于告诉DeepSeek平台这是谁在调用ANTHROPIC_MODELdeepseek-chat 或 deepseek-reasoner指定具体用哪个模型在bash或zsh里配置方式是在配置文件末尾追加三行export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeekKey export ANTHROPIC_MODELdeepseek-chat追加之后执行source让它立即生效source ~/.zshrc或者直接在终端里执行这三条export命令也行但对当前会话之外的其他窗口仍然无效所以还是建议写进配置文件。解释一下为什么是这三个变量名Claude Code是Anthropic生态的产物它默认从环境变量里读取Anthropic格式的连接信息ANTHROPIC_BASE_URL是官方就支持的配置项用来更换API地址ANTHROPIC_AUTH_TOKEN相当于给它一个身份凭证ANTHROPIC_MODEL则是模型名。DeepSeek的兼容端点能直接吃下这套变量形成了“工具认Anthropic的规矩、模型用DeepSeek的能力”这种组合。关于用哪个模型我说下自己的感受。默认我建议用deepseek-chat日常代码任务响应快、上下文利用好deepseek-reasoner推理能力更强适合让AI拆解复杂问题、做方案设计但响应会慢一些。第一次配置先用deepseek-chat跑通全流程后面想换再改这个变量就行。3.3 首次启动验证让它干一件小事试试水配置完成在任意一个空目录里启动claude正常会进入一个对话界面显示欢迎信息。第一次启动可能会要求你确认某些权限设置属于正常现象按提示回车同意即可。如果出现要求登录Anthropic账号的界面选择“使用API密钥”或者跳过登录的选项因为我们已经在环境变量里给了ANTHROPIC_AUTH_TOKEN理论上不需要再走账号绑定。这一步每个版本的提示文案不完全一样认准一点环境变量里已经有Key能跳过登录就跳过不能跳过就用API Key方式粘进去。进入对话后发一个最简单的请求请介绍一下当前目录的情况并告诉我你使用的是哪个模型。如果看到Claude Code先列出了当前目录里的文件然后正常回答并且在回答里能体现它正在按DeepSeek模型的方式工作那就说明整个链路已经通了。如果这一步就报错直接跳到第5章按排查表处理大部分问题都出在环境变量没生效或Key粘贴多了空格。4. 拿一个真实任务走一遍从提问到验收4.1 这个测试任务怎么设计首启验证只能证明“能连上”还不能证明“能干活”。我建议你跟着做一个文件批量重命名任务能在几分钟内检验Claude Code最核心的三项能力读文件、写脚本、执行命令。先在终端里准备一个测试目录mkdir -p ~/claude-test cd ~/claude-test touch a.jpg b.jpg photo_1.jpg photo_2.jpg notes.txt这样目录里有四张jpg和一个txt文件。任务描述很明确把当前目录下所有的.jpg文件批量重命名统一加上clean_前缀比如a.jpg变成clean_a.jpg。重命名完成后生成一份change.log记录每个文件改名前后的名字。选择这个任务的原因有三个。第一它需要模型先读取目录结构这一步验证了文件读取权限。第二它需要模型编写一段批量重命名脚本验证了代码生成能力。第三它需要执行脚本并写日志文件验证了命令执行能力。一个任务把三条链路全走通比分别测更高效。4.2 对话过程全记录每一步你在做什么实际执行时你会在终端里看到类似这样的交互过程。第一步模型收到任务后通常会先请求读取当前目录的权限。终端里会出现类似这样的提示我需要先查看当前目录下的文件列表是否允许读取目录 [y/n]这一步按y。如果你对要操作的文件很确定还可以在任务描述里直接写上“允许读取当前目录”减少一次确认。第二步模型读完目录后会告诉你它发现了哪些文件然后给出它的方案。它可能会说我准备写一个Python脚本用os.listdir扫描文件再用os.rename批量重命名最后把变更记录写入change.log。随后它会请求创建脚本文件的权限。我将创建 rename_files.py 文件是否允许写入 [y/n]继续按y。到这里你会发现Claude Code每做一步有风险的操作都会先征求同意不是闷头乱改这点我觉得特别重要尤其是面对不熟悉的项目时人工确认环节就是安全垫。第三步脚本写好后模型会请求执行命令准备执行python3 rename_files.py 是否允许运行此命令 [y/n]按y。执行完它会主动汇报结果哪些文件被重命名了change.log已经生成内容大概是什么样子。最后你还可以继续追问帮我打开change.log看看内容。它又会请求读文件权限然后展示日志内容。整个流程走下来你会明显感觉到它不是“对话机器人”而是“在你机器上干活的助手”。4.3 验收的四个检查点任务结束后别急着表扬自己动手验证一遍顺便熟悉一下基础操作。打开另一个终端窗口或者退出Claude Code回到shell执行ls -la cat change.log按这四个检查点逐一确认目录里是否出现了clean_a.jpg、clean_b.jpg、clean_photo_1.jpg、clean_photo_2.jpg原有的a.jpg等是否消失。change.log是否存在内容是否包含每个文件改前和改后的名字。notes.txt是否原封不动没有被误改。目录里有没有多出奇怪的临时文件比如重命名失败留下的半成品。我在第一次跑的时候模型生成脚本时把批量重命名逻辑写对了但日志文件打开方式用了追加模式重复跑会累积重复记录。这种细节问题在复杂项目里很容易发生所以养成“让AI动手之后自己审一眼”的习惯非常重要。5. 最常见的四类报错以及我当时排查的顺序5.1 401和403认证失败现象是启动后不管发什么消息都提示类似authentication error或invalid token返回401或403。这问题九成出在ANTHROPIC_AUTH_TOKEN上。先自查三件事echo $ANTHROPIC_AUTH_TOKEN看看输出的值是不是把整串Key正确粘贴了没有多余空格和换行。复制的时候有没有把前后的引号也复制进去。确认这个Key没有在平台端被删除或重置。如果值看起来没问题去DeepSeek控制台重新生成一个Key替换环境变量后再试。还有一个小细节配置文件里写了Key之后如果又在终端里手动export了一遍不同的值后者会临时覆盖前者别让两个地方打架。5.2 404和模型名无效现象是请求能发出去但提示模型不存在或端点找不到。先核对ANTHROPIC_BASE_URL是不是https://api.deepseek.com/anthropic注意路径末尾有没有多余斜杠、有没有拼错anthropic。再看ANTHROPIC_MODEL填的模型名是否在平台支持列表里deepseek-chat和deepseek-reasoner都是支持的不要随手填一个类似deepseek-v3之类的名字不一定对得上。这类报错最好排查因为问题非常明确要么地址不对要么名字不对。对一遍配置文件就能解决。5.3 连接超时或网络不可达现象是请求发不出去一直转圈最后报连接失败。可以先在终端里用curl验证到DeepSeek端点的连通性curl -i https://api.deepseek.com/anthropic只要能看到HTTP返回状态码哪怕返回401都算网络通。如果curl直接报超时或拒绝连接说明你的机器访问不到这个地址这时候检查网络环境确认终端能正常访问外网接口。如果curl通了但Claude Code还是连不上再检查ANTHROPIC_BASE_URL是否被其他环境变量覆盖比如某些全域配置里还残留着旧地址。5.4 上下文超限和任务中断跑大任务时可能出现提示上下文长度超限或者对话到一半就断了。这跟模型的上下文窗口有关不一定是报错更像一种工作习惯问题。我用的土办法是拆任务和清上下文。一个大需求拆成多个小需求逐轮对话比如“先分析这个模块的结构”和“再根据分析结果改掉某函数”分两步问。每完成一个阶段就输入/clear清空对话历史给模型腾出空间。Claude Code也支持/compact这类压缩上下文的命令具体以你装的版本提示为准输入/help能看到全部命令列表。另外把大段输出导向文件比让模型在对话里全部打印出来更省上下文比如“请把完整方案写入plan.md然后在对话里只给我摘要”这个习惯能明显减少上下文超限的发生。5.5 一张表快速定位报错现象大概率原因快速检查401/403API Key无效或粘贴错误检查ANTHROPIC_AUTH_TOKEN的值和有效状态404 not found端点地址或模型名不对检查ANTHROPIC_BASE_URL和ANTHROPIC_MODEL连接超时/拒绝连接网络到端点不可达curl -i检查连通性上下文超限任务太大或历史过长/clear清空上下文拆分任务权限报错无写目录权限检查项目目录的读写权限或改用sudo级别安装重试6. 用顺手以后才注意到的几个细节算给新手的加餐6.1 换模型不用改代码改一个变量就行跑通之后你会发现切换模型是一个非常轻松的活。想用deepseek-reasoner处理复杂逻辑把配置文件里的ANTHROPIC_MODEL改成deepseek-reasoner重新打开Claude Code对话里就会出现更长的思考过程。我现在的习惯是日常编码用deepseek-chat到了要设计系统方案、梳理复杂依赖的时候切到deepseek-reasoner一套CLI、两个脑子不用装任何额外工具。6.2 控制API消耗的三个土办法用AI干活的时候钱是无声无息流走的。我控制成本就靠三条任务描述里直接写明输出要求比如“回答请控制在200字以内”“不要贴完整代码只说改动点”能显著减少生成量。让AI把完整结果写进文件对话里只输出摘要减少重复生成。阶段性/clear别让对话无限累积因为在长上下文里继续对话的消耗是可感知的。6.3 权限确认和密钥保护Claude Code会频繁请求文件读、写、命令执行权限。有些人嫌麻烦想一次性全部允许我不太建议。尤其是不熟悉的仓库万一AI在某个改动里掺入无关变更没有人工确认环节很难注意到。我一般都会逐次看它请求的操作内容再决定是否放行。另一个重点是密钥别泄露。ANTHROPIC_AUTH_TOKEN就跟钥匙一样在终端里配置好之后就尽量不要复制到聊天软件、笔记软件里。还要检查一下项目根目录有没有.gitignore文件确保.env、配置文件这类包含Key的内容不会被提交到仓库。6.4 把Claude Code当成脚本化的工具来用最后一个技巧来自我后来的日常Claude Code支持非交互模式也就是一次性执行任务、不进入多轮对话。比如想让它快速“生成一个README模板”可以直接在shell里执行claude -p 读取当前目录的项目结构生成一份README.md内容包括项目简介、目录结构说明、快速开始三个部分任务执行完命令就退出不会占着终端。这种模式特别适合把AI编程助手写进自己的自动化脚本里比如每天的代码审查提醒、定期整理日志都能用这种方式串联起来。我自己第一次跑通这个组合的时候最大的感受是“原来命令行工具可以这么顺手”。虽然中间也遇到过去DeepSeek平台重新建Key、因为环境变量没生效导致401报错这类小麻烦但整体流程下来Claude Code的文字界面反而让人更容易专注在任务本身上面。这篇教程覆盖了安装、配置、实测和排错照着走完你应该能收获一个完全能日常使用的AI编程环境。后面想折腾的话还可以试着把它接进自己的项目工作流比如自动生成提交说明、定时跑代码检查方向很多先从跑通开始最实在。