Claude Code + Ollama/CC Switch AI Agent部署指南

来源：互联网 2026-07-17 06:25:15

Claude资讯合集

Windows11上配置ClaudeCode有两种方式：NPM全局安装或Winget原生安装。通过Ollama拉取qwen3模型并配置环境变量，或使用CCSwitch一键切换至DeepSeekv4、ZenMux等后端，简化模型管理流程。

Windows11 Claude Code 简单的配置指南

文档版本修订

日期	修订内容	修订人
2026/05/21	初始版本创建，包含 Claude Code + Ollama 和 Claude Code + CC Switch 两种安装方式	阿米亚波
2026/05/25	新增 CC Switch 使用 ZenMux 新增 DeepSeek token 消耗大问题，关闭 CC 的随机 CCH 指纹配置	阿米亚波

在正式开始之前，先大致梳理下两种Claude Code的安装方式，这样大家心里有个底。 * **方式一：NPM 全局安装** * 依赖Node环境 * 适合原本就用Node开发的用户 * 容易遇到全局包路径冲突 * **方式二：Winget 原生安装（推荐新方案）** * 无任何依赖，不需要装Node.js * Windows 官方包管理器，纯净干净 * 脱离前端环境，无冗余依赖 * 最适配搭配 CC Switch 一键切换模型这里有个小窍门：方式二用了CC Switch，它能直接帮你切换到Ollama。所以，当Ollama装好后，直接跳到方式二的步骤就行，最后用CC Switch切到Ollama，让Claude Code去用。这样做既省了手动配置环境变量的麻烦，也能避免在方式二初次打开CC Switch时，出现提示要求删除环境变量的情况。

方式一: Claude Code + Ollama

安装 Ollama

下载 Ollama 安装包

直接去Ollama官方下载页面，下载并安装最新版本。就是这么简单，双击安装包，一路“下一步”就行。

安装 Python ollama 库

`python -m pip install ollama`

验证 Ollama 安装

在PowerShell里输入： `ollama` 如果出现类似下面的内容，那就恭喜，安装成功了： `PS C:Usersadmin> ollamaOllama 0.23.2 Chat with a model (qwen3)Start an interactive chat with a modelLaunch Claude CodeAnthropic's coding tool with subagentsLaunch OpenClaw (install)Personal AI with 100+ skillsLaunch Hermes Agent (install)Self-improving AI agent built by Nous ResearchLaunch OpenCode (not installed)Anomaly's open-source coding agentMore...Show additional integrations↑/↓ na vigate enter launch → configure esc quit`

拉取 qwen3 模型

`ollama pull qwen3` Ollama上能用的模型，可以去Ollama官方库看看。

验证 Ollama 服务与模型

打开PowerShell，执行这些命令： ``` # 1. 检查 Ollama 版本（需要 ≥ 0.1.32，因为要支持 Anthropic API） ollama --version # 2. 确认 qwen3 模型已经下载好了 ollama list # 输出里应该能看到 qwen3:latest 之类的 # 3. 测试一下能不能正常对话 ollama run qwen3 # 输入"你好"，能正常回话就没问题，按 Ctrl+C 退出 ``` 其他常用指令： ``` # 删除 qwen3 模型，qwen3是模型NAME，可以换成其他的 ollama rm qwen3 ```

npm 安装

安装 Node.js

下载 Node.js 安装包

去Node.js官方下载页面，下载并安装最新的LTS版本。

验证

Node.js装完后，重启一下PowerShell，然后敲这两个命令： `node -vnpm -v`

安装 Claude Code

安装

上面两步都没问题的话，就可以直接装Claude Code了： ``` # 安装 Claude Code npm install -g @anthropic-ai/claude-code # 验证安装 claude --version ``` 其他命令： ``` # 更新 Claude Code npm update -g @anthropic-ai/claude-code # 卸载 Claude Code npm uninstall -g @anthropic-ai/claude-code # 卸载完成后，验证一下 # PS E:Personal\Amiable总结\ClaudeCode> npm uninstall -g @anthropic-ai/claude-code # removed 2 packages in 333ms # PS E:Personal\Amiable总结\ClaudeCode> claude --version # claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。…… ```

配置环境变量

打开环境变量设置界面

1. 按键盘 `Win + R`，输入 `sysdm.cpl`，回车。 2. 在弹出的窗口中，切换到“高级”选项卡。 3. 点击右下角的“环境变量”按钮。

添加两个环境变量

弹出的界面分上下两部分：用户变量和系统变量。推荐配置在用户变量里，这样不需要管理员权限，更安全。 1. **新建第一个变量** 点击“新建”，填写： * 变量名: `ANTHROPIC_BASE_URL` * 变量值: `http://localhost:11434` 然后点“确定”。 2. **新建第二个变量** 再次点击“新建”，填写： * 变量名: `ANTHROPIC_AUTH_TOKEN` * 变量值: `ollama` 点“确定”。

