企业官网建设流程全解析

先说结论：Claude Code 加 DeepSeek 这套组合，完全能跑通，而且跑通之后，日常开发效率提升得不是一星半点。最近我在多个项目里把 Claude Code 的默认后端换成 DeepSeek，整体体验稳定，成本也比直接用官方模型更可控。如果你还没试过这种“终端 Agent 配第三方模型后端”的玩法，这篇文章就是按保姆级标准写的操作手册：从检查本机环境、装 Node、装 Claude Code、取 DeepSeek API Key，到第一条指令跑通，再给你一份我在实际使用中踩过坑之后的调优经验。

1. 为什么要把 Claude Code 和 DeepSeek 组合在一起

1.1 这套组合解决的真实问题

Claude Code 本质上是一个运行在终端里的编码代理。它不只是一个聊天窗口，而是能读项目文件、搜函数、执行命令、查看 Git 差异的研发助手。默认情况下，它调用的是官方模型接口，生成质量没得说，但对个人开发者来说，高频使用的成本是一道很现实的门槛。DeepSeek 的模型接口以低成本和稳定性著称，两者组合起来，就是用 Claude Code 的智能体工作流，配上 DeepSeek 的模型推理能力。最实在的价值就是省成本：同样的会话密度，账单能低一个量级。除此之外，DeepSeek 的接口对中文理解也很友好，代码注释和需求描述的识别基本不会跑偏。

1.2 客户端与模型后端分离的原理

Claude Code 在设计上支持通过环境变量指定 API 地址和认证令牌。DeepSeek 对外提供了兼容模式，专门有一个能接收 Claude Code 请求格式的转换端点。因此，不需要改动 Claude Code 内部任何代码，也不需要搭建中间层，只要在环境变量里写明地址和 key，Claude Code 发出去的请求就会落到 DeepSeek 的模型服务，推理完成之后再用同样的格式返回。

理解这一点很重要：Claude Code 是“大脑的壳”，DeepSeek 是“计算的大脑”，配置的本质就是把两者原本的固定连接方式改掉。你可以随时再改回来，也可以在同一台机器上维护多个配置，按项目切换模型后端。

1.3 什么人适合这套方案

• 个人开发者想在本地快速拥有一个能读懂整个仓库的 AI 编码助手；
• 小团队想给核心成员配置编码 Agent，又不想预算失控；
• 自动化脚本、CI 场景里需要一个无界面的代码审查助手；
• 对数据链路比较敏感的项目，希望请求走自己可控的服务商。

如果你的需求只是偶尔问几个零散的编程问题，那直接打开网页对话就够用了。但如果你想让它真正介入项目、替你读文件、替你跑命令，Claude Code 加 DeepSeek 是一套性价比很高的组合。

2. 开工前的清晰准备清单

2.1 本机环境要求

Claude Code 基于 Node.js 构建，所以第一件事是确认本机有可用的 Node.js 运行时。建议版本不低于 18，我在测试时用 20 和 22 都没有问题。macOS 用户可以用 Homebrew 安装，Linux 用户建议用包管理器或 nvm，Windows 用户推荐直接用官方安装包。

安装完之后，在终端跑下面这两条命令，确认版本号能正常显示：

node -v npm -v

如果提示 command not found，说明 Node 还没有进入 PATH，需要先解决环境变量问题再往下走。

2.2 获取 DeepSeek API Key

去 DeepSeek 开放平台注册账号，登录后进入控制台创建 API key。创建时系统通常只会完整显示一次，务必先复制保存到本地再关闭页面。建议给 key 设置一个容易识别的名称，比如claude-code-local，这样以后在控制台里看到这个 key，能立刻知道它用在哪里。

创建 key 之后，还需要根据实际用量给账户充值。如果账户余额为 0，后续请求会一直报错，而且这个错误信息和 key 无关，容易被误判为配置问题，提前充值可以省掉一次无意义的排查。

2.3 影响全局的 3 个环境变量

关于模型选择，我实际使用的经验是：

• deepseek-chat：日常代码生成、解释、重构走这里，响应快、费用低，适合大多数场景；
• deepseek-reasoner：适合复杂问题，思维链更完整，但更慢也更贵，遇到跨模块重构、疑难 bug 时再切过去。

