【Claude Code】Claude Code 完全离线使用指南：绕过登录 + cc-switch 本地 API + 权限全开实战
Claude Code 完全离线使用指南：绕过登录 + cc-switch 本地 API + 权限全开实战
适用场景：内网/离线环境、不想注册 Anthropic 账户、使用第三方 API（DeepSeek / 本地模型）、需要 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"已写入:$claudeConfig"Get-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 转发到本地/第三方 API
cc-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 / Ollama）：
cc-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.json：
New-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\.claude"New-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：启动验证
完全关闭所有终端，重新打开 PowerShell：
cd D:\cladueWorkspace\missile claude预期输出：
▐▛███▜▌ Claude Code v2.1.150 ▝▜█████▛▘ Opus 4.7 (1M context) · API Usage Billing ▘▘ ▝▝ D:\cladueWorkspace\missile > ⎿ bypass permissions on (shift+tab 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.0（12周，2026-08-01交付）： - 六自由度非线性仿真深化（完整气动/推力/耦合） - 导引头寄生回路与隔离度建模 - 高级制导律对比研究（PN/OPN/约束/多目标） - 传感器噪声与状态估计（基础） - 600+ 单元测试，论文级数据输出 ## 技术栈 - Python 3.10+（必须使用 TMSim 环境） - numpy, scipy, matplotlib, pytest - PyQt6（UI层，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 6（Week 1-3，6月）：6DOF基础搭建 - Week 1：ISAAtmosphere + ThrustModel + AeroDatabase（三维插值）集成到 SixDOFBody - Week 2：BTT耦合控制（Dutch Roll）+ 科里奥利力 + BTT驾驶仪 - Week 3：6DOF+PN制导端到端闭环 + 蒙特卡洛验证 + 对标报告 ### Phase 7（Week 4-6，6月）：核心模块完成 - Week 4：高马赫/高攻角气动扩展（M=0.5-4.0）+ 失速模型 - Week 5：固体火箭推力精细建模（四段剖面）+ 飞行包线 - Week 6：6DOF系统测试 + 导引头隔离度传函 + 制导律框架 ### Phase 8（Week 7-9，7月）：集成验证 + 高级功能 - Week 7：灵敏度分析（Morris/Sobol）+ 参数优化 + 极限工况 - Week 8：寄生回路失稳分析（Nyquist/Bode）+ 非线性时域验证 - Week 9：多约束制导（脱靶+过载+落角）+ 中末制导交接班 ### Phase 9（Week 10-12，7月）：优化 + 论文 + 交付 - Week 10：GUI完善（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.md（v0.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字段，有则删除。
Q2：cc-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.json）Remove-Item".claude\settings.json"-Force六、总结
| 步骤 | 操作 | 文件/命令 | 目的 |
|---|---|---|---|
| 1 | 伪造登录 | %USERPROFILE%\.claude.json | 跳过 Anthropic OAuth |
| 2 | 阻断外网 | 4 个环境变量 | 禁止遥测和更新检查 |
| 3 | API 路由 | 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