企业官网建设流程全解析

上个月我把 Claude Code 接到了 VS Code 里，后端模型从 Anthropic 换成了 DeepSeek。一开始只是图新鲜，用下来发现这个组合确实能打：终端里跑着 AI 编程代理，改 bug、写测试、重构代码都能让它直接动手，账单还比官方 API 便宜一个量级。这篇文章把我从安装到跑通的完整过程，包括踩过的坑、验证过的配置、还有排查报错的思路，一次性写清楚。看完你可以照着在十分钟内搭出一套可用的环境：VS Code 打开终端，输入 claude，聊聊需求，它就开始读写你项目里的文件了。

如果你正打算接触 Claude Code，又不想用 Anthropic 官方模型的高价 API，或者你想在现有 VS Code 工作流里多一个能干活儿的编程代理，这篇文章就是给你准备的。

1. 先搞清楚这个组合是什么，值不值得装

1.1 Claude Code 到底是什么

Claude Code 是 Anthropic 官方推出的编程代理工具，形态是一个命令行程序，通过 npm 安装。它不是简单的"终端版聊天机器人"，而是有完整工具调用能力的代理：能读取你项目里的文件、搜索代码、编辑多个文件、执行终端命令、跑测试、处理 git 操作。你在终端里用自然语言描述需求，它会自主拆解任务，一步步执行，并把过程实时展示出来。

它跟 VS Code 的 AI 插件（比如 Copilot、Codeium）最大的区别是：插件通常停留在"补全、对话、解释"层面，修改代码往往还要你手动复制粘贴；而 Claude Code 是真去读写文件、跑命令，干完活直接给你看 diff。换句话说，它是一个"能动手的实习生"，不是"只会说的顾问"。

1.2 为什么要把模型后端换成 DeepSeek

Claude Code 默认要求 Anthropic 官方 API 的 key，计费按官方价格走，日常重度使用成本不低。而 DeepSeek 官方提供了 Anthropic 兼容接口，地址是 https://api.deepseek.com/anthropic，它实现了 Anthropic Messages API 的协议。你只需要把 Claude Code 的 base URL 指过去，把鉴权 token 换成 DeepSeek 的 API key，就能让 Claude Code 用 DeepSeek 的模型干活。

DeepSeek 的优点很清楚：按 token 计费的价格远低于 Anthropic 官方，模型的代码能力也够用，上下文窗口大。对个人开发者来说，日常的代码生成、重构、查错、写脚本这些任务，DeepSeek 的模型完全接得住。可以说，这个方案解决的最大问题就是：官方代理很好用，但我不想为它付那么多钱。

1.3 这套环境适合谁

• 用 VS Code 写代码，想体验代理式 AI 编程的开发者
• 已经在用 Claude Code，但对官方 API 成本敏感的团队或个人
• 想把手上的 DeepSeek API key 用起来、模拟 Anthropic 生态玩法的人

不适合谁？如果你希望开箱即用、完全不想碰终端和配置文件，那还是等官方一键集成更省心。这个方案需要你看得懂环境变量，遇到报错时愿意自己排查一下。

其实这套方案的原理可以打个比方：Claude Code 像一台只认"某种插头"的设备，Anthropic 官方是原厂插座；DeepSeek 做了一个同样的插座，虽然背后供电的发电机不同，但插上去就能跑。这个"插座标准"就是 Anthropic Messages API。理解这一点，后面所有配置逻辑就顺了。

2. 动手前的准备：最小环境、账号与密钥

2.1 检查 Node 环境与安装 VS Code

Claude Code 本质是 Node.js 写的 CLI 工具，所以先确认电脑里有 Node 环境。我的建议是 Node.js 18 及以上，最好直接用 20 LTS 或更新版本。装太老的版本，npm 安装会失败，或者运行时直接报语法错误。

检查方式：

node -v npm -v

如果还没装，去 Node.js 官网下载 LTS 安装包，一路下一步就行。Windows 用户装完记得重开终端，让 PATH 生效。

VS Code 本身只需要能开终端就行，理论上你甚至可以在系统终端里用 Claude Code。但既然标题是"在 VS Code 中加入"，我就按 VS Code 的集成玩法来写：Claude Code 跑在 VS Code 内置终端里，好处是它调用 code 命令打开文件、展示 diff 时，可以直接跟编辑器联动，体验比纯系统终端好很多。

2.2 创建 DeepSeek API key 与账户余额

去 DeepSeek 开放平台注册账号，创建一个 API key。流程是：控制台 -> API Keys -> 创建新的 key，生成一串 sk- 开头的字符串。创建时记得立刻复制保存，平台只显示一次。