最终生效

把所有打开的窗口都点“确定”保存。然后**务必要关闭当前所有PowerShell/终端窗口**，重新打开一个新的PowerShell窗口。新窗口打开后，不需要再设置任何环境变量，直接运行： `claude --model qwen3`

方式二: Claude Code + CC switch

> 注意：这里接入DeepSeek v4模型，是需要Money的哦。 > 注意：这里接入DeepSeek v4模型，是需要Money的哦。 > 注意：这里接入DeepSeek v4模型，是需要Money的哦。重要的事情说三遍。

安装 Claude Code

``` # Winget安装命令 winget install Anthropic.ClaudeCode # 安装完成后需要重启 CMD/PowerShell 才能使用 ``` 安装过程会有进度提示。 Claude Code + Ollama/CC Switch AI Agent部署指南

其他命令： ``` # 更新 Claude Code winget upgrade Anthropic.ClaudeCode # 卸载 Claude Code winget uninstall Anthropic.ClaudeCode ```

获取 DeepSeek API Key

1. 前往DeepSeek官网。 2. 注册账号。 3. 登录账号，并完成实名认证。 4. 点击“API Key”进入管理页面。 Claude Code + Ollama/CC Switch AI Agent部署指南

5. 点击“创建 API Key”。创建成功后，会弹出一个窗口显示Key，一定要**复制并保存好**。如果忘了，就只能重新创建一个了。

安装 CC switch

下载 CC switch 安装包

去CC switch官网下载安装包。直接下载 `CC-Switch-v3.15.0-Windows.msi` 这个文件。 Claude Code + Ollama/CC Switch AI Agent部署指南

CC Switch 界面

提示删除环境变量

如果你之前配置过那两个环境变量，CC switch会自动识别并提示你删除。我因为之前用Ollama时配过，所以收到了这个提示。 Claude Code + Ollama/CC Switch AI Agent部署指南

正常界面

安装完成后，CC switch会在桌面创建快捷方式，任务栏里也会有个图标。点击图标就能打开主界面。 Claude Code + Ollama/CC Switch AI Agent部署指南

配置 CC switch

添加 deepseek

添加一个供应商

1. 在“预设供应商”中，选择 `DeepSeek`。 2. 输入刚才保存的DeepSeek API Key。 3. 配置JSON。这部分内容需要参考DeepSeek API文档中关于Claude Code的配置说明。 ``` { "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key", "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash", "CLAUDE_CODE_EFFORT_LEVEL": "max" }, "theme": "dark" } ``` 4. 点击“添加”。 Claude Code + Ollama/CC Switch AI Agent部署指南

启动 Claude Code

* 在CMD或PowerShell中运行： `claude` * 问一个问题“你是什么模型”。如果出现： `API Error: 402 Insufficient Balance` 这就对了。这是DeepSeek API的常规操作，潜台词就是：该充钱了。 Claude Code + Ollama/CC Switch AI Agent部署指南

* 先充值10块钱，然后再问一次，就能正常显示了。 Claude Code + Ollama/CC Switch AI Agent部署指南

CC switch 切换 Ollama 模型

有了CC Switch，切换Ollama模型就变得非常轻松，不用再去手动改环境变量了。按照添加DeepSeek的步骤，再添加一个Ollama的配置就行。具体参数如下： * API Key: `ollama` * 请求地址: `http://localhost:11434` * 模型映射: `qwen3` (这是你在Ollama里下载的模型NAME) Claude Code + Ollama/CC Switch AI Agent部署指南

启动 Claude Code 询问问题

配置好后，在Claude Code里跑一下，看看效果。 Claude Code + Ollama/CC Switch AI Agent部署指南

VS Code 的 Claude Code 插件

搜索 Claude Code 插件

在VS Code的扩展商店里直接搜索就行。 Claude Code + Ollama/CC Switch AI Agent部署指南

问问题

比如，让它“分析当前目录结构”，它能正常执行并给出结果。 Claude Code + Ollama/CC Switch AI Agent部署指南

两个问题的消耗

花费

这是DeepSeek v4 pro和flash模型的API请求次数和Token消耗情况，可以作为参考。

deepseek-v4-pro

API请求次数

Tokens

deepseek-v4-flash

API请求次数

Tokens

CC Switch 使用 ZenMux

官网登陆后，进入 PAYG API 页面

登录ZenMux官网，找到PAYG API页面。 Claude Code + Ollama/CC Switch AI Agent部署指南

创建 API 密钥

