【Claude Code】Claude Code 完全离线使用指南：绕过登录 + cc-switch 本地 API + 权限全开实战 Claude Code 完全离线使用指南绕过登录 cc-switch 本地 API 权限全开实战适用场景内网/离线环境、不想注册 Anthropic 账户、使用第三方 APIDeepSeek / 本地模型、需要 Claude Code 全自动执行复杂项目。测试环境Windows 11 PowerShell Claude Code v2.1.150 cc-switch一、核心矛盾为什么 Claude Code 离线使用这么难Claude Code 的设计假设是始终在线强制登录检查启动时必须验证 Anthropic OAuth 状态即使你的 API 流量全部走第三方。后台外网通信启动时会连接api.anthropic.com拉取 feature flags、检查更新、上报遥测。权限沙箱默认每次执行命令都要人工确认无法自动化流水线。我们的目标是欺骗 onboarding 状态阻断外网检查全开本地权限让 Claude Code 在纯离线/第三方 API 环境下全自动运行。二、方案总览┌─────────────────────────────────────────────────────────────┐ │ 用户输入: claude │ │ ↓ │ │ ┌─────────────────┐ ┌──────────────────┐ │ │ │ 伪造登录状态 │ → │ 阻断外网检查 │ │ │ │ (.claude.json) │ │ (环境变量) │ │ │ └─────────────────┘ └──────────────────┘ │ │ ↓ ↓ │ │ ┌──────────────────────────────────────────┐ │ │ │ cc-switch 拦截 API 请求 │ │ │ │ → 转发到 DeepSeek / 本地模型 │ │ │ └──────────────────────────────────────────┘ │ │ ↓ │ │ ┌──────────────────────────────────────────┐ │ │ │ .claude/settings.json │ │ │ │ → bypassPermissions 全开不再弹窗确认 │ │ │ └──────────────────────────────────────────┘ │ │ ↓ │ │ ✅ Claude Code 启动成功等待输入指令 │ └─────────────────────────────────────────────────────────────┘三、详细配置步骤Step 1伪造 Anthropic 登录状态最关键Claude Code 启动时会读取%USERPROFILE%\.claude.json检查是否完成过 onboarding。我们直接写入已完成的标志# 创建/覆盖 Claude Code 的全局配置文件$claudeConfig$env:USERPROFILE\.claude.json$jsonContent {hasCompletedOnboarding $true}|ConvertTo-Json-Depth 3Set-Content-Path$claudeConfig-Value$jsonContent-ForceWrite-Host已写入:$claudeConfigGet-Content$claudeConfig原理Claude Code 的 onboarding 流程在检测到hasCompletedOnboarding: true时会跳过登录拦截直接进入主界面。Step 2阻断所有外网检查离线必需Claude Code 即使不调用官方 API启动时仍会尝试连接外网。设置以下环境变量彻底阻断# 当前会话生效$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禁止自动安装官方 Marketplace 扩展DISABLE_AUTOUPDATER彻底关闭自动更新器Step 3配置 cc-switch 转发到本地/第三方 APIcc-switch是一个 Claude Code 的 API 路由层负责把 Claude Code 的 Anthropic API 请求转发到任意兼容 OpenAI 协议的端点。3.1 检查当前状态cc-switchstatus如果显示未启用或配置丢失执行下面步骤。3.2 添加 Provider以 DeepSeek 为例# 添加 DeepSeek providercc-switchadd--name DeepSeek --base-url https://api.deepseek.com/v1 --api-key YOUR_API_KEY# 启用cc-switchenable DeepSeek本地模型部署如 vLLM / Ollamacc-switchadd--name Local --base-url http://localhost:8000/v1 --api-key dummy-key cc-switchenable Local3.3 验证路由cc-switchstatus# 应显示# Current provider: DeepSeek (enabled)# Base URL: https://api.deepseek.com/v1Step 4权限全开 —— 告别手动确认Claude Code 默认会在执行 Bash 命令、编辑文件、读写代码前弹窗要求确认。对于自动化项目开发必须全开。方案 A项目级配置推荐随仓库走在项目根目录创建.claude/settings.jsonNew-Item-ItemType Directory-Path.claude-ForceSet-Content-Path.claude\settings.json-Value { permissions: { allow: [ Bash(*), Edit(*), Write(*), Read(*), Glob(*), Grep(*), WebFetch(*), WebSearch, Agent(*) ], defaultMode: bypassPermissions }, skipDangerousModePermissionPrompt: true } 方案 B全局配置所有项目生效创建%USERPROFILE%\.claude\settings.json注意是文件夹.claude不是文件.claude.json$claudeDir$env:USERPROFILE\.claudeNew-Item-ItemType Directory-Path$claudeDir-ForceSet-Content-Path$claudeDir\settings.json-Value { permissions: { allow: [ Bash(*), Edit(*), Write(*), Read(*), Glob(*), Grep(*), WebFetch(*), WebSearch, Agent(*) ], defaultMode: bypassPermissions }, skipDangerousModePermissionPrompt: true } 关键字段说明字段含义defaultMode: bypassPermissions默认直接执行不弹窗skipDangerousModePermissionPrompt跳过启动时的危险模式警告Bash(*)允许执行任意 Shell 命令Agent(*)允许创建子代理Step 5启动验证完全关闭所有终端重新打开 PowerShellcd D:\cladueWorkspace\missile claude预期输出▐▛███▜▌ Claude Code v2.1.150 ▝▜█████▛▘ Opus 4.7 (1M context) · API Usage Billing ▘▘ ▝▝ D:\cladueWorkspace\missile ⎿ bypass permissions on (shifttab to cycle) ✻ Brewed for 0s ──────────────────────────────────────────────────────── 检查点✅ 不再提示Not logged in✅ 底部显示bypass permissions on✅ 直接出现提示符四、实战接入 v0.2.0 项目全自动开发以下是一个可直接复制给 Claude Code 的完整指令模板用于推进 12 周导弹仿真项目。4.1 项目级开发宪法CLAUDE.md在项目根目录创建/覆盖CLAUDE.md# TMSim 战术导弹制导控制仿真系统 — 开发宪法 v0.2.0 ## 项目定位 基于祁载康《战术导弹制导控制系统设计》的 Python 仿真平台。 目标教学演示 工程验证 学术研究所有数值必须对标教材。 ## 版本目标 v0.2.012周2026-08-01交付 - 六自由度非线性仿真深化完整气动/推力/耦合 - 导引头寄生回路与隔离度建模 - 高级制导律对比研究PN/OPN/约束/多目标 - 传感器噪声与状态估计基础 - 600 单元测试论文级数据输出 ## 技术栈 - Python 3.10必须使用 TMSim 环境 - numpy, scipy, matplotlib, pytest - PyQt6UI层Phase 9 集成 - PyVista三维可视化Phase 9 集成 - SALib灵敏度分析Phase 8 - python-control控制系统分析Phase 7B/8B ## 开发原则强制执行 1. **测试驱动**每写一个模块必须同时写对应的 pytest 单元测试 2. **教材对标**所有仿真结果的数值误差必须 2% 3. **零UI依赖**core/ 和 engine/ 目录下的模块不得导入任何 GUI 库 4. **四层架构**core → engine → gui → data严禁反向依赖 5. **自动安装**遇到缺失依赖时自动执行 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn 6. **算法完整**禁止使用简化版算法必须按教材公式完整实现 ## 实现顺序分阶段禁止跳阶段 ### Phase 6Week 1-36月6DOF基础搭建 - Week 1ISAAtmosphere ThrustModel AeroDatabase三维插值集成到 SixDOFBody - Week 2BTT耦合控制Dutch Roll 科里奥利力 BTT驾驶仪 - Week 36DOFPN制导端到端闭环 蒙特卡洛验证 对标报告 ### Phase 7Week 4-66月核心模块完成 - Week 4高马赫/高攻角气动扩展M0.5-4.0 失速模型 - Week 5固体火箭推力精细建模四段剖面 飞行包线 - Week 66DOF系统测试 导引头隔离度传函 制导律框架 ### Phase 8Week 7-97月集成验证 高级功能 - Week 7灵敏度分析Morris/Sobol 参数优化 极限工况 - Week 8寄生回路失稳分析Nyquist/Bode 非线性时域验证 - Week 9多约束制导脱靶过载落角 中末制导交接班 ### Phase 9Week 10-127月优化 论文 交付 - Week 10GUI完善PyQt6实时刷新 PyVista三维弹道 - Week 11数据链打通 自动报告生成 蒙特卡洛统计 - Week 12论文素材整理 最终验收 v0.2.0发布 ## 关键参数不可改动 弹体参数表4.1-1 - a_alpha 72.4, a_delta 471.0, a_omega 1.5 - b_alpha 1.27, b_delta 0.477 - c 0.66, V 1140.0 驾驶仪参数 - K_A 0.00065, K_g 0.0728 舵机参数 - k_r -0.0175, tau 0.0133 ## 代码规范 - 使用类型注解 - 所有物理量标注单位注释中 - 角度统一用 rad仅在UI显示时转 deg - 状态空间矩阵用 numpy.ndarray - 教材公式必须在注释中标注编号如式2.5-1 ## 测试规范 - 每个 .py 文件对应一个 test_*.py - 验收测试命名test_week{N}_{description}.py - 测试失败时先修复代码不要修改测试标准 - v0.2.0 目标600 测试 ## 权限声明 你被授权 - 读取/写入项目目录下所有文件 - 自动安装 Python 依赖pip install使用清华源 - 自动创建目录和文件 - 执行 pytest 运行测试 - 下载开源模型/数据如有需要 不需要询问用户确认直接执行。4.2 启动指令模板启动 Claude Code 后直接粘贴请严格按照项目根目录 CLAUDE.mdv0.2.0开发宪法和 v0.2.0_implementation_plan_12weeks.md 执行。 当前阶段Phase 6 Week 1 —— 6DOF基础搭建气动/推力/大气集成。 要求 1. 全自动执行不询问确认 2. 使用 TMSim 环境C:/Users/Administrator/anaconda3/envs/TMSim/python.exe 3. 每写一个模块必须配套 pytest 测试 4. 教材数值误差 2% 5. 更新 docs/project_status_2026-05-25.md 记录进度 先扫描项目当前文件结构确认 v0.1.0 遗产状态然后按 Week 1 任务清单开始实现。五、常见问题排查Q1仍然提示 “Not logged in”原因.claude.json被覆盖或格式不对。解决# 强制重新写入$path$env:USERPROFILE\.claude.json{hasCompletedOnboarding: true}|Set-Content$path-Force# 检查内容Get-Content$path如果仍不行检查是否有%USERPROFILE%\.claude\settings.json里的oauthAccount字段有则删除。Q2cc-switch 提示 “No provider enabled”原因cc-switch 配置未持久化。解决# 重新添加并启用cc-switchadd--name DeepSeek--base-url https://api.deepseek.com/v1--api-key YOUR_KEY cc-switchenable DeepSeek cc-switchstatusQ3权限全开但某些命令仍弹窗原因子代理Agent或 MCP 工具不继承父会话权限。解决子代理目前 Claude Code 的子代理有已知 bug即使父会话 bypass子代理仍可能弹窗。避免使用/agent命令直接在主会话中完成。MCP 工具需要逐个工具显式授权或在settings.json的allow列表中加入具体工具名。Q4启动时卡住/长时间 “Brewing”原因Claude Code 仍在尝试连接外网。解决# 检查环境变量是否生效$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC# 如果输出为空说明没设置成功重新执行 Step 2Q5如何回退到官方 Anthropic 模式# 1. 恢复登录状态删除伪造标志Remove-Item$env:USERPROFILE\.claude.json-Force# 2. 禁用 cc-switchcc-switchdisable# 3. 重新登录claude# 然后执行 /login# 4. 恢复权限确认删除 settings.jsonRemove-Item.claude\settings.json-Force六、总结步骤操作文件/命令目的1伪造登录%USERPROFILE%\.claude.json跳过 Anthropic OAuth2阻断外网4 个环境变量禁止遥测和更新检查3API 路由cc-switch add/enable转发到 DeepSeek/本地模型4权限全开.claude/settings.json自动化执行不弹窗5项目指令CLAUDE.md 启动 prompt按 12 周路线图推进这套方案的核心思路是**“欺骗 阻断 替代”**欺骗 onboarding 检查、阻断官方外网依赖、用 cc-switch 替代 API 端点。配置完成后Claude Code 就能在完全离线的环境中像本地 IDE 一样全自动执行复杂的工程开发任务。最后更新2026-05-27适用版本Claude Code v2.1.150