Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

作者:技术拾光时间:2026-08-01 20:03:16浏览:190

本文主要介绍了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 即可打开终端界面,效果如下:

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

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 获取

  1. 打开 platform.deepseek.com,注册并登录
  2. 充值(最低 10 起步,足够长时间使用)
  3. 进入「API Keys」页面 → 「创建 API Key」
  4. 复制 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_TOKENsk-xxx你的 DeepSeek API Key。注意是 AUTH_TOKEN 而非 API_KEY,写错时 Claude Code 不报错,但会发送空 token 导致 401 错误
ANTHROPIC_BASE_URLDeepSeek 的 Anthropic 兼容端点。末尾不要加 /v1,Claude Code 会自动拼接 /v1/messages
ANTHROPIC_MODELdeepseek-v4-pro[1m]默认模型,建议选 deepseek-v4-pro[1m],若预算有限可选 deepseek-v4-flash
ANTHROPIC_DEFAULT_FABLE_MODEL留空受控超旗舰,fable5 曾遭出口管制后于 2026 年 7 月解禁,暂不填写
ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]旗舰模型,此处仍选 deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]均衡主力模型,主要承担任务,仍选 deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash轻量极速模型,选 deepseek-v4-flash 即可
API_TIMEOUT_MS3000000保持默认值
CLAUDE_CODE_EFFORT_LEVELmax最大思考强度,填 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 模型正常回复,说明配置链路畅通。

进阶自检:

  1. 对话中询问「你当前使用的模型完整名称是什么?」——回答应包含 deepseek
  2. 打开 DeepSeek 后台的 Usage 页面,执行一次操作后刷新——有新 token 消耗说明请求确实通过 DeepSeek
  3. 执行一轮包含「修改文件 + 运行 + 读取输出」的操作,确认工具调用正常

DeepSeek API 状态

DeepSeek Status:当使用 DeepSeek API 出现问题时,可访问此页面查看官方 API 状态是否异常。

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

至此,基础环境搭建完成。类似 GLM、Minimax 等也提供兼容 Anthropic 接口格式的服务,配置思路相同。

三、配套设施搭建

仅有 CLI 还不够,搭建配套设施能提升开发效率。

CC-Switch

当同时拥有 Anthropic 官方 API、DeepSeek API 及其他第三方中转 API 时,手动修改 settings.json 较为繁琐。CC-Switch 是一款桌面应用,可实现快速无缝切换,并支持 Token+金额消耗统计 和 多 CLI 管理。该工具已获得 110k+ 用户关注,值得尝试。

安装完成后打开应用,进入设置 -> 关于,查看本地环境能否识别到 Claude Code。若无法识别,请重新安装 Claude Code(CC-Switch 也提供一键安装功能)。

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

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

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

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

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

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

  • 1M
  • 最大思考强度

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

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

Vibecoding实战01:Claude Code第三方模型接入与Windows开发环境配置

OpenStart

这是通过 vibecoding 开发的一款 Windows GUI 工具,已开源,Github 地址:openstart。

主要功能:命令分组、一键调用、记录追溯。

  • 建议搭配 Windows Terminal,可在同一窗口的多个标签页中执行多条命令。
  • 设置中可开启开机自启动,配置后命令将自动执行。

下一章:Vibecoding 实战 #02: Claude Code 的实战配置