3步搞定Claude Code免登录配置:跳过Anthropic注册,打开就能直接用
最近不少人问我Claude Code能不能不注册Anthropic账号直接用毕竟官方注册不仅需要海外手机号专业版还得绑定境外支付卡对国内用户来说门槛确实不低。折腾了一下午摸出了一套通过本地配置文件直接注入模型的方案完全跳过官方的注册登录引导流程打开软件就能直接用。全程就3步亲测0.2.15及以上版本都能用不用改源码不用装插件。一、先讲透免登录的核心原理很多人以为Claude Code必须登录账号才能启动其实它的认证逻辑是分层设计的上层是官方账号体系用来同步配置、调用官方Claude系列模型、同步云端对话历史底层是本地配置加载逻辑只要本地配置文件里存在合法的模型提供商程序启动时会优先加载本地配置直接跳过账号引导环节简单说我们就是用本地自定义模型配置替代云端账号授权绕开注册登录步骤直接进入可用状态。免登录配置流程启动软件读取本地config.json加载自定义模型提供商跳过账号校验环节直接进入工作界面官方正常流程否是启动软件账号登录校验已登录?跳转注册/登录页加载云端模型列表进入工作界面当然这种方式也有明确边界免登录状态下无法使用官方的Claude模型只能用你自己配置的第三方模型。如果你主要是想接DeepSeek、通义千问或者本地Ollama模型用那这个方案完全适配。前置准备在开始配置之前先确认两个前提Claude Code版本≥0.2.10低于这个版本自定义模型支持不完善可能不生效准备好一个可用的OpenAI兼容API可以是第三方在线模型也可以是本地部署的Ollama二、3步实操完整免登录配置整个配置的流程我整理成了一张图跟着走不会乱是否开始配置定位系统对应配置目录创建/编辑 config.json写入模型配置 skip_onboarding 参数保存配置文件启动 Claude Code跳过登录引导?连续对话测试验证排查路径 / JSON格式 / 参数免登录配置完成第一步定位并创建配置文件Claude Code的本地配置文件是固定路径的不同系统位置不一样这是最高发的踩坑点不要找错目录。Windows%APPDATA%\Claude Code\config.json快速打开按下WinR粘贴路径直接回车会自动定位到对应目录如果没有config.json就手动新建一个macOS~/Library/Application Support/Claude Code/config.json快速打开访达里按CommandShiftG粘贴路径回车Linux~/.config/claude-code/config.json⚠️ 重要提醒不要和Claude桌面版的配置目录搞混两者是独立的软件路径完全不一样。找错目录改了半天也不会生效。第二步写入免登录核心配置打开新建的config.json把对应配置粘贴进去替换成你自己的API信息。这里以接入DeepSeek为例这是我自己在用的稳定配置{default_model:deepseek-chat,providers:[{name:deepseek,type:openai,base_url:https://api.deepseek.com/v1,api_key:sk-你的API_KEY,models:[{name:deepseek-chat,max_tokens:8192,streaming:true,timeout:30}]}],ui:{skip_onboarding:true}}三个核心参数必须写对default_model设置默认使用的模型启动后直接加载该模型不会再弹出选模型或登录的引导providers自定义模型提供商列表严格按照OpenAI兼容格式填写ui.skip_onboarding免登录的核心开关设为true会直接跳过新手引导和账号登录页面⚠️ 格式注意JSON语法严格不要留中文注释不要多写末尾逗号否则配置文件会读取失败自动回退到登录流程。如果想用本地Ollama实现完全离线使用配置也几乎一致只需要改接口地址{default_model:qwen2.5:7b,providers:[{name:ollama,type:openai,base_url:http://localhost:11434/v1,api_key:ollama,models:[{name:qwen2.5:7b,max_tokens:8192,streaming:true,timeout:60}]}],ui:{skip_onboarding:true}}第三步启动验证与功能测试配置保存好之后直接启动Claude Code。免登录成功的三个判断标志启动后没有弹出登录窗口也没有Anthropic账号登录的引导页面右上角没有用户头像图标只会显示当前使用的模型名称可以直接发送消息模型正常返回流式响应建议连续发3-5轮对话测试代码生成、文件引用、上下文联想是否正常确认没有断连或者报错就算配置完成了。三、进阶优化多模型与性能调优1. 添加多个模型自由切换可以在providers里加多个服务商也可以在一个服务商下加多个模型启动后可以自由切换{default_model:deepseek-chat,providers:[{name:deepseek,type:openai,base_url:https://api.deepseek.com/v1,api_key:sk-你的KEY,models:[{name:deepseek-chat,max_tokens:8192,streaming:true},{name:deepseek-reasoner,max_tokens:8192,streaming:true}]},{name:ollama,type:openai,base_url:http://localhost:11434/v1,api_key:ollama,models:[{name:qwen2.5:7b,max_tokens:8192,streaming:true}]}],ui:{skip_onboarding:true}}2. 性能参数调优国内访问在线API建议把timeout调到30秒以上避免网络波动导致超时中断本地大模型可以把timeout调到60秒长文本生成时不容易触发超时不需要云端同步的话可以关闭对话历史记录减少本地存储占用四、高频踩坑排查1. 配置完还是弹出登录窗口90%的情况是这三个原因配置文件路径错了找成了Claude桌面版的目录JSON格式有语法错误比如多了逗号、用了中文引号ui.skip_onboarding参数没加或者值不是布尔类型2. 模型能选但发消息报错先检查base_url有没有写错末尾的/v1不能少然后检查API Key是否正确模型名称和服务商提供的是否一致。可以先用curl命令测一下接口通不通再排查配置问题。3. 免登录后还能用官方Claude模型吗不能。官方Claude模型必须通过Anthropic账号授权才能调用这是服务端的限制本地配置绕不开。如果之后想用官方模型正常登录账号即可本地配置不会被覆盖会自动叠加。4. 软件更新后配置会丢吗正常小版本更新不会覆盖本地配置但大版本升级有可能重置。建议重要配置备份一份更新后核对一下即可。五、总结这套免登录方案的本质是利用Claude Code本地配置优先的加载逻辑用自定义模型绕开官方账号体系。对于不想折腾海外注册、主要使用第三方模型或者本地模型的用户来说非常实用。整个配置过程不到5分钟纯配置操作不用修改软件文件没有风险。配置好之后和正常登录的体验基本没有差别除了不能调用官方模型代码编辑、文件操作、终端调用等核心功能都能正常使用。