在window10中搭建Hermes+Claude code
1.安装claude code
1.1.1 采用官方推荐方式安装
运行代理工具,启用“允许局域网”功能
查看本机局域网IP
# 打开powershell执行
$env:HTTP_PROXY="http://本机局域网IP:7890"
$env:HTTPS_PROXY="http://本机局域网IP:7890"
# 查看能否获取网页资源,能则可以继续安装claude code
curl.exe -fsSL https://claude.ai/install.ps1
# 安装claude code
irm https://claude.ai/install.ps1 | iex
运行calude --version命令,能够看到claude版本即安装成功,或者可以运行calude命令看看能否进入claude界面
注意:这种安装calude code可能会失败,我在两台电脑不同的网络下安装了的,一台成功了,一台失败了,失败那台我最后还是改用npm安装的。
node版本要求18.0+。
npm安装claude code
# 这种方式要求node版本`18.0+`
# 配置国内镜像源
npm config set registry https://registry.npmmirror.com
# npm安装claude code命令
npm install -g @anthropic-ai/claude-code
1.2. 安装cc-switch
下载cc-switch安装包:CC-Switch-v3.15.0-Windows.msi
其它版本的安装包自行在Assets中查找:https://github.com/farion1231/cc-switch/releases
1.3. 设置AI大模型
打开cc-switch按照提示设置即可,主要设置API_key、请求地址URL、大模型,也可以直接到原始的json中配置,这个json可以在cc-switch中配置,配置格式如下:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的api_key",
"ANTHROPIC_BASE_URL": "请求地址url",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的HAIKU大模型名称,如:deepseek-v4-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "你的OPUS大模型名称,如:deepseek-v4-pro-guan-cc",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "你的SONNET大模型名称,如:deepseek-v4-pro-guan-cc",
"ANTHROPIC_MODEL": "你的大模型名称,如:deepseek-v4-flash-cc",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
"CLAUDE_CODE_DISABLE_FAST_MODE": "1"
},
"theme": "dark"
}
环境变量配置含义一览表
| 环境变量 | 核心含义 | 在 Claude Code 中的作用 | 针对你的场景的说明 |
|---|---|---|---|
ANTHROPIC_MODEL |
全局默认模型 | 当 Claude Code 内部没有指定使用哪个能力等级的模型(Opus/Sonnet/Haiku)时,最终都会回退到调用此变量定义的模型。它拥有最高优先级,会覆盖下面的具体模型设置。 | 建议设置为你最常用、能力最均衡的模型,例如 deepseek-v4-pro-guan-cc。这样即使任务没有明确等级,也能保证一个稳定的核心体验。 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
顶级能力模型 | 专门用于替换 Claude Code 官方内部最高能力等级(Opus 级别)的模型。通常用于处理最复杂的架构设计、大规模重构等需要最强智能的任务。 | 适合配置你能力最强的模型,如 deepseek-v4-pro-guan-cc,以应对最复杂的开发挑战。 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
均衡能力模型 | 用于替换 Claude Code 官方内部的中坚力量(Sonnet 级别)的模型。这是日常开发、代码生成、调试的主力模型,在智能和速度/成本上取得平衡。 | 建议设置为一个性价比很高的主力模型,例如 deepseek-v4-pro-guan-cc,用于日常大部分编码任务。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
轻量快速模型 | 用于替换 Claude Code 官方内部轻量级、高速度(Haiku 级别)的模型。主要用于执行非常简单的子任务、快速问答或生成模板代码。 | 适合设置为一个响应极快、成本低廉的模型,例如 deepseek-v4-flash,用于处理简单任务,提升整体效率。 |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS |
稳定模式开关 | 当设置为 "1" 时,会禁用 Claude Code 中所有不稳定的、处于测试阶段的功能。这能有效避免因实验性功能与第三方平台(如 DeepSeek)不兼容而导致的错误。 |
强烈建议设置为 "1"。这是保证与 DeepSeek 这类第三方 API 稳定集成的关键,可以避免很多莫名其妙的问题。 |
CLAUDE_CODE_DISABLE_FAST_MODE |
高速模式开关 | 当设置为 "1" 时,会禁用 Claude Code 的“高速模式”。高速模式通过消耗更多 Token 来换取更快的响应速度。禁用后,响应会变慢,但能节省 Token 用量。 |
建议设置为 "1"(禁用)。考虑到你的目标是自动化且长时运行的任务,节省成本比追求毫秒级的响应速度更重要。 |
环境变量配置的核心要点总结
- 模型路由:前四个变量(
ANTHROPIC_DEFAULT_*和ANTHROPIC_MODEL)的核心作用,就是将 Claude Code 内部对三种能力等级的模型调用,精准地路由到你指定的 DeepSeek 模型上。 - 稳定优先:
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS是一个极其重要的稳定性开关,特别是对于 DeepSeek 这类非官方模型,强烈建议开启。 - 成本控制:
CLAUDE_CODE_DISABLE_FAST_MODE让你可以在响应速度和 Token 成本之间做出权衡。对于长时间的自动化任务,建议关闭高速模式以控制成本。
2. 安装Hermes
我这里是window10操作系统,可以用WSL或者window原生安装,建议能用wsl安装最好,据说window原生安装的是hermes的兼容版本,没有wsl的稳定,不能完美体验hermes的功能
2.1. WSL方式安装
win+R输入winver查看window系统版本。
先查看window版本和WSL安装版本关系
| WSL版本 | 可安装的window版本 |
|---|---|
WSL1 |
window10(1903以下版本) |
WSL2 |
window10(1903或更高版本)、window11 |
待验证
2.2. window方式安装
直接使用 Windows 原生 Hermes(不依赖 WSL)
Hermes 官方不支持原生 Windows,但社区脚本可以让它直接在 PowerShell 中运行。这种方式无需 WSL,也无需启用 Windows-Subsystem-Linux 功能。
安装命令(管理员 PowerShell):
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
安装后通过 hermes 启动,配置 API 密钥(如 DeepSeek / Kimi)。
然后通过创建桥接脚本调用 Windows 中已安装的 Claude Code。
优点:立即使用,不受 WSL 限制。
缺点:稳定性不如 WSL 版本,某些高级功能可能不完善。
2.2.1 源代码安装(一键安装命令失败的planB)
从github、gitee、gitlab三选一拉取hermes-agent源代码来安装。
创建指定目录,如:D:\code\editors\hermes
拉取命令
# github拉取
# 浅克隆(只获取最新提交)
git clone --depth 1 https://github.com/NousResearch/hermes-agent.git D:\code\editors\hermes
# gitee拉取
git clone https://gitee.com/eiDear/hermes-agent.git D:\code\editors\hermes
# gitlab拉取
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git D:\code\editors\hermes
拉取完后,执行以下命令:
# 1. 进入代码目录
cd D:\code\editors\hermes
# 2. 创建Python虚拟环境
uv venv --python 3.11
# 3. 激活虚拟环境
.\.venv\Scripts\activate
# 4. 安装Hermes核心依赖
uv pip install -e .
安装好后,运行hermes --version查看能正常读取版本信息不,可以获取则已安装好。结果如下:
(hermes) PS D:\code\editors\hermes> hermes --version
Hermes Agent v0.13.0 (2026.5.7)
Project: D:\code\editors\hermes
Python: 3.11.9
OpenAI SDK: 2.24.0
Up to date
(hermes) PS D:\code\editors\hermes>
更多推荐

所有评论(0)