另外，DeepSeek 是按充值余额计费的，账户里要有余额才能调用。金额不用冲太多，日常写代码的量级真的很小。我自己的使用习惯是：重度用一周，也就消耗个位数到两位数分量的余额（具体价格看平台页面的当前定价）。第一次用的话先冲一点点，跑通了再根据用量补。

2.3 理解 Anthropic 兼容接口的映射原理

DeepSeek 官方文档里有一个章节专门讲 Anthropic API 兼容，里面明确给出了 Claude Code 的接入参数。核心是三段信息：

• ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
• ANTHROPIC_AUTH_TOKEN=你的 DeepSeek API key
• ANTHROPIC_MODEL=deepseek-chat

这三个环境变量的含义分别是：API 请求发往哪里、用什么凭证鉴权、默认用哪个模型。Claude Code 启动时会读这些变量，然后按 Anthropic 协议发请求。DeepSeek 在 /anthropic 路径上翻译请求，再路由到自己的模型上。

这里有个细节值得注意：base URL 一定不能漏掉末尾的 /anthropic。如果只写成 https://api.deepseek.com，Claude Code 会去请求 /v1/messages，DeepSeek 那边虽然有 OpenAI 风格接口，但路径对不上 Anthropic 的请求格式，会直接 404。这个错误非常常见，后面排查部分我会再展开。

3. 一步步配置：从安装到跑通

3.1 用 npm 安装 Claude Code

用 npm 全局安装：

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

装完验证：

claude --version

能输出版本号就算装好。如果你在 npm 官方源上安装特别慢，可以临时切到国内镜像源，装完再切回去：

npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code npm config set registry https://registry.npmjs.org/

不想全局改 registry 的话，也可以直接给 install 命令加 --registry 参数。Windows 用户如果提示 "claude 不是内部或外部命令"，大概率是 npm 全局目录没进 PATH。用 npm prefix -g 查看全局安装路径，把对应的 bin 目录加进系统 PATH 就行。

这一节多说一句：安装过程中如果看到 engine 相关的警告，别无视。它通常意味着你的 Node 版本低于 Claude Code 的要求，后面启动很容易报语法错误。老老实实升级 Node 再装，比到时候排查问题省时间。

3.2 三套环境变量配置方案

环境变量怎么设置，取决于你的操作系统和希望生效的范围。我按三种常见方式讲，从最简单到最工程化。

方式一：写入 shell 配置文件（macOS / Linux）

编辑 ~/.bashrc 或 ~/.zshrc，追加：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek密钥 export ANTHROPIC_MODEL=deepseek-chat export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true

保存后 source 一下或者重开终端。

方式二：PowerShell（Windows）

临时生效，在当前终端执行：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek密钥" $env:ANTHROPIC_MODEL="deepseek-chat" $env:ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

永久生效，用 setx：

setx ANTHROPIC_BASE_URL "https://api.deepseek.com/anthropic" setx ANTHROPIC_AUTH_TOKEN "sk-你的DeepSeek密钥" setx ANTHROPIC_MODEL "deepseek-chat" setx ANTHROPIC_SMALL_FAST_MODEL "deepseek-chat"

注意 setx 对已经打开的终端不生效，设置完要新开一个终端窗口。

方式三：项目级配置（推荐，可控性最强）

在项目根目录创建 .claude/settings.json，把环境变量写进去。这样配置跟着项目走，不会污染全局 shell，也方便团队共享：

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

我个人强烈推荐方式三。原因后面单独讲。

3.3 第一句对话：验证联通性

配置好之后，先在项目目录里执行：

claude

第一次启动会有一些初始化提示，如果一切正常，你会看到 claude 的交互提示符。随便问一句"你好，用一句话介绍你自己"，如果它正常回复，说明链路已经通了。

更稳妥的验证方式是用 print 模式直接问一句然后退出：

claude -p "ping，请回复pong"

正常情况下你会看到 pong 或者类似的回复。print 模式很适合脚本调用和快速验证，不进入交互界面。这一步通过之后，基本可以确定 base URL、token、模型名三样东西全都没问题。

如果这一步报错，别急着往下走，先看第 5 章的排查表。绝大多数问题都集中在环境变量没生效、base URL 写错、模型名不对这三类。我个人见过的案例里，环境变量没生效占了一半以上，重开终端往往就解决了。

3.4 在 VS Code 集成终端里使用

