1. 为什么 Claude Code 在隔离网络里总是卡在启动阶段Claude Code 这个工具本身设计成“始终在线”的形态它默认假设你能直连 Anthropic 官方服务。所以哪怕你只是想让它在内网里跑一个本地模型启动时它还是会做几件事检查 OAuth 登录状态、拉取 feature flags、检查版本更新、上报遥测数据。这些动作在无外网环境里全部会超时表现出来就是终端卡在 “Brewing” 或者反复提示 “Not logged in”。我试过在一台完全断网的 Windows 机器上直接claude结果它转圈转了将近两分钟才报错退出。后来把问题拆开看核心矛盾其实就三个第一启动时的 onboarding 检查强制要求一个“已完成登录”的标志第二后台有一堆非必要的网络请求在拖时间第三默认权限沙箱让每条命令都要人工确认自动化流程根本跑不起来。这篇要解决的就是这三件事。目标读者是需要在隔离网络、内网环境或者不想注册 Anthropic 账户的情况下把 Claude Code 当成一个纯本地编码代理来用的人。整条路径分四步先用 cc-switch 把 API 请求挂到本地或第三方兼容端点再伪造 onboarding 状态绕过登录拦截接着阻断所有非必要外网通信最后把权限全开让命令自动执行。走完之后Claude Code 在离线环境里就能像本地 IDE 一样接受指令并自动干活。需要提前说明的是cc-switch 在这里扮演的是 API 路由层的角色它把 Claude Code 发出的 Anthropic 格式请求转发到任意兼容 OpenAI 协议的端点。你可以把它理解成一个“协议翻译器 端点切换器”。而 TaoToken 提供的是统一的 Key 和 API 通道让你不用在多个 provider 之间反复改配置。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 后面配置里会反复用到。2. 前置准备cc-switch 安装与 TaoToken 统一 Key 获取在开始改配置之前先把工具链准备好。你需要三样东西Claude Code 本体、cc-switch 路由工具、以及一个可用的 API Key。Claude Code 的安装方式这里不展开假设你已经能执行claude --version并看到版本号本文实测环境是 v2.1.150。cc-switch 是一个独立的命令行工具负责管理多个 API provider 并在它们之间切换。2.1 安装 cc-switch 并确认可用cc-switch 的安装方式取决于你的包管理器。如果你用 npm 全局安装命令是npm install -g cc-switch安装完成后验证cc-switch --version cc-switch statuscc-switch status会输出当前启用的 provider 和 Base URL。如果是全新安装通常会显示 “No provider enabled”这是正常的下一步就来添加。2.2 获取 TaoToken 统一 KeyTaoToken 的作用是提供一个统一的 API 通道你不需要为每个模型单独申请 Key。进入控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite在控制台里创建一个新的 Key复制出来备用。这个 Key 后面会同时用在 cc-switch 的 provider 配置和 Claude Code 的环境变量里。如果你需要查看完整的接入文档入口在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite2.3 确认本地模型或第三方端点可达cc-switch 支持两种后端一种是本地部署的模型服务比如 vLLM、Ollama 暴露的 OpenAI 兼容接口另一种是远程的兼容端点。如果你走本地模型先确认服务已经起来curl http://localhost:8000/v1/models如果返回模型列表说明本地端点可用。如果走 TaoToken 的统一通道Base URL 填https://taotoken.net/apiKey 填刚才创建的那个。两条路都可以区别只在于 Base URL 和 Key 的来源。这里有个容易踩的坑cc-switch 的 provider 配置里Base URL 必须指向兼容 OpenAI 协议的/v1路径。如果你填的是https://taotoken.net/apicc-switch 会自动补全/v1但如果你填的是本地服务要确认它暴露的确实是/v1/chat/completions这样的路径。填错的话后面请求会直接 404。3. 可复制配置cc-switch provider settings.json 权限全开这一节是整篇的核心所有配置片段都可以直接复制。我按“先配路由、再配权限、最后配环境变量”的顺序来写每一步都有对应的文件路径和字段说明。3.1 cc-switch provider 配置JSON 片段cc-switch 的配置通常存放在用户目录下的.cc-switch/config.json。你可以直接用命令行添加也可以手动编辑配置文件。先看命令行方式以 TaoToken 统一通道为例cc-switch add --name TaoToken \ --base-url https://taotoken.net/api \ --api-key YOUR_TAOTOKEN_KEY cc-switch enable TaoToken cc-switch status执行完cc-switch status后应该看到类似输出Current provider: TaoToken (enabled) Base URL: https://taotoken.net/api如果你更习惯手动编辑配置文件对应的 JSON 结构是这样的路径~/.cc-switch/config.json{ providers: { TaoToken: { baseUrl: https://taotoken.net/api, apiKey: YOUR_TAOTOKEN_KEY, enabled: true } }, current: TaoToken }注意baseUrl字段不要带末尾斜杠cc-switch 内部会自己拼接路径。apiKey字段就是你在控制台创建的那个 Key。current字段决定当前激活哪个 provider。3.2 Claude Code 权限全开配置settings.jsonClaude Code 的权限配置有两个层级项目级和全局级。项目级放在项目根目录的.claude/settings.json全局级放在%USERPROFILE%\.claude\settings.jsonWindows或~/.claude/settings.jsonmacOS/Linux。推荐用项目级这样配置随仓库走换机器不会丢。项目级配置片段{ permissions: { allow: [ Bash(*), Edit(*), Write(*), Read(*), Glob(*), Grep(*), WebFetch(*), WebSearch, Agent(*) ], defaultMode: bypassPermissions }, skipDangerousModePermissionPrompt: true }关键字段解释defaultMode设为bypassPermissions后所有工具调用默认直接执行不再弹窗确认。skipDangerousModePermissionPrompt跳过启动时那个“你正在使用危险模式”的警告。allow列表里逐项声明允许的工具类别Bash(*)表示允许任意 Shell 命令Agent(*)允许创建子代理。全局级配置的 JSON 内容完全一样只是路径不同。Windows 下用 PowerShell 创建$claudeDir $env:USERPROFILE\.claude New-Item -ItemType Directory -Path $claudeDir -Force Set-Content -Path $claudeDir\settings.json -Value { permissions: { allow: [Bash(*), Edit(*), Write(*), Read(*), Glob(*), Grep(*), WebFetch(*), WebSearch, Agent(*)], defaultMode: bypassPermissions }, skipDangerousModePermissionPrompt: true } 3.3 伪造 onboarding 状态.claude.jsonClaude Code 启动时读取%USERPROFILE%\.claude.json判断是否完成过 onboarding。直接写入完成标志$claudeConfig $env:USERPROFILE\.claude.json {hasCompletedOnboarding: true} | Set-Content -Path $claudeConfig -Force Get-Content $claudeConfig这一步的作用是让 Claude Code 跳过 OAuth 登录检查。注意.claude.json是文件.claude是文件夹两者不要搞混。如果之前登录过官方账户文件里可能还有oauthAccount字段需要一并删除否则可能仍然触发登录流程。3.4 阻断非必要外网通信环境变量即使 API 流量已经走 cc-switchClaude Code 启动时仍会尝试连接官方服务。设置以下环境变量阻断$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1 $env:CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 1 $env:CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL 1 $env:DISABLE_AUTOUPDATER 1要让这些变量永久生效写入用户环境变量[Environment]::SetEnvironmentVariable(CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, 1, User) [Environment]::SetEnvironmentVariable(CLAUDE_CODE_DISABLE_BACKGROUND_TASKS, 1, User) [Environment]::SetEnvironmentVariable(CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL, 1, User) [Environment]::SetEnvironmentVariable(DISABLE_AUTOUPDATER, 1, User)四个变量的分工CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关掉遥测和 feature flag 拉取CLAUDE_CODE_DISABLE_BACKGROUND_TASKS关掉后台心跳和更新检查CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL禁止自动安装官方扩展DISABLE_AUTOUPDATER彻底关闭自动更新器。这四个一起设启动时的外网等待基本就消失了。4. 三步验证启动自检、请求回显、权限生效确认配置写完不代表能跑通必须做验证。我把它拆成三个动作每个动作都有明确的预期输出对不上就说明前面某步有问题。4.1 启动自检确认不再提示登录完全关闭所有终端窗口重新打开一个 PowerShell进入你的项目目录执行claude预期输出应该包含版本号、模型信息以及底部一行bypass permissions on。如果看到Not logged in或者卡在 “Brewing” 超过 10 秒说明 onboarding 伪造或环境变量没生效。先检查.claude.json内容Get-Content $env:USERPROFILE\.claude.json确认输出是{hasCompletedOnboarding: true}。如果文件里还有oauthAccount字段删掉再试。4.2 请求回显确认 API 流量走 cc-switch在 Claude Code 的交互界面里输入一个简单请求比如请用一句话说明当前使用的模型名称。如果请求成功返回说明 cc-switch 的路由是通的。为了进一步确认流量确实走了 TaoToken 通道可以在另一个终端里查看 cc-switch 的日志cc-switch status cc-switch logs --tail 20日志里应该能看到请求被转发到https://taotoken.net/api的记录。如果看到local proxy failed或者连接被拒绝检查 cc-switch 的 provider 配置里 Base URL 是否正确以及 Key 是否有效。4.3 权限生效确认验证命令自动执行在 Claude Code 里输入一个需要执行 Shell 命令的请求比如请在当前目录创建一个 test_permission.txt 文件内容写入 hello。如果权限全开生效Claude Code 会直接执行Write操作不会弹出确认提示。执行完后检查文件是否存在ls test_permission.txt cat test_permission.txt看到hello就说明权限配置生效了。如果仍然弹窗要求确认检查.claude/settings.json的路径是否正确以及defaultMode字段是否拼写为bypassPermissions。三个验证都通过后Claude Code 在离线环境里的基础运行链路就打通了。接下来可以把它接到具体的项目里用CLAUDE.md定义项目规则让它自动推进开发任务。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节列出实际配置过程中最容易撞到的几个报错每个都给出原因和修复动作。5.1 401 Unauthorized报错形态通常是请求返回401或者invalid api key。原因有两个一是 cc-switch 里配置的 Key 和 TaoToken 控制台创建的不一致二是 Key 已经过期或被撤销。修复方式是重新在控制台创建一个 Key然后更新 cc-switch 配置cc-switch add --name TaoToken \ --base-url https://taotoken.net/api \ --api-key NEW_KEY cc-switch enable TaoToken更新后重启 Claude Code 再试。如果仍然 401检查 Base URL 是否误写成了https://taotoken.net/api/v1多了一层/v1cc-switch 会自己补路径重复会导致 404 或 401。5.2 local proxy failed这个报错说明 cc-switch 尝试连接后端端点时失败了。如果是本地模型检查服务是否在监听curl http://localhost:8000/v1/models如果 curl 也失败说明本地模型服务没起来先启动服务。如果走 TaoToken 通道检查网络是否能到达https://taotoken.net/apicurl -I https://taotoken.net/api返回 200 或 401 都说明网络通返回超时则说明网络层有问题。5.3 reading choices 相关报错这个报错通常出现在响应解析阶段形态是error reading choices或unexpected response format。原因是后端返回的 JSON 结构不符合 OpenAI 兼容格式。cc-switch 期望的响应里有choices数组如果后端返回的是 Anthropic 原生格式或者其他自定义格式就会解析失败。修复方式是确认后端端点确实是 OpenAI 兼容的或者换一个兼容的端点。5.4 OAuth 相关报错如果启动时仍然提示 OAuth 登录或者oauthAccount相关错误说明.claude.json里残留了登录信息。修复方式是强制覆盖Remove-Item $env:USERPROFILE\.claude.json -Force {hasCompletedOnboarding: true} | Set-Content $env:USERPROFILE\.claude.json -Force同时检查%USERPROFILE%\.claude\settings.json里是否有oauthAccount字段有则删除。另外确认环境变量CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC已经生效$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC输出1才算设置成功。5.5 权限全开但子代理仍弹窗这是一个已知的行为差异Claude Code 的子代理通过Agent(*)创建不继承父会话的bypassPermissions设置。即使主会话已经全开子代理执行命令时仍可能弹窗。目前的规避方式是在主会话里直接完成任务避免使用/agent命令。如果必须用子代理需要在子代理的配置里单独声明权限。6. 把配置固化下来项目级 CLAUDE.md 与启动指令配置跑通之后最后一步是把它固化到项目里让每次启动都不用重复折腾。核心是两个文件项目根目录的CLAUDE.md和.claude/settings.json。前者定义项目规则和开发约束后者定义权限。CLAUDE.md的内容根据你的项目来写但有几个字段建议保留项目定位、技术栈、开发原则、实现顺序、关键参数、权限声明。权限声明里明确写出“你被授权读取/写入项目目录下所有文件、自动安装依赖、执行测试命令不需要询问用户确认”这样配合settings.json的bypassPermissions就能实现全自动执行。启动指令模板可以这样写请严格按照项目根目录 CLAUDE.md 执行。 当前阶段你的阶段。 要求 1. 全自动执行不询问确认 2. 每写一个模块必须配套测试 3. 更新 docs/project_status.md 记录进度 先扫描项目当前文件结构然后按任务清单开始实现。如果你需要长期跑编码任务或者 Agent 流程可以了解 Coding Plan 的接入方式https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteAPI Key 的管理入口在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite模型对话的调试入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite整套方案的核心逻辑是“伪造 onboarding 阻断外网 cc-switch 路由 权限全开”。四步配置完成后Claude Code 在隔离网络里就能稳定接受指令并自动执行。实测下来启动时间从原来的两分钟超时缩短到三秒内命令执行也不再弹窗。如果你在配置过程中遇到本文没覆盖的报错优先检查.claude.json的内容和 cc-switch 的 provider 状态这两个地方出问题的概率最高。