点击创建，在弹出的窗口中选择“确定”后，会显示API密钥。复制并保存好。 Claude Code + Ollama/CC Switch AI Agent部署指南

配置 CC switch

按照之前添加供应商的方式，再新增一个ZenMux的配置。 Claude Code + Ollama/CC Switch AI Agent部署指南

关键的配置项如下： * **API Key**: 刚才保存的PAYG API密钥。 * **请求地址**: `https://zenmux.ai/api/anthropic` * **实际请求模型**: 根据你想用的模型，填写对应的ZenMux模型名称。下面这个图里红框框出来的就是。 Claude Code + Ollama/CC Switch AI Agent部署指南

* **完整的 JSON 配置**：关键字段说明一下。 * `ANTHROPIC_API_KEY`: 留空。 * `ANTHROPIC_AUTH_TOKEN`: 填刚才创建并保存的PAYG API密钥。 * `ANTHROPIC_BASE_URL`: `https://zenmux.ai/api/anthropic` * `ANTHROPIC_DEFAULT_*_MODEL`: 根据需求填写对应的ZenMux模型名称。 * `API_TIMEOUT_MS`: API请求超时时间，单位毫秒，默认30000000。 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`: 禁用非必要流量，默认值为1。 ``` { "env": { "ANTHROPIC_API_KEY": "", "ANTHROPIC_AUTH_TOKEN": "你的 PAYG API 密钥", "ANTHROPIC_BASE_URL": "https://zenmux.ai/api/anthropic", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "z-ai/glm-4.7-flash-free", "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "ZenMux-GLM-4.7-Free", "ANTHROPIC_DEFAULT_OPUS_MODEL": "z-ai/glm-4.7-flash-free", "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "ZenMux-GLM-4.7-Free", "ANTHROPIC_DEFAULT_SONNET_MODEL": "z-ai/glm-4.7-flash-free", "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "ZenMux-GLM-4.7-Free", "API_TIMEOUT_MS": "30000000", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", "CLAUDE_CODE_EFFORT_LEVEL": "max" }, "theme": "dark" } ``` 实际上，上面这个JSON，就是根据ZenMux官网的`Claude Code Integration`指南里，Windows PowerShell的命令整理出来的。官方推荐在PowerShell Profile里配置环境变量，但用CC Switch来管理会更方便直观。 ``` # ... 这里省略了官方的PowerShell配置步骤，因为用CC Switch已经能搞定了 ... ```

Claude Code 环境变量

Claude Code官方文档里有详细的环境变量配置说明。这些变量都可以在CC Switch中配置，用来改变Claude Code的行为。

DeepSeek token消耗大问题

这不仅仅是DeepSeek的问题，其他第三方API也可能会遇到。核心原因在于一个“CCH指纹”问题。 Claude Code每次请求，都会在系统提示词的开头插入一个随机变的`cch=`字符串（也就是请求指纹）。Claude官方服务器认识这个CCH，计算缓存时会自动忽略它。但DeepSeek和其他第三方API不认识，会把它当成普通内容参与缓存匹配。这就导致每次请求的前缀都不同，缓存就总是命中不了，Token消耗自然就大了。

DeepSeek-上下文硬盘缓存-缓存落盘与命中规则

根据DeepSeek官方的缓存文档，缓存命中的前提是相应前缀已经被“落盘”到硬盘缓存里。并且，每条缓存前缀是一个独立完整的单元，后续请求必须完整匹配这个前缀才能命中缓存。

Claude Code-Prompt caching-缓存的组织方式

根据Claude Code的提示缓存文档，API通过将每个请求的开始部分（前缀）与最近处理过的内容进行精确匹配来实现缓存。前缀中任何地方的改动，都会导致其之后的所有内容重新计算。这就解释了为什么CCH指纹的影响这么大。

配置关闭 CC 的随机 CCH 指纹

好消息是，可以通过一个环境变量来关闭这个功能。在CC Switch的配置JSON里加上： `CLAUDE_CODE_ATTRIBUTION_HEADER`: 设置为 `0`，就能关闭CC的随机CCH指纹。官方说明是：设置为0可以从系统提示的开头省略归属块（包含客户端版本和提示指纹）。禁用后，通过LLM网关路由时，能改善prompt caching的命中率。Anthropic自家的API缓存则不受影响。一个完整的、配置了该项的DeepSeek配置如下： ``` { "env": { "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key", "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]", "CLAUDE_CODE_EFFORT_LEVEL": "max", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash[1m]", "CLAUDE_CODE_ATTRIBUTION_HEADER": "0", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80", "API_TIMEOUT_MS": "30000000" }, "theme": "dark" } ``` 这一项小小的改动，就能解决大的麻烦。

侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述