进入 VS Code，打开项目文件夹，按 Ctrl+反引号（macOS 上是 Control+反引号）呼出集成终端，运行 claude。之后你的整个开发流程就变成：编辑器里改代码，终端里和 Claude Code 对话，它帮你分析代码库、给出修改方案、直接动文件，你在 diff 里审查它的改动。

有个小技巧：VS Code 的终端支持多窗口拆分。建议左侧窗口跑 claude，右侧窗口跑测试或构建命令。Claude Code 会自己在终端里执行命令，你可以看着它的每一步操作，发现不对马上 Ctrl+C 打断。

另外，Claude Code 的交互界面里支持斜杠命令，常用的有：

• /model 切换模型
• /clear 清空当前会话上下文
• /status 查看会话信息
• /cost 查看本次会话消耗的 token 费用
• /help 查看所有命令

4. 实操要点：模型选择、参数调优与协作分工

4.1 deepseek-chat 与 deepseek-reasoner 怎么选

DeepSeek 在 Anthropic 兼容接口上主要可用两个模型名：deepseek-chat 和 deepseek-reasoner。

打个比方：deepseek-chat 像手脚麻利的执行者，快、便宜，适合日常写代码、补测试、改样式、解释报错；deepseek-reasoner 像遇到难题会先坐下来想清楚再动手的老手，推理链路长，适合解复杂的算法问题、排查诡异 bug，但更慢，消耗也更大。

我实际使用的经验是：默认用 deepseek-chat 就够覆盖八成以上的日常任务。只有遇到那种改了三次还不对、逻辑绕来绕去的 bug 时，才切换 /model 换成 deepseek-reasoner 让它慢慢想。不用一开始就上 reasoning 模型，那样会显得很"急"，响应慢还贵。

Claude Code 内部其实有两个模型槽位：一个主模型干重活，一个小模型跑后台的轻量任务（比如生成标题、总结对话这种）。如果不设置 ANTHROPIC_SMALL_FAST_MODEL，它会默认去请求 Anthropic 的小模型，在我们对接 DeepSeek 的场景里就会报错。所以我在前面配置里把它也指到了 deepseek-chat，这一步很多人会漏。

4.2 关键环境变量逐项说明

我把相关的环境变量整理成一张表，方便对照排查：

最后一个变量是个隐藏的优化开关。默认情况下 Claude Code 会向 Anthropic 那边发一些非核心的遥测和功能请求，在第三方模型场景下，这些请求一是没必要，二是可能因为连不上而拖慢启动或造成奇怪的等待。设成 true 之后，启动更干净，链路更稳。

4.3 项目级配置为什么更推荐

回到前面提到的项目级配置。用 .claude/settings.json 有四个实际好处。

第一，环境变量是跟着项目走的。你不同项目可能想用不同模型，或者有些项目根本不需要 AI 代理，全局 export 在多个项目之间容易串。

第二，避免把密钥写进 shell 配置。虽然 shell 配置文件本身也不安全，但项目级配置配合 .gitignore 处理更灵活——你可以把 settings.json 里含密钥的字段抽出来，或者在团队里共享一份去掉 token 的模板。

第三，VS Code 集成时，项目级配置会自动被 Claude Code 读取，不需要额外记忆哪些终端要设置哪些变量。

第四，排查问题更简单。怀疑配置错了，直接看项目里这个 json 文件，一目了然。

我现在所有用到 Claude Code 的项目，都是建一个 .claude 目录，里面放 settings.json。全局 shell 里只保留一个兜底配置，防止在没配项目级设置的地方裸跑 claude 时报错。

4.4 和 VS Code 原生 AI 能力的分工

不少朋友会问：有了 Claude Code，还需要装 Copilot 之类的插件吗？我的看法是两者互补，不是替代关系。

VS Code 的 AI 插件擅长的是"行内补全"——你写代码时它在光标处给你接下半句，这种即时反馈 Claude Code 给不了。而 Claude Code 擅长的是"跨文件任务"——比如"帮我搜索所有调用这个函数的地方，统一改成新接口"，这种任务你让普通插件做，它只会给建议，你还是得手动改；Claude Code 会直接动手改完所有文件，再给你一份 diff。

我的习惯是：编译器报错了，让 Claude Code 去修；写新函数，开 Copilot 让它补全。各干各擅长的，体验最好。

5. 常见问题与排查实录

5.1 认证失败：401 与密钥相关

现象：启动后立刻提示 authentication 相关错误，或者请求返回 401。

排查顺序：

