Claude Code第三方模型接入与Windows开发环境配置实战指南_AI热点日报

Claude Code第三方模型接入与Windows开发环境配置实战指南

类型：热点整理2026-08-15

本文主要介绍了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.js 当前版本
node -v

Claude Code 安装

Node.js 环境准备好之后，就可以使用 npm 安装 Claude Code。（虽然 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 配置

为 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 API
再跑一轮包含「修改文件 + 执行运行 + 读取输出」的完整操作，确认工具调用链路也能正常工作

DeepSeek API 状态

DeepSeek Status：当你在使用 DeepSeek API 时遇到异常、报错或响应不稳定的问题，可以先到这里查看官方 API 服务状态，判断是否为平台侧故障。

到这里，Claude Code 基础开发环境就算搭建完成了。当然，像 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 的实战配置

来源：https://juejin.cn/post/7663419348321681458

windows

延伸阅读

补充最近整理过的热点入口。