Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置
本文主要介绍了ClaudeCodeCLI的安装及Windows系统开发环境配置方法,详细说明了通过npm安装的具体步骤,以及如何配置DeepSeek等第三方API接口(需在settings.json中设置ANTHROPIC_AUTH_TOKEN与ANTHROPIC_BASE_URL),同时涵盖了CC-Switch和OpenStart等配套工具模块的搭建与使用
前言
在持续使用 vibecoding 进行业务开发数月后,积累了一些经验,决定将其整理成文。如果你希望快速搭建好 vibecoding 环境,本文将提供实用的指导。
摘要
本文主要涵盖三个部分:Claude Code [CLI] 的安装、第三方 API 的接入,以及配套设施的搭建。
下面直接进入正题。
一、Claude Code [CLI] 安装
Claude Code [CLI] 是 Anthropic 开发的命令行编程 Agent。它调用 LLM 模型,并提供工具链、内置 Prompt、任务编排、记忆系统等,专为编程场景设计。
Git Bash 安装
从 Git 官网下载并安装后,在桌面右键选择 Open Git Bash here 即可打开终端界面,效果如下:

Node.js 环境准备
在 Node.js 官网下载并安装最新版本,然后在 Git Bash 中查看版本,显示版本号即安装成功。
复制代码# 查看 Node.js 当前版本
node -v
Claude Code 安装
Node.js 环境就绪后,使用 npm 安装。(虽然 Claude Code 官方文档已弃用 npm 方式,但截至本文编写时依然可用)
复制代码# 安装 Claude Code 到全局
npm install -g @anthropic-ai/claude-code
验证安装:
复制代码claude --version
能输出版本号即成功。若提示 command not found,说明 npm 全局 bin 目录未添加到 PATH。
复制代码# Windows PowerShell 手动添加 PATH
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$env:APPDATAnpm", "User")
# 然后重启终端
二、第三方模型接入
Claude Code 默认使用 Anthropic 官方 API,但国内使用 Claude 模型存在不便。可选用国产模型,体验稍逊但成本较低。本文选择 DeepSeek,它提供 Anthropic 兼容接口(/anthropic 端点),可无缝替换。
API-KEY 获取
- 打开 platform.deepseek.com,注册并登录
- 充值(最低 10 起步,足够长时间使用)
- 进入「API Keys」页面 → 「创建 API Key」
- 复制 Key,格式为
sk-xxxxxxxxxx
Claude Code 配置
配置 DeepSeek 有两种方式:环境变量和 settings.json 文件。推荐使用 settings.json——环境变量随终端关闭失效,而 settings.json 可持久化。
方式一:settings.json(推荐)
编辑 ~/.claude/settings.json(若不存在则新建):
复制代码{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "",
"ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "deepseek-v4-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
关键配置说明:
| 字段 | 值 | 说明 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | sk-xxx | 你的 DeepSeek API Key。注意是 AUTH_TOKEN 而非 API_KEY,写错时 Claude Code 不报错,但会发送空 token 导致 401 错误 |
ANTHROPIC_BASE_URL | | DeepSeek 的 Anthropic 兼容端点。末尾不要加 /v1,Claude Code 会自动拼接 /v1/messages |
ANTHROPIC_MODEL | deepseek-v4-pro[1m] | 默认模型,建议选 deepseek-v4-pro[1m],若预算有限可选 deepseek-v4-flash |
ANTHROPIC_DEFAULT_FABLE_MODEL | 留空 | 受控超旗舰,fable5 曾遭出口管制后于 2026 年 7 月解禁,暂不填写 |
ANTHROPIC_DEFAULT_OPUS_MODEL | deepseek-v4-pro[1m] | 旗舰模型,此处仍选 deepseek-v4-pro[1m] |
ANTHROPIC_DEFAULT_SONNET_MODEL | deepseek-v4-pro[1m] | 均衡主力模型,主要承担任务,仍选 deepseek-v4-pro[1m] |
ANTHROPIC_DEFAULT_HAIKU_MODEL | deepseek-v4-flash | 轻量极速模型,选 deepseek-v4-flash 即可 |
API_TIMEOUT_MS | 3000000 | 保持默认值 |
CLAUDE_CODE_EFFORT_LEVEL | max | 最大思考强度,填 max |
保存后重启 Claude Code,在对话中输入「你当前使用的是什么模型」,若有回复则说明配置成功。
方式二:环境变量(临时)
若仅临时使用一次,可采用环境变量方式:
复制代码# macOS / Linux
export ANTHROPIC_AUTH_TOKEN=sk-你的deepseek密钥
export ANTHROPIC_BASE_URL=
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="sk-你的deepseek密钥"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
验证配置
配置完成后运行最小测试:
复制代码claude -p "说一句你好"
若 Claude Code 使用 DeepSeek 模型正常回复,说明配置链路畅通。
进阶自检:
- 对话中询问「你当前使用的模型完整名称是什么?」——回答应包含
deepseek - 打开 DeepSeek 后台的 Usage 页面,执行一次操作后刷新——有新 token 消耗说明请求确实通过 DeepSeek
- 执行一轮包含「修改文件 + 运行 + 读取输出」的操作,确认工具调用正常
DeepSeek API 状态
DeepSeek Status:当使用 DeepSeek API 出现问题时,可访问此页面查看官方 API 状态是否异常。

至此,基础环境搭建完成。类似 GLM、Minimax 等也提供兼容 Anthropic 接口格式的服务,配置思路相同。
三、配套设施搭建
仅有 CLI 还不够,搭建配套设施能提升开发效率。
CC-Switch
当同时拥有 Anthropic 官方 API、DeepSeek API 及其他第三方中转 API 时,手动修改 settings.json 较为繁琐。CC-Switch 是一款桌面应用,可实现快速无缝切换,并支持 Token+金额消耗统计 和 多 CLI 管理。该工具已获得 110k+ 用户关注,值得尝试。
安装完成后打开应用,进入设置 -> 关于,查看本地环境能否识别到 Claude Code。若无法识别,请重新安装 Claude Code(CC-Switch 也提供一键安装功能)。

接下来进行供应商配置,选择 DeepSeek。

填入 API Key 即可,其他保持默认。

模型配置与之前一致,填入 apikey 后可获取模型列表,在下拉列表中选择,无需手动填写。此外,[1M] 选项可通过 CC-Switch 勾选,无需在模型名称后追加。
- 1M
- 最大思考强度

最后在主页面启用该配置,启用后即可测试对话。

OpenStart
这是通过 vibecoding 开发的一款 Windows GUI 工具,已开源,Github 地址:openstart。
主要功能:命令分组、一键调用、记录追溯。
- 建议搭配
Windows Terminal,可在同一窗口的多个标签页中执行多条命令。 - 设置中可开启开机自启动,配置后命令将自动执行。
下一章:Vibecoding 实战 #02: Claude Code 的实战配置