1. 在终端里执行 echo $ANTHROPIC_AUTH_TOKEN（Windows 是 echo $env:ANTHROPIC_AUTH_TOKEN），确认变量真的存在。很多时候配置写对了，但 shell 没有重新加载，导致 claude 进程读不到。
2. 确认 key 没复制错。sk- 开头的一长串，前后不要有空格，不要混入引号。
3. 去 DeepSeek 平台确认 key 状态是启用，账户余额不为零。余额为 0 时，鉴权也会异常。

5.2 404 与请求路径错误

现象：请求发出去，服务器返回 404 或类似 URL not found。

十有八九是 ANTHROPIC_BASE_URL 写成了 https://api.deepseek.com 或 https://api.deepseek.com/v1。这两个都不对。对接 Claude Code 必须带 /anthropic 后缀，也就是 https://api.deepseek.com/anthropic。

顺便说一句，如果你在 DeepSeek 平台文档里看到 OpenAI 风格的 base_url，那是给 OpenAI SDK 用的，别混淆。同一个 DeepSeek 服务，OpenAI 风格和 Anthropic 风格是两个不同的路径，Claude Code 只认后者。

5.3 模型不存在与 /model 切换

现象：能连上 API，但提示模型名无效。

先执行 /model 看看当前模型列表，然后手动输入 deepseek-chat 或 deepseek-reasoner 再试。同时检查 ANTHROPIC_MODEL 环境变量是否被设成了奇怪的值。注意模型名大小写和连字符要跟官方文档一致。

另一种情况：某些教程会让你把模型设置为其他名字，然后在代理网关里做映射。如果你没有代理网关这一层，直接对接 DeepSeek 官方接口，模型名就必须是 deepseek-chat 或 deepseek-reasoner，没有第三个选项。

5.4 请求限流：429 与场景对策

现象：用着用着开始报 rate limit 或 429，尤其是连续让 Claude Code 大改多个文件时。

DeepSeek 的 API 有频率限制，Claude Code 这种代理型工具的一次任务会发起多个请求，容易撞上限制。应对办法：把大任务拆成小任务分步做；减少同时开的会话；如果真频繁触发，到平台查看当前限制档位，必要时调整调用节奏。另外，将 ANTHROPIC_SMALL_FAST_MODEL 设成 deepseek-chat 也能减少小模型请求的额外压力。

5.5 Node 环境与 PATH 问题

现象：安装时报 engine 不兼容，或者启动时报语法错误。

检查 node -v，低于 18 的版本赶紧升级。npm 装包的时候如果看到 engine 警告，也认真看一下，别无视。还有一种是 Windows 上 PATH 问题，导致 claude 命令找不到，按 3.1 节的方式处理。

5.6 启动卡顿与非必要流量

现象：claude 启动后长时间没反应，或者出现跟 Anthropic 官方相关的请求超时提示。

优先确认 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=true 是否已设置。这个变量关了非必要的遥测请求之后，大部分"莫名卡住"的问题会消失。如果还卡，看看 shell 初始化脚本里有没有网络相关配置影响了请求路径。

5.7 用好 claude doctor 诊断工具

较新版本的 Claude Code 提供了 claude doctor 命令，可以自动检查配置和网络链路。如果你配置完怎么都跑不通，先跑一下：

claude doctor

它会输出当前生效的 base URL、模型、鉴权状态等信息，很多问题看一眼输出就明白了。

6. 实际使用中的体会与扩展方向

最后再聊几句实践感受。

第一，这个方案最省心的地方不是省钱，而是把"AI 编程代理"这件事的价格门槛拉下来了。以前用官方模型，每次跑一个多小时的重构，心里都在算 token 账单；现在换成 DeepSeek 之后，基本不用盯着 /cost 看了，偶尔看一眼也只是满足好奇心。

第二，把配置做成项目级之后，协作体验会好很多。我在团队里共享了一份不带密钥的 .claude/settings.json 模板，同事拉下来自己填 key 就能跑，每个人用的模型还能不一样。这比每个人都去折腾全局环境变量舒服太多。

第三，如果你后续想在这个方案上做扩展，有两个方向可以参考：一是把同样的 Anthropic 兼容接口思路用到其他支持这个协议的工具上，配置逻辑几乎一模一样；二是在 .claude/settings.json 里继续加 MCP 服务器配置，给 Claude Code 接上更多外部工具，比如数据库查询或者构建系统。整个生态是开放的，从一个入口进去，能解锁不少玩法。

踩过几次坑之后，我的体会是：不要在第一次配置失败时直接放弃，大部分报错都逃不过前面那几类。按顺序排查，十分钟内基本都能解决。等你把 claude 跑在 VS Code 终端里、看着它一行行改代码的时候，会觉得这一趟折腾还挺值的。