如果你没有特殊理由，默认写成deepseek-chat即可。后面使用中再按任务类型切换。

3. 保姆级安装与跑通全过程

3.1 安装 Node.js

如果本机还没有 Node.js，最简单的方式是去 Node 官网下载长期支持版（LTS）安装包，双击安装即可，一路默认选项就可以。

习惯用命令行的同学，macOS 可以这样装：

brew install node@20

安装完成后，新开一个终端窗口，再次确认node -v和npm -v都有输出。这里强调新开窗口，是因为很多 macOS 用户在安装之后不刷新 PATH，终端仍然显示旧环境，导致误判安装失败。

3.2 全局安装 Claude Code

Claude Code 目前通过 npm 分发，执行：

npm install -g @anthropic-ai/claude-code

等待安装完成后，验证：

claude --version

如果找到不到claude命令，基本是 npm 全局目录没有加入 PATH。macOS 常见全局目录是/usr/local/bin，Linux 可能在/usr/bin或 nvm 对应的版本目录里。先定位 npm 全局目录：

npm prefix -g

把输出路径加入 PATH 即可。这一步卡住的人不少，但解决起来也就是一行 export 的事。

3.3 写入环境变量（最关键的一步）

这一步最容易被忽略，也最容易出错。打开你的 shell 配置文件，macOS 默认是~/.zshrc，Linux 默认是~/.bashrc，在文件末尾加入：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek API Key" export ANTHROPIC_MODEL="deepseek-chat"

保存后执行：

source ~/.zshrc

然后确认变量真正加载了：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN

输出内容应该是你写入的地址和一整串 key。这个地方最容易踩的坑是复制时把 key 漏了后半段，或者引号不匹配，导致环境变量存了半个 key。我遇到过好几次：表面看起来配置了，实际echo出来发现 key 末尾缺了好几位。

3.4 从零跑通第一条 Claude Code 指令

新建一个测试项目：

mkdir ~/demo-agent && cd ~/demo-agent

准备一个测试文件test.py：

def add(a, b): return a + b print(add(1, 2))

启动 Claude Code：

claude

首次进入时，如果提示登录或跳转授权界面，不要慌。由于我们已经把后端切到 DeepSeek，Claude Code 应该会读取ANTHROPIC_AUTH_TOKEN作为凭证。如果它仍然弹官方的登录流程，说明机器上存在旧的登录状态，先执行：

claude /logout

然后重新运行claude。正常情况下一两秒内就会进入一个交互式命令行界面。输入：

请阅读 test.py，说明这段代码做了什么，并指出如果 a、b 不是数字会有什么问题。

等模型返回之后，可以继续提要求：“顺便帮我改成带类型检查的版本。”跑通的那一刻，你会看到内容先生成后逐字输出，这就是终端 Agent 在工作了。最后输入/exit退出会话。

4. 从会跑到用好：核心会话技巧

4.1 让 Agent 更懂你的项目

在项目根目录启动claude是最重要的一条使用习惯。它会自动读取当前目录里的文件结构，并结合项目内容回答问题。如果你在别的目录启动，它只能基于你显式提供的文件信息工作，效果会打折。

想进一步提高贴合度，可以在项目根目录放一个CLAUDE.md文件，用几行说明项目用途、技术栈、目录规范、常用命令。Claude Code 每次启动时都会默认读取这个文件，DeepSeek 生成出来的建议会明显更贴项目。我在几个项目里对比过：有CLAUDE.md的项目，Agent 给出的代码风格基本不需要改；没有的，它会按通用风格写，改起来反而更花时间。

4.2 拆分任务与使用上下文压缩

别让 Agent 一次性重构整个项目。指令越细，效果越稳。一个合理的指令结构是：

• 先让它读文件，列出影响范围；
• 确认它理解准确后再让它改；
• 每完成一个小目标就停下来检查；
• 最后让它跑一遍测试或至少给出验证方法。

上下文变长之后，费用和等待时间都会明显上升。这时候可以用/compact压缩上下文，或者在确认阶段性成果后重启会话。/clear可以清空当前对话历史，适合切换到完全无关的新任务时使用。

4.3 随时切换模型

配置里默认是deepseek-chat，但遇到复杂问题可以临时切到deepseek-reasoner。在会话中输入/model，按菜单切换即可。也可以不进入交互界面，直接执行：

