Claude Code这半年来在AI编程圈子里的存在感非常强打开任何技术社区都能刷到它的实战案例。但我每天在社群里答得最多的反而不是“它能做什么”而是“我怎么装起来”“装好了怎么连到我的VSCode”“手头有几个不同的API入口难道每次都要重新改配置吗”,还有“本地有Ollama能不能也让Claude Code用上”。这类问题问的人很多但很少有人把整条链路讲透。所以我打算照着真实操作的顺序把Claude Code从零安装、接入VSCode、再通过CC Switch或Ollama连接不同模型来源的完整过程写清楚。无论你是第一次接触命令行AI工具还是已经折腾过几个配置文件的玩家都可以按这篇文章走一遍。1. 整体思路拆解先搞清楚要装什么、怎么连1.1 这次要做的事从零装好Claude Code并接入VSCode先说清楚目标我们要把Claude Code这个命令行编程助手装到本机然后让它能在VSCode的终端里直接运行并且可以通过切换配置把它的请求转发到不同的模型来源上。Claude Code本质上是Anthropic官方发布的一个命令行工具它在终端里运行可以读取你当前项目目录里的代码文件、生成修改建议、执行命令甚至帮你梳理代码逻辑。它不像普通插件那样装进VSCode的扩展列表里而是作为一个独立的CLI程序存在。你在VSCode里使用它不是靠点按钮而是靠打开集成终端、输入claude命令直接在终端里和它对话。连接这块是很多人卡住的地方。Claude Code默认请求的是Anthropic官方的接口地址同时需要一个有效的API Key。但实际使用中很多人拿到的API来源并不只有官方一家还有第三方兼容服务或者自己用Ollama部署的本地模型。要让Claude Code接上这些不同的来源核心思路就一句话让Claude Code把请求发到一个“本地入口”再由这个入口转给真正干活的模型服务。这篇文章里的CC Switch和Ollama本质上就是两种不同形态的“本地入口”。1.2 两条接入路线的本质区别CC Switch和Ollama虽然经常被放在一起讨论但它们解决的问题完全不同根本不是一个层级的东西。CC Switch是一个配置管理工具解决的是“多来源切换”问题。它会在本机启动一个API入口Claude Code所有请求都发到这个入口上然后由CC Switch根据你当前激活的配置把请求转给对应的上游服务。上游可以是Anthropic官方也可以是DeepSeek这类兼容OpenAI格式的接口。你可以把多套API Key、多个模型地址都存进去在界面里点一下就能切换Claude Code那边完全不用改环境变量。Ollama是本地大模型运行工具解决的是“模型在哪跑”的问题。它把开源模型直接拉到本机执行数据不出电脑、不按调用次数付费。但Ollama本身提供的是OpenAI兼容接口不是Anthropic格式。而Claude Code默认只说Anthropic的“语言”。所以Ollama想要被Claude Code调用中间必须有一层转换把Anthropic格式的请求翻译成OpenAI能理解的格式。这个转换层恰好又可以用CC Switch来充当。所以严格讲这两条路线不是对立的甚至可以叠加使用CC Switch充当调度和转换层Ollama充当本地模型提供方。很多人的最终配置就是这样的组合。1.3 方案选型的判断标准你的实际情况决定你选哪条路线我在实际帮人排查时基本按这三个维度看第一模型来源的数量。如果你只有一个官方API Key直接用官方配置就行CC Switch不是必需品。但如果你手里有好几个来源比如一个官方、一个第三方兼容、一个公司内部网关那强烈建议装CC Switch不然每次切换都要改一遍环境变量还要记住不同来源对应的模型名非常容易出错。第二数据敏感程度。代码是要留在本机还是可以传到云端API如果涉及未公开的项目、客户代码、或者你有“绝对不能让代码出内网”的合规要求本地模型是更安全的选择。Ollama方案下的请求完全不离开本机除了下载模型的那一次。第三硬件成本承受能力。本地跑模型需要显存和内存支撑。想流畅跑代码任务至少需要一张8G以上显存的显卡或者容量足够大的内存跑纯CPU版本。如果机器配置一般还是走云上API更现实。判断清楚这些之后再往下看安装和环境配置就会顺很多。2. 基础环境安装装好Node.js、VSCode与Claude Code2.1 Node.js环境准备Claude Code是Node.js写的命令行工具所以Node.js是第一个必须装的基础环境。这一步出问题的人很多因为不少新同学电脑上根本没装过Node或者装的是很老的版本。建议直接到Node.js官网下载LTS长期支持版本也就是页面左侧那个标着“Recommended for Most Users”的安装包。安装过程中一路默认即可不需要改任何配置。装完之后打开终端Windows上是CMD或PowerShellmacOS上是自带的终端分别输两条命令验证node -v npm -v能打印出版本号比如v20.11.0和10.2.4就说明环境OK。如果提示“node不是内部或外部命令”说明安装时没有把Node加入系统环境变量最常见的原因是安装时取消了默认勾选的PATH配置重装一遍、保持默认勾选就好。如果版本低于16建议直接装新版因为Claude Code对较老的Node运行时有兼容性问题跑起来会报一些莫名其妙的模块错误。2.2 VSCode的安装与终端集成VSCode本身不用多说直接到官网下载安装包即可。安装完以后有一个细节值得注意第一次打开VSCode时建议按CtrlShiftPmacOS是CommandShiftP输入“install code command”选择“在PATH中安装code命令”。这个操作不是必须的但对于后面在任意目录里快速打开项目、在命令行里启用VSCode能省很多事。然后就是重点VSCode的集成终端。你不需要额外装任何Claude Code插件这个工具就跑在终端里。在VSCode里按Ctrl\反引号就能打开集成终端。集成终端的最大优势是它自动继承了当前打开的工作区路径你在终端里运行claude它立刻就能看到左侧Explorer里的所有文件不需要手动cd来cd去。这一点比独立终端体验好非常多。如果你在Windows上用WSL开发那需要注意集成终端右上角有一个下拉箭头可以选择默认终端类型建议选成WSL终端。因为Claude Code需要在WSL的Linux环境里也装一份Node和Claude Code才能正确处理Linux路径下的项目文件。这是Windows用户最容易漏掉的一步很多“Claude Code找不到文件”的问题其实都是终端连到了Windows侧而项目在WSL侧导致的。2.3 安装Claude Code本体环境就绪之后安装Claude Code本体其实只需要一条命令npm install -g anthropic-ai/claude-code-g参数表示全局安装装完之后这个命令在任意终端里都能直接用。安装过程取决于网络状况正常几十秒到几分钟不等。如果没有报错运行claude --version能看到版本号就说明安装成功了。这里有个常见坑如果你之前装过旧版本的Claude Code升级时偶尔会遇到权限问题特别是macOS上。处理办法是卸载重装npm uninstall -g anthropic-ai/claude-code npm install -g anthropic-ai/claude-codeClaude Code安装完成后第一次运行还需要身份验证也就是把API Key配进去。如果你有Anthropic官方渠道的Key可以直接设置环境变量export ANTHROPIC_API_KEY你的Key也可以在运行claude之后按照交互提示登录。这个变量是会话级的终端窗口关掉就失效了。想要永久生效Windows用户可以用setx命令macOS和Linux用户把export那行写进~/.zshrc或~/.bashrc。2.4 安装后的基础验证别急着开始干活先做一个最小验证在项目目录下运行claude等它进入交互界面后问一句“请阅读当前目录的项目结构并告诉我这是一个什么类型的项目”。这一步能检验三件事第一Claude Code能不能成功连上API第二它能不能正确读取当前工作目录第三终端输出是否正常。如果这一步就报错绝大多数问题集中在API Key无效、网络不通、或者模型权限不足这三类。先把这些前置问题清掉再往下做连接CC Switch或Ollama的配置否则你会分不清问题到底出在哪一层。3. 路线一用CC Switch管理多种上游API3.1 CC Switch到底解决了什么痛点没有CC Switch的时候在Claude Code里使用非官方API是一项很烦人的操作。你需要手动设置ANTHROPIC_BASE_URL环境变量把它指向第三方的接口地址同时还要设置API Key并且这套配置是全局的改一次就影响所有终端会话。如果你同时维护官方和第三方两套来源切换起来就得反复改环境变量、重启终端、确认配置生效非常痛苦。CC Switch就是冲着这个痛点来的。它实际上是一个桌面工具界面里可以维护多套完整的连接配置每一套配置包括接口地址、API Key、模型名称、请求格式等。你在界面里选中哪一套Claude Code后续的请求就会通过CC Switch自动转到那一套上游。而且CC Switch内置了一个本机转发服务Claude Code只需要固定指向这个服务剩下的事情交给CC Switch处理。它还有一个常被忽略的好处是协议转换。上面说过Claude Code默认只会发Anthropic格式的请求但很多第三方API是OpenAI格式的。CC Switch在转发过程中会做一次格式翻译把Claude Code发来的请求转成目标接口能理解的结构。这也是为什么CC Switch不仅能配Anthropic官方还能配DeepSeek、本地Ollama等各类OpenAI兼容接口。3.2 安装CC SwitchCC Switch安装很简单到它的GitHub Releases页面下载对应操作系统的安装包即可。Windows下是exe安装包macOS下是dmg文件。安装完成后打开第一次启动会自动扫描你机器上已有的Claude Code配置把已有的API Key和设置识别出来非常省事。打开后你会看到一个主界面左侧通常是配置列表和导航右侧是当前选中配置的详细参数。这个工具的界面风格很直观一般不需要看文档就能上手。安装完成后我建议你把Claude Code的请求入口改成CC Switch的本地地址。具体操作是在CC Switch主界面找到“本地入口地址”或者类似的字段它通常长这样http://127.0.0.1:3456然后在终端里设置环境变量让Claude Code把请求发到这里export ANTHROPIC_BASE_URLhttp://127.0.0.1:3456注意端口号以你CC Switch界面里实际显示为准不同版本可能不同。设置之后建议在终端里先echo $ANTHROPIC_BASE_URL确认变量真的设置成功了再启动Claude Code。3.3 配置上游供应商与接口参数接下来就是核心配置环节。在CC Switch里新增一条配置需要填几个关键参数我一个个解释。首先是供应商名称这个随便起比如“官方”“DeepSeek”“本地测试”都行方便你自己识别即可。然后是接口类型这一项比较关键。如果你用的是Anthropic官方接口或者兼容Anthropic格式的服务类型选Anthropic如果用的是OpenAI格式的服务比如DeepSeek、Ollama类型选OpenAI兼容。选错类型会导致请求格式对不上报错信息通常是“接口返回无效请求”或者一堆400错误。接着是接口地址。以DeepSeek为例它是OpenAI兼容格式接口地址填它官方文档里给出的基地址即可。API Key填你在DeepSeek开放平台申请的密钥。模型名也要填对比如DeepSeek这边可以填deepseek-chat,不同的来源支持的模型列表不一样填一个不存在的模型名接口会直接返回404。全部填完之后保存并在列表里激活这条配置。激活的意思是后续所有从CC Switch本机入口进来的请求都会被转给这条配置对应的上游。激活之后先回到终端跑一次claude随便问一句话测试一下。如果CC Switch界面里能看到这次请求的记录并且终端有正常回复就说明整条链路已经通了。3.4 在VSCode中调用并验证验证通过之后回到VSCode的集成终端。你会发现只要之前设置过ANTHROPIC_BASE_URL和激活了正确的CC Switch配置直接在项目目录运行claude就能用了。这时的体验跟用官方API几乎一模一样Claude Code可以读取文件、生成diff、执行终端命令唯一的区别是请求真正落到了你选的那个上游模型上。这里有一个很重要的使用习惯在VSCode里跑Claude Code之前先通过顶部菜单“文件”-“打开文件夹”把项目根目录打开而不是直接在终端里手动cd进去。因为Claude Code会以工作区作为安全边界你给它读取文件的权限范围默认就是工作区目录。先打开文件夹再开集成终端Claude Code读文件、搜代码的路径就完全正确不会出现“你让它看文件它说文件不存在”这种尴尬情况。如果你同时装了VSCode的Codex扩展CC Switch也可以管这一路。Codex扩展同样支持把请求地址指向本地入口你只需要在CC Switch里再配一条Codex用的上游即可。这样一来Claude Code和Codex在VSCode里共用同一套配置管理切换模型时改一处就行。3.5 多配置切换的实际体验CC Switch最爽的使用场景就是多配置切换。我这边常驻三条配置官方Claude、一个OpenAI格式的第三方服务、还有一个本地Ollama。平时写复杂重构用官方跑批量小任务换成第三方完全离线调试时切到本地Ollama。整个切换过程就是在CC Switch界面里点一下目标配置然后回到终端直接继续对话Claude Code不需要重启环境变量不用改非常顺滑。需要提醒的是切换模型后Claude Code对当前会话的上下文理解能力会变。比如官方模型支持的工具调用很完整切到本地小模型之后同样的工具调用可能就执行不了表现就是Claude Code进入“反复思考但不动手”的循环。这种情况不是你配置错了而是当前模型的能力上限。我的习惯是切换配置后新开一个会话不要复用之前模型跑出来的上下文。4. 路线二用Ollama把本地模型接入Claude Code4.1 Ollama的定位与适用场景Ollama是目前把本地大模型跑起来最省事的工具没有之一。它把模型下载、依赖安装、服务启动、OpenAI兼容API暴露这些问题全部封装好了。你只需要装一个Ollama然后用一条命令就能把模型拉下来跑起来连Python环境都不用自己配。Ollama适合以下三类场景第一代码不能出内网公司有合规要求第二想先低成本体验不同开源模型的实力不想每个都去申请付费API第三网络条件不稳定希望有一个完全离线的开发环境。但说实话本地模型在Claude Code这种Agent场景下的表现跟云端顶级模型还是有明显差距的这点要有心理预期。本地模型更擅长的是代码补全、单文件修改、简单问答复杂的多文件重构经常力不从心。4.2 安装Ollama并拉取模型Ollama安装就两步到官网下载对应操作系统的安装包然后双击安装。安装完成后终端里验证ollama --version能看到版本号就说明装好了。如果下载安装包时网络不理想可以留意一下社区整理的镜像资源这个我就不展开说了。接下来是拉取模型。Claude Code是编程工具所以本地模型优先选代码能力强的系列。我实测下来Qwen2.5-Coder系列和DeepSeek-Coder系列的表现相对靠谱。拉取命令很简单ollama run qwen2.5-coder:7b这条命令会先下载模型再自动进入交互对话界面。第一次运行要等一会儿取决于网速和模型大小。7B的量化模型大概4到6个G14B的量化模型大概9G左右建议磁盘预留足够空间。拉取完成之后Ollama会在本机启动一个服务默认监听11434端口。这个服务本身就提供OpenAI兼容接口地址是http://127.0.0.1:11434/v1拿浏览器或者curl访问这个地址能看到响应就说明Ollama服务正常。4.3 让Claude Code访问本地模型的关键一步这里回到之前说的核心问题Claude Code默认说Anthropic格式Ollama只懂OpenAI格式两者不能直接对话中间必须要有一层转换。最省事的转换方式就是利用CC Switch。具体操作分三步。第一步在CC Switch里新增一条上游配置类型选OpenAI兼容接口地址填http://127.0.0.1:11434/v1API Key随便填一个占位符比如ollama模型名填你实际拉取的模型名比如qwen2.5-coder:7b。第二步激活这条配置。第三步回到VSCode终端确认ANTHROPIC_BASE_URL指向的还是CC Switch的本地入口然后启动claude随便问一句“用Python写一个快速排序”。请求路径是这样走通的Claude Code - CC Switch本地入口 - CC Switch把Anthropic格式转成OpenAI格式 - Ollama - 本地模型生成结果 - 原路返回。整个过程完全在本机完成断网也能用。如果不想用CC Switch也可以找其他支持协议转换的网关工具原理一模一样核心就是“Claude Code只认Anthropic格式需要一个翻译官”。但CC Switch的优势在于它同时还能管理其他云端API配置不需要为Ollama单独搭一套环境。4.4 本地部署的优劣势与硬件建议本地部署的实际体验我直说可用但别抱太高期待。优势非常明确隐私安全、无订阅成本、离线可用、请求延迟低不需要上传到远程服务器。劣势也同样明显模型能力受限尤其Claude Code依赖的工具调用能力本地模型经常执行不完整上下文窗口相对云端模型偏小处理大项目时经常“记不住”前面聊过的内容对硬件要求高参数太小的模型又不够聪明质量很难兼得。硬件方面我的经验是跑7B量化模型至少需要8G显存的显卡或者32G内存用CPU硬扛。跑14B量化模型建议16G以上显存。没有独显的轻薄本只能跑3B到7B的极小模型用来体验可以做正经开发就不太现实了。如果你决定长期用本地模型我建议从7B参数量的代码模型起步先摸清自己机器的负载能力再决定要不要上更大的模型。Ollama可以随时一条命令切换模型这个试错成本很低。5. 常见问题与排查技巧实录5.1 两类高频基础报错401和404我在各个群里看到最多的报错第一是401 Unauthorized第二是404 Not Found。401的含义是身份验证没过。检查顺序通常是这样先确认API Key本身没错复制粘贴时注意有没有多一个空格或者少一个字符再确认这个Key对应的服务是否已经开通相应模型权限最后确认环境变量是否真的生效了在终端里echo $ANTHROPIC_API_KEY看一眼。如果是通过CC Switch转发还要检查CC Switch里那条上游配置的Key有没有填对、这一条配置是不是真的处于激活状态。404的含义是请求的接口地址不存在。这个报错最常见的原因是接口地址填错了路径比如多写了/v1或者少写了/chat/completions。另一个常见原因是模型名填错了上游服务没有叫这个名字的模型。我见过好多次把模型名写成“deepseek-v4-flash”这种不存在的名字结果接口直接返回404。排查时先确认地址和模型名再去检查日志。我把这两类问题整理成一个速查表方便对照报错核心含义排查优先级401 Unauthorized身份认证失败1. API Key 2. 权限开通 3. 环境变量404 Not Found地址或模型不存在1. 接口路径 2. 模型名 3. 转发层版本连接失败本地入口没起来1. CC Switch是否运行 2. 端口占用 3. Ollama服务请求超时模型响应太慢1. 模型过大 2. 本机负载 3. 云端限流5.2 DeepSeek思考模式下的reasoning_content报错如果你在CC Switch里配置了DeepSeek系列模型并且尝试在VSCode的Codex扩展里使用很可能会撞上一个非常具体的报错。大致信息是CC Switch的本地转发组件在处理codex端点的/responses请求时失败上游返回HTTP 400原因是在thinking mode下reasoning_content必须原样回传给API。这个报错听起来拗口但实际原因不算复杂。DeepSeek的思考模型在多轮对话时会先返回一段推理过程也就是reasoning_content字段。当你继续对话时DeepSeek要求客户端必须把上一轮返回的这段推理内容连同新一轮请求一起发回去否则服务端就认为上下文不完整直接拒绝请求返回400。CC Switch在转发过程中如果没把这个字段完整透传就会触发这个错误。我给你的排查建议按顺序来。第一如果你不需要思考模式直接换用DeepSeek的对话模型也就是不带推理过程的那个类型就不会有这个限制。第二更新CC Switch到最新版本这个字段透传问题属于典型的转发层适配缺陷新版本大概率已经修复。第三检查在CC Switch里有没有类似“透传模式”“保留上下文”的开关把它打开再试。第四如果以上都不行暂时放弃用CC Switch转发这条链路直接用DeepSeek官方推荐的方式接入先保证能用再考虑统一管理。5.3 其他踩坑点与长期使用建议再分享几个零散但容易踩的坑。第一个是npm安装Claude Code失败。失败原因千奇百怪但大多数是网络问题。如果你所在网络访问默认npm源确实很慢可以换用社区公共镜像源再装一次npm config set registry https://registry.npmmirror.com这在国际国内开发中都很常见不涉及任何特殊网络行为纯粹的包管理操作。装完之后如果要恢复默认源用npm config delete registry即可。第二个是中文乱码。在VSCode终端里跑Claude Code时如果输出的中文变成乱码多半是终端的编码设置不对。Windows下把终端默认编码切到UTF-8在VSCode里按CtrlShiftP输入“encoding”选择“通过编码保存”并切到UTF-8。macOS和Linux一般不用管。第三个是本机端口冲突。如果你发现Claude Code连不上CC Switch先确认CC Switch真的在运行然后检查端口有没有被其他程序占用。macOS和Linux下用lsof -i:端口号Windows下用netstat -ano | findstr 端口号看到占用进程就换个端口或者关掉冲突程序。最后给长期使用者一个建议把常用的配置命令和验证步骤记成一个markdown备忘放在自己本机。因为这类工具更新很快环境变量、端口、模型名都可能变凭脑子记迟早出错。每次换机器或者帮同事排错翻转这份备忘比现场查文档快得多。我自己的经验是把“环境变量设置、CC Switch激活步骤、Ollama常见模型列表、三条常用验证命令”这四块记下来基本覆盖90%的日常使用需求。