claude --model deepseek-reasoner

这个命令很适合在遇到跨文件重构、复杂调试时使用。我一般先让deepseek-chat快速生成初稿，遇到瓶颈再切推理模型，这样能把成本和效率平衡好。

4.4 把 Claude Code 嵌进 Git 工作流

日常开发里我最常用的动作是：改完代码后，运行claude，然后输入“查看 git diff，帮我写一份规范的 commit message”。它会把改动梳理成逻辑清晰的一二三条，比手动写提交说明省很多时间。

还可以让它做“提交前审查”，输入“检查未提交的代码，重点关注明显的逻辑错误”，它会基于当前 diff 给出建议。注意，在提交之前，人工瞄一眼生成结果仍然是必要的。Claude Code 加 DeepSeek 的组合大多数时候可靠，但偶尔也会一本正经地错判，把它当成一个高效率的实习生来复核比较稳妥。

5. 常见问题与我的排查实录

5.1 认证失败：401 / 403

现象是启动后报认证错误，或者请求返回 401。常见原因有三个：API key 复制不完整、环境变量未加载、key 余额不足。

排查顺序是先用echo $ANTHROPIC_AUTH_TOKEN确认环境变量是否完整，再去 DeepSeek 控制台检查 key 状态和余额。之前遇到过一种情况：key 本身没问题，环境变量也有，但终端是从旧窗口打开的，shell 配置文件没有重新加载，导致进程从头到尾拿到的都是空变量。新开终端窗口或手动 source 一下就好。

5.2 模型不存在：model_not_found

这个报错基本上只有一个原因：ANTHROPIC_MODEL的值写错了。只要不是deepseek-chat或deepseek-reasoner，服务端都会拒绝。

我自己踩过一次坑：把模型名写成deepseek-v3，服务端不认识。改成deepseek-chat后立刻正常。如果你不确定当前支持哪些模型名，去 DeepSeek 控制台的最新文档里核对，不要凭记忆写。

5.3 请求超时与响应缓慢

单次请求携带大量代码，容易触发超时；网络抖动和服务繁忙也会导致响应变慢。

我的处理办法是：把问题拆小，减少单次请求塞入的文件数量，一次只让它看一两个关键文件；如果上下文已经很长，先用/compact压缩，再继续提问。也可以用claude --debug启动，看请求到底发到了哪里、延迟主要出现在哪个环节。

5.4 中文乱码或输出被截断

终端里中文显示为乱码，通常不是模型的问题，而是终端编码不是 UTF-8。把终端字体和编码切到 UTF-8 基本能解决。回答到一半就停，常见于请求上下文过大或输出长度达到上限，可以缩小任务范围、压缩上下文之后重试。

5.5 不想每次都写环境变量

如果你希望配置只作用于当前项目，可以在项目根目录创建.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "sk-你的key", "ANTHROPIC_MODEL": "deepseek-chat" } }

这样进入项目后 Claude Code 会自动读取这份配置，不影响其他项目。但有一个必须强调的细节：这个文件里包含密钥，如果项目用版本管理，一定要把它加入.gitignore，避免把 API key 提交到仓库。我之前见过有人把这类文件传上去，结果第二天 key 就被盗刷了，极其肉疼。

5.6 如何验证请求确实发到了 DeepSeek

想确认请求路径没走错，可以打开 DeepSeek 控制台的调用日志，查看是否有来自你的 key 的请求记录。也可以在发请求之前用claude --debug抓一下输出。这个习惯能帮你快速区分两个方向的问题：是 Claude Code 配置错了，还是 DeepSeek 侧拒绝了请求。

最后再分享一点个人实操体会。用 Claude Code 加 DeepSeek 的组合，最值得投入的不是安装配置那一步，而是养成“给它项目背景”的习惯。我现在的固定流程是：每个项目先花五分钟写一个CLAUDE.md，把项目结构、构建命令、代码规范写清楚，之后所有会话的质量都会明显提升。

还有一个细节想补充：在会话中如果觉得某次回答质量特别高，我会顺手记下当时的 prompt 写法，下次同类任务直接复用。调教 Agent 和带新人做事非常像：背景越完整，期望越具体，产出越靠谱。多试几次，你会找到属于自己团队的那套最佳操作方式。