[{"data":1,"prerenderedAt":4057},["ShallowReactive",2],{"navigation":3,"\u002Fsetup\u002Fsystem-requirements":189,"\u002Fsetup\u002Fsystem-requirements-surround":4053},[4,35,57,75,101,123,149,171],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":34},"第 1 章：认识 Claude Code","i-lucide-rocket","\u002Fintro","1.intro",[10,14,18,22,26,30],{"title":11,"path":12,"stem":13},"什么是 Claude Code","\u002Fintro\u002Fwhat-is-claude-code","1.intro\u002F1.what-is-claude-code",{"title":15,"path":16,"stem":17},"Claude Code 与 Copilot、Cursor、Windsurf 的本质区别","\u002Fintro\u002Fvs-competitors","1.intro\u002F2.vs-competitors",{"title":19,"path":20,"stem":21},"AI 编程助手生态全景与选型指南","\u002Fintro\u002Fecosystem-guide","1.intro\u002F3.ecosystem-guide",{"title":23,"path":24,"stem":25},"LLM 的概率本质","\u002Fintro\u002Fllm-probability","1.intro\u002F4.llm-probability",{"title":27,"path":28,"stem":29},"从聊天机器人到 Agent","\u002Fintro\u002Ffrom-chatbot-to-agent","1.intro\u002F5.from-chatbot-to-agent",{"title":31,"path":32,"stem":33},"Claude Code 的 Agentic Loop 全拆解","\u002Fintro\u002Fagentic-loop","1.intro\u002F6.agentic-loop",false,{"title":36,"icon":37,"path":38,"stem":39,"children":40,"page":34},"第 2 章：安装与配置","i-lucide-settings","\u002Fsetup","2.setup",[41,45,49,53],{"title":42,"path":43,"stem":44},"系统要求与安装方式","\u002Fsetup\u002Fsystem-requirements","2.setup\u002F1.system-requirements",{"title":46,"path":47,"stem":48},"认证、登录与多账户管理","\u002Fsetup\u002Fauthentication","2.setup\u002F2.authentication",{"title":50,"path":51,"stem":52},"选择你的界面","\u002Fsetup\u002Fchoose-interface","2.setup\u002F3.choose-interface",{"title":54,"path":55,"stem":56},"Coding Plan","\u002Fsetup\u002Fcoding-plan","2.setup\u002F4.coding-plan",{"title":58,"icon":59,"path":60,"stem":61,"children":62,"page":34},"第 3 章：快速上手","i-lucide-hand","\u002Fquickstart","3.quickstart",[63,67,71],{"title":64,"path":65,"stem":66},"启动、交互模式与基本命令","\u002Fquickstart\u002Fstartup","3.quickstart\u002F1.startup",{"title":68,"path":69,"stem":70},"让 Claude 理解你的项目","\u002Fquickstart\u002Fcodebase-understanding","3.quickstart\u002F2.codebase-understanding",{"title":72,"path":73,"stem":74},"第一次代码变更","\u002Fquickstart\u002Ffirst-change","3.quickstart\u002F3.first-change",{"title":76,"icon":77,"path":78,"stem":79,"children":80,"page":34},"第 4 章：核心功能","i-lucide-laptop","\u002Fcore-features","4.core-features",[81,85,89,93,97],{"title":82,"path":83,"stem":84},"代码库全景扫描与模块关系分析","\u002Fcore-features\u002Fcodebase-scan","4.core-features\u002F1.codebase-scan",{"title":86,"path":87,"stem":88},"代码编辑与生成","\u002Fcore-features\u002Fedit-generate","4.core-features\u002F2.edit-generate",{"title":90,"path":91,"stem":92},"测试与调试","\u002Fcore-features\u002Ftest-debug","4.core-features\u002F3.test-debug",{"title":94,"path":95,"stem":96},"Git 工作流","\u002Fcore-features\u002Fgit-workflow","4.core-features\u002F4.git-workflow",{"title":98,"path":99,"stem":100},"工具链执行","\u002Fcore-features\u002Ftoolchain","4.core-features\u002F5.toolchain",{"title":102,"icon":103,"path":104,"stem":105,"children":106,"page":34},"第 5 章：进阶配置","i-lucide-wrench","\u002Fadvanced","5.advanced",[107,111,115,119],{"title":108,"path":109,"stem":110},"CLAUDE.md","\u002Fadvanced\u002Fclaude-md","5.advanced\u002F1.claude-md",{"title":112,"path":113,"stem":114},"Skills","\u002Fadvanced\u002Fskills","5.advanced\u002F2.skills",{"title":116,"path":117,"stem":118},"MCP","\u002Fadvanced\u002Fmcp","5.advanced\u002F3.mcp",{"title":120,"path":121,"stem":122},"Hooks 与 Plan 模式","\u002Fadvanced\u002Fhooks-plan","5.advanced\u002F4.hooks-plan",{"title":124,"icon":125,"path":126,"stem":127,"children":128,"page":34},"第 6 章：实战开发","i-lucide-hammer","\u002Fpractice","6.practice",[129,133,137,141,145],{"title":130,"path":131,"stem":132},"需求分析与架构设计","\u002Fpractice\u002Frequirements-architecture","6.practice\u002F1.requirements-architecture",{"title":134,"path":135,"stem":136},"项目脚手架搭建与技术选型","\u002Fpractice\u002Fscaffolding","6.practice\u002F2.scaffolding",{"title":138,"path":139,"stem":140},"核心功能实现","\u002Fpractice\u002Fcore-features","6.practice\u002F3.core-features",{"title":142,"path":143,"stem":144},"测试覆盖、代码审查与质量调优","\u002Fpractice\u002Ftesting-quality","6.practice\u002F4.testing-quality",{"title":146,"path":147,"stem":148},"部署上线与成果分享","\u002Fpractice\u002Fdeployment","6.practice\u002F5.deployment",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":34},"第 7 章：心法层","i-lucide-brain","\u002Fmindset","7.mindset",[155,159,163,167],{"title":156,"path":157,"stem":158},"提示词设计原则","\u002Fmindset\u002Fprompt-design","7.mindset\u002F1.prompt-design",{"title":160,"path":161,"stem":162},"上下文管理策略","\u002Fmindset\u002Fcontext-management","7.mindset\u002F2.context-management",{"title":164,"path":165,"stem":166},"安全与权限控制","\u002Fmindset\u002Fsecurity","7.mindset\u002F3.security",{"title":168,"path":169,"stem":170},"Boris Cherny 的 9 条实战心法与团队推广经验","\u002Fmindset\u002Fboris-cherny-tips","7.mindset\u002F4.boris-cherny-tips",{"title":172,"icon":173,"path":174,"stem":175,"children":176,"page":34},"附录","i-lucide-paperclip","\u002Fappendix","8.appendix",[177,181,185],{"title":178,"path":179,"stem":180},"常用命令速查表","\u002Fappendix\u002Fa.command-cheatsheet","8.appendix\u002Fa.command-cheatsheet",{"title":182,"path":183,"stem":184},"AI 核心术语汇编","\u002Fappendix\u002Fb.ai-terminology","8.appendix\u002Fb.ai-terminology",{"title":186,"path":187,"stem":188},"资源链接与延伸阅读","\u002Fappendix\u002Fc.resources","8.appendix\u002Fc.resources",{"id":190,"title":42,"body":191,"description":4046,"extension":4047,"links":4048,"meta":4049,"navigation":567,"path":43,"seo":4051,"stem":44,"__hash__":4052},"docs\u002F2.setup\u002F1.system-requirements.md",{"type":192,"value":193,"toc":4003},"minimark",[194,198,201,206,211,296,300,329,333,370,374,381,453,459,461,465,469,472,511,514,533,544,583,587,590,634,644,658,662,665,683,686,690,698,803,808,852,857,956,963,965,969,980,1040,1044,1049,1077,1082,1099,1105,1125,1130,1159,1165,1170,1181,1200,1204,1210,1288,1292,1295,1348,1354,1373,1377,1382,1389,1468,1473,1476,1491,1496,1499,1514,1516,1520,1524,1546,1549,1553,1560,1565,1716,1721,1814,1819,1822,1995,1999,2017,2024,2052,2054,2058,2062,2073,2078,2149,2154,2196,2201,2223,2227,2234,2239,2242,2248,2316,2321,2328,2363,2368,2433,2437,2478,2480,2484,2488,2552,2558,2578,2582,2614,2621,2626,2651,2653,2657,2661,2664,2669,2691,2697,2728,2741,2746,2793,2808,2812,2856,2861,2910,2921,2925,2930,3011,3016,3055,3060,3069,3074,3176,3180,3195,3199,3202,3335,3343,3345,3349,3481,3483,3487,3492,3495,3500,3503,3511,3518,3523,3532,3599,3602,3607,3614,3619,3644,3652,3657,3660,3665,3668,3673,3684,3689,3696,3811,3814,3859,3861,3865,3999],[195,196,197],"p",{},"Claude Code 是 Anthropic 推出的终端原生 AI 编程助手，其安装过程在 2026 年已经大幅简化。本章将系统梳理各平台的安装方法、系统要求、常见问题排查，以及国内用户的特殊注意事项，帮助你从零开始完成环境搭建。",[199,200],"hr",{},[202,203,205],"h2",{"id":204},"一系统要求总览","一、系统要求总览",[207,208,210],"h3",{"id":209},"_11-操作系统兼容性","1.1 操作系统兼容性",[212,213,214,230],"table",{},[215,216,217],"thead",{},[218,219,220,224,227],"tr",{},[221,222,223],"th",{},"平台",[221,225,226],{},"最低版本要求",[221,228,229],{},"架构支持",[231,232,233,245,256,266,276,286],"tbody",{},[218,234,235,239,242],{},[236,237,238],"td",{},"macOS",[236,240,241],{},"13.0 (Ventura) 及以上",[236,243,244],{},"Intel x64 \u002F Apple Silicon ARM64",[218,246,247,250,253],{},[236,248,249],{},"Windows",[236,251,252],{},"Windows 10 1809 或 Windows Server 2019 及以上",[236,254,255],{},"x64 \u002F ARM64",[218,257,258,261,264],{},[236,259,260],{},"Ubuntu",[236,262,263],{},"20.04 及以上",[236,265,255],{},[218,267,268,271,274],{},[236,269,270],{},"Debian",[236,272,273],{},"10 及以上",[236,275,255],{},[218,277,278,281,284],{},[236,279,280],{},"Alpine Linux",[236,282,283],{},"3.19 及以上",[236,285,255],{},[218,287,288,291,294],{},[236,289,290],{},"Fedora \u002F RHEL",[236,292,293],{},"36 及以上（社区验证）",[236,295,255],{},[207,297,299],{"id":298},"_12-硬件要求","1.2 硬件要求",[301,302,303,311,317,323],"ul",{},[304,305,306,310],"li",{},[307,308,309],"strong",{},"内存","：最低 4 GB RAM，推荐 8 GB 及以上",[304,312,313,316],{},[307,314,315],{},"处理器","：x64 或 ARM64 架构",[304,318,319,322],{},[307,320,321],{},"磁盘空间","：安装包小于 100 MB，预留 500 MB 空间足够",[304,324,325,328],{},[307,326,327],{},"网络","：稳定的互联网连接（用于下载和 API 通信）",[207,330,332],{"id":331},"_13-前置依赖","1.3 前置依赖",[301,334,335,341,364],{},[304,336,337,340],{},[307,338,339],{},"Shell 环境","：Bash、Zsh、PowerShell 或 CMD 均可",[304,342,343,346,347],{},[307,344,345],{},"Git","：\n",[301,348,349,357],{},[304,350,351,352,356],{},"macOS \u002F Linux：通常已预装，可通过 ",[353,354,355],"code",{},"git --version"," 验证",[304,358,359,360,363],{},"Windows 原生安装：",[307,361,362],{},"必须","先安装 Git for Windows，否则安装会失败或运行异常",[304,365,366,369],{},[307,367,368],{},"ripgrep","：通常随 Claude Code 内置。若搜索功能异常，需手动安装",[207,371,373],{"id":372},"_14-账户要求","1.4 账户要求",[195,375,376,377,380],{},"Claude Code ",[307,378,379],{},"不支持免费版 Claude.ai 账户","，需要以下任一付费账户：",[212,382,383,396],{},[215,384,385],{},[218,386,387,390,393],{},[221,388,389],{},"账户类型",[221,391,392],{},"月费",[221,394,395],{},"适用场景",[231,397,398,409,420,431,442],{},[218,399,400,403,406],{},[236,401,402],{},"Claude Pro",[236,404,405],{},"$20\u002F月（年付 $17\u002F月）",[236,407,408],{},"个人开发者入门",[218,410,411,414,417],{},[236,412,413],{},"Claude Max 5x",[236,415,416],{},"$100\u002F月",[236,418,419],{},"高频使用者",[218,421,422,425,428],{},[236,423,424],{},"Claude Max 20x",[236,426,427],{},"$200\u002F月",[236,429,430],{},"团队核心开发者",[218,432,433,436,439],{},[236,434,435],{},"Teams Standard",[236,437,438],{},"$25\u002F人\u002F月",[236,440,441],{},"小型团队",[218,443,444,447,450],{},[236,445,446],{},"Anthropic Console",[236,448,449],{},"按量付费",[236,451,452],{},"CI\u002FCD 或低频使用",[454,455,456],"blockquote",{},[195,457,458],{},"国内用户可通过 API 中转站或国产模型替代方案绕过订阅限制，详见后文「国内访问注意事项」章节。",[199,460],{},[202,462,464],{"id":463},"二macos-安装","二、macOS 安装",[207,466,468],{"id":467},"_21-方式一curl-一键安装推荐","2.1 方式一：curl 一键安装（推荐）",[195,470,471],{},"这是官方推荐的方式，零依赖、自动更新、启动最快。",[473,474,479],"pre",{"className":475,"code":476,"language":477,"meta":478,"style":478},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# 打开终端（Terminal.app 或 iTerm2），执行：\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n","bash","",[353,480,481,490],{"__ignoreMap":478},[482,483,486],"span",{"class":484,"line":485},"line",1,[482,487,489],{"class":488},"sHwdD","# 打开终端（Terminal.app 或 iTerm2），执行：\n",[482,491,493,497,501,504,508],{"class":484,"line":492},2,[482,494,496],{"class":495},"sBMFI","curl",[482,498,500],{"class":499},"sfazB"," -fsSL",[482,502,503],{"class":499}," https:\u002F\u002Fclaude.ai\u002Finstall.sh",[482,505,507],{"class":506},"sMK4o"," |",[482,509,510],{"class":495}," bash\n",[195,512,513],{},"安装过程约 30 秒，脚本会自动：",[515,516,517,520,523,530],"ol",{},[304,518,519],{},"检测你的系统架构（Intel 或 Apple Silicon）",[304,521,522],{},"下载对应平台的原生二进制文件",[304,524,525,526,529],{},"放置到 ",[353,527,528],{},"~\u002F.local\u002Fbin\u002F"," 目录",[304,531,532],{},"更新 Shell 的 PATH 环境变量",[195,534,535,536,539,540,543],{},"安装完成后，",[307,537,538],{},"新开一个终端窗口","（或执行 ",[353,541,542],{},"source ~\u002F.zshrc","）使 PATH 生效。",[473,545,547],{"className":475,"code":546,"language":477,"meta":478,"style":478},"# 验证安装\nclaude --version\n\n# 详细诊断\nclaude doctor\n",[353,548,549,554,562,569,575],{"__ignoreMap":478},[482,550,551],{"class":484,"line":485},[482,552,553],{"class":488},"# 验证安装\n",[482,555,556,559],{"class":484,"line":492},[482,557,558],{"class":495},"claude",[482,560,561],{"class":499}," --version\n",[482,563,565],{"class":484,"line":564},3,[482,566,568],{"emptyLinePlaceholder":567},true,"\n",[482,570,572],{"class":484,"line":571},4,[482,573,574],{"class":488},"# 详细诊断\n",[482,576,578,580],{"class":484,"line":577},5,[482,579,558],{"class":495},[482,581,582],{"class":499}," doctor\n",[207,584,586],{"id":585},"_22-方式二homebrew-安装","2.2 方式二：Homebrew 安装",[195,588,589],{},"适合已使用 Homebrew 管理工具链的开发者。",[473,591,593],{"className":475,"code":592,"language":477,"meta":478,"style":478},"# 安装稳定版（约滞后最新版一周，跳过有严重回归的版本）\nbrew install --cask claude-code\n\n# 或安装最新版（跟随最新发布通道）\nbrew install --cask claude-code@latest\n",[353,594,595,600,614,618,623],{"__ignoreMap":478},[482,596,597],{"class":484,"line":485},[482,598,599],{"class":488},"# 安装稳定版（约滞后最新版一周，跳过有严重回归的版本）\n",[482,601,602,605,608,611],{"class":484,"line":492},[482,603,604],{"class":495},"brew",[482,606,607],{"class":499}," install",[482,609,610],{"class":499}," --cask",[482,612,613],{"class":499}," claude-code\n",[482,615,616],{"class":484,"line":564},[482,617,568],{"emptyLinePlaceholder":567},[482,619,620],{"class":484,"line":571},[482,621,622],{"class":488},"# 或安装最新版（跟随最新发布通道）\n",[482,624,625,627,629,631],{"class":484,"line":577},[482,626,604],{"class":495},[482,628,607],{"class":499},[482,630,610],{"class":499},[482,632,633],{"class":499}," claude-code@latest\n",[195,635,636,639,640,643],{},[307,637,638],{},"注意","：Homebrew 安装的版本",[307,641,642],{},"不会自动更新","，需要手动执行：",[473,645,647],{"className":475,"code":646,"language":477,"meta":478,"style":478},"brew upgrade claude-code\n",[353,648,649],{"__ignoreMap":478},[482,650,651,653,656],{"class":484,"line":485},[482,652,604],{"class":495},[482,654,655],{"class":499}," upgrade",[482,657,613],{"class":499},[207,659,661],{"id":660},"_23-方式三npm-安装遗留方式","2.3 方式三：npm 安装（遗留方式）",[195,663,664],{},"npm 安装方式已官方弃用，仅建议在需要锁定特定版本时使用。",[473,666,668],{"className":475,"code":667,"language":477,"meta":478,"style":478},"npm install -g @anthropic-ai\u002Fclaude-code\n",[353,669,670],{"__ignoreMap":478},[482,671,672,675,677,680],{"class":484,"line":485},[482,673,674],{"class":495},"npm",[482,676,607],{"class":499},[482,678,679],{"class":499}," -g",[482,681,682],{"class":499}," @anthropic-ai\u002Fclaude-code\n",[195,684,685],{},"要求 Node.js 18.0 或更高版本。npm 包实际安装的是与原生安装器相同的二进制文件，但启动时需要初始化 Node.js 运行时，比原生安装慢 500-1500 毫秒。",[207,687,689],{"id":688},"_24-macos-常见问题","2.4 macOS 常见问题",[195,691,692],{},[307,693,694,695],{},"问题 1：",[353,696,697],{},"command not found: claude",[473,699,701],{"className":475,"code":700,"language":477,"meta":478,"style":478},"# 方案 A：新开终端窗口使 PATH 生效\n# 方案 B：手动加载 Shell 配置\nsource ~\u002F.zshrc        # macOS 默认使用 Zsh\nsource ~\u002F.bashrc       # 如使用 Bash\n\n# 方案 C：检查 PATH 是否包含 ~\u002F.local\u002Fbin\necho $PATH | grep \".local\u002Fbin\"\n# 如缺失，手动添加：\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.zshrc\nsource ~\u002F.zshrc\n",[353,702,703,708,713,725,735,739,745,770,776,796],{"__ignoreMap":478},[482,704,705],{"class":484,"line":485},[482,706,707],{"class":488},"# 方案 A：新开终端窗口使 PATH 生效\n",[482,709,710],{"class":484,"line":492},[482,711,712],{"class":488},"# 方案 B：手动加载 Shell 配置\n",[482,714,715,719,722],{"class":484,"line":564},[482,716,718],{"class":717},"s2Zo4","source",[482,720,721],{"class":499}," ~\u002F.zshrc",[482,723,724],{"class":488},"        # macOS 默认使用 Zsh\n",[482,726,727,729,732],{"class":484,"line":571},[482,728,718],{"class":717},[482,730,731],{"class":499}," ~\u002F.bashrc",[482,733,734],{"class":488},"       # 如使用 Bash\n",[482,736,737],{"class":484,"line":577},[482,738,568],{"emptyLinePlaceholder":567},[482,740,742],{"class":484,"line":741},6,[482,743,744],{"class":488},"# 方案 C：检查 PATH 是否包含 ~\u002F.local\u002Fbin\n",[482,746,748,751,755,758,761,764,767],{"class":484,"line":747},7,[482,749,750],{"class":717},"echo",[482,752,754],{"class":753},"sTEyZ"," $PATH ",[482,756,757],{"class":506},"|",[482,759,760],{"class":495}," grep",[482,762,763],{"class":506}," \"",[482,765,766],{"class":499},".local\u002Fbin",[482,768,769],{"class":506},"\"\n",[482,771,773],{"class":484,"line":772},8,[482,774,775],{"class":488},"# 如缺失，手动添加：\n",[482,777,779,781,784,787,790,793],{"class":484,"line":778},9,[482,780,750],{"class":717},[482,782,783],{"class":506}," '",[482,785,786],{"class":499},"export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"",[482,788,789],{"class":506},"'",[482,791,792],{"class":506}," >>",[482,794,795],{"class":499}," ~\u002F.zshrc\n",[482,797,799,801],{"class":484,"line":798},10,[482,800,718],{"class":717},[482,802,795],{"class":499},[195,804,805],{},[307,806,807],{},"问题 2：安装脚本安全顾虑",[473,809,811],{"className":475,"code":810,"language":477,"meta":478,"style":478},"# 先下载脚本，审阅后再执行\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh -o install-claude.sh\nless install-claude.sh    # 审阅脚本内容\nbash install-claude.sh    # 确认无误后执行\n",[353,812,813,818,832,843],{"__ignoreMap":478},[482,814,815],{"class":484,"line":485},[482,816,817],{"class":488},"# 先下载脚本，审阅后再执行\n",[482,819,820,822,824,826,829],{"class":484,"line":492},[482,821,496],{"class":495},[482,823,500],{"class":499},[482,825,503],{"class":499},[482,827,828],{"class":499}," -o",[482,830,831],{"class":499}," install-claude.sh\n",[482,833,834,837,840],{"class":484,"line":564},[482,835,836],{"class":495},"less",[482,838,839],{"class":499}," install-claude.sh",[482,841,842],{"class":488},"    # 审阅脚本内容\n",[482,844,845,847,849],{"class":484,"line":571},[482,846,477],{"class":495},[482,848,839],{"class":499},[482,850,851],{"class":488},"    # 确认无误后执行\n",[195,853,854],{},[307,855,856],{},"问题 3：从 npm 迁移到原生安装",[473,858,860],{"className":475,"code":859,"language":477,"meta":478,"style":478},"# 1. 确认当前是 npm 安装\nwhich claude    # 如路径包含 node_modules，则为 npm 安装\n\n# 2. 卸载 npm 版本\nnpm uninstall -g @anthropic-ai\u002Fclaude-code\n\n# 3. 确认已卸载\nwhich claude    # 应返回 \"not found\"\n\n# 4. 安装原生版本\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n\n# 5. 验证\nclaude --version\n",[353,861,862,867,878,882,887,898,902,907,916,920,925,938,943,949],{"__ignoreMap":478},[482,863,864],{"class":484,"line":485},[482,865,866],{"class":488},"# 1. 确认当前是 npm 安装\n",[482,868,869,872,875],{"class":484,"line":492},[482,870,871],{"class":717},"which",[482,873,874],{"class":499}," claude",[482,876,877],{"class":488},"    # 如路径包含 node_modules，则为 npm 安装\n",[482,879,880],{"class":484,"line":564},[482,881,568],{"emptyLinePlaceholder":567},[482,883,884],{"class":484,"line":571},[482,885,886],{"class":488},"# 2. 卸载 npm 版本\n",[482,888,889,891,894,896],{"class":484,"line":577},[482,890,674],{"class":495},[482,892,893],{"class":499}," uninstall",[482,895,679],{"class":499},[482,897,682],{"class":499},[482,899,900],{"class":484,"line":741},[482,901,568],{"emptyLinePlaceholder":567},[482,903,904],{"class":484,"line":747},[482,905,906],{"class":488},"# 3. 确认已卸载\n",[482,908,909,911,913],{"class":484,"line":772},[482,910,871],{"class":717},[482,912,874],{"class":499},[482,914,915],{"class":488},"    # 应返回 \"not found\"\n",[482,917,918],{"class":484,"line":778},[482,919,568],{"emptyLinePlaceholder":567},[482,921,922],{"class":484,"line":798},[482,923,924],{"class":488},"# 4. 安装原生版本\n",[482,926,928,930,932,934,936],{"class":484,"line":927},11,[482,929,496],{"class":495},[482,931,500],{"class":499},[482,933,503],{"class":499},[482,935,507],{"class":506},[482,937,510],{"class":495},[482,939,941],{"class":484,"line":940},12,[482,942,568],{"emptyLinePlaceholder":567},[482,944,946],{"class":484,"line":945},13,[482,947,948],{"class":488},"# 5. 验证\n",[482,950,952,954],{"class":484,"line":951},14,[482,953,558],{"class":495},[482,955,561],{"class":499},[195,957,958,959,962],{},"配置和认证信息存储在 ",[353,960,961],{},"~\u002F.claude\u002F"," 目录，迁移过程中会被保留，无需重新登录。",[199,964],{},[202,966,968],{"id":967},"三windows-安装","三、Windows 安装",[195,970,971,972,975,976,979],{},"Windows 用户需要首先做一个关键决策：",[307,973,974],{},"原生 Windows 安装","还是 ",[307,977,978],{},"WSL 安装","？",[212,981,982,997],{},[215,983,984],{},[218,985,986,989,992,995],{},[221,987,988],{},"方案",[221,990,991],{},"前置要求",[221,993,994],{},"沙箱支持",[221,996,395],{},[231,998,999,1013,1027],{},[218,1000,1001,1004,1007,1010],{},[236,1002,1003],{},"原生 Windows",[236,1005,1006],{},"Git for Windows",[236,1008,1009],{},"不支持",[236,1011,1012],{},"Windows 原生项目、.NET、PowerShell 脚本",[218,1014,1015,1018,1021,1024],{},[236,1016,1017],{},"WSL 2",[236,1019,1020],{},"WSL 2 已启用",[236,1022,1023],{},"支持",[236,1025,1026],{},"Linux 工具链、Docker、需要隔离命令执行",[218,1028,1029,1032,1035,1037],{},[236,1030,1031],{},"WSL 1",[236,1033,1034],{},"WSL 1 已启用",[236,1036,1009],{},[236,1038,1039],{},"WSL 2 不可用时降级使用",[207,1041,1043],{"id":1042},"_31-原生-windows-安装推荐大多数用户","3.1 原生 Windows 安装（推荐大多数用户）",[195,1045,1046],{},[307,1047,1048],{},"前置条件：安装 Git for Windows",[515,1050,1051,1062,1069,1072],{},[304,1052,1053,1054,1061],{},"访问 ",[1055,1056,1060],"a",{"href":1057,"rel":1058},"https:\u002F\u002Fgit-scm.com",[1059],"nofollow","git-scm.com"," 下载安装包",[304,1063,1064,1065,1068],{},"运行安装程序，",[307,1066,1067],{},"保持默认选项","（确保 \"Add Git to PATH\" 已勾选）",[304,1070,1071],{},"安装完成后重启终端",[304,1073,1074,1075],{},"验证：",[353,1076,355],{},[195,1078,1079],{},[307,1080,1081],{},"方式 A：PowerShell 一键安装（推荐）",[473,1083,1087],{"className":1084,"code":1085,"language":1086,"meta":478,"style":478},"language-powershell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# 在 PowerShell 中执行（非 CMD）\nirm https:\u002F\u002Fclaude.ai\u002Finstall.ps1 | iex\n","powershell",[353,1088,1089,1094],{"__ignoreMap":478},[482,1090,1091],{"class":484,"line":485},[482,1092,1093],{},"# 在 PowerShell 中执行（非 CMD）\n",[482,1095,1096],{"class":484,"line":492},[482,1097,1098],{},"irm https:\u002F\u002Fclaude.ai\u002Finstall.ps1 | iex\n",[195,1100,535,1101,1104],{},[307,1102,1103],{},"完全关闭 PowerShell 再重新打开","，使 PATH 更新生效。",[473,1106,1108],{"className":1084,"code":1107,"language":1086,"meta":478,"style":478},"# 验证\nclaude --version\nclaude doctor\n",[353,1109,1110,1115,1120],{"__ignoreMap":478},[482,1111,1112],{"class":484,"line":485},[482,1113,1114],{},"# 验证\n",[482,1116,1117],{"class":484,"line":492},[482,1118,1119],{},"claude --version\n",[482,1121,1122],{"class":484,"line":564},[482,1123,1124],{},"claude doctor\n",[195,1126,1127],{},[307,1128,1129],{},"方式 B：WinGet 安装",[473,1131,1133],{"className":1084,"code":1132,"language":1086,"meta":478,"style":478},"# WinGet 内置于 Windows 11 和 Windows 10 22H2+\nwinget install Anthropic.ClaudeCode\n\n# 手动更新\nwinget upgrade Anthropic.ClaudeCode\n",[353,1134,1135,1140,1145,1149,1154],{"__ignoreMap":478},[482,1136,1137],{"class":484,"line":485},[482,1138,1139],{},"# WinGet 内置于 Windows 11 和 Windows 10 22H2+\n",[482,1141,1142],{"class":484,"line":492},[482,1143,1144],{},"winget install Anthropic.ClaudeCode\n",[482,1146,1147],{"class":484,"line":564},[482,1148,568],{"emptyLinePlaceholder":567},[482,1150,1151],{"class":484,"line":571},[482,1152,1153],{},"# 手动更新\n",[482,1155,1156],{"class":484,"line":577},[482,1157,1158],{},"winget upgrade Anthropic.ClaudeCode\n",[195,1160,1161,1162,1164],{},"WinGet 安装的版本",[307,1163,642],{},"。",[195,1166,1167],{},[307,1168,1169],{},"方式 C：CMD 安装（PowerShell 受限时使用）",[473,1171,1175],{"className":1172,"code":1173,"language":1174,"meta":478,"style":478},"language-cmd shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.cmd -o install.cmd && install.cmd && del install.cmd\n","cmd",[353,1176,1177],{"__ignoreMap":478},[482,1178,1179],{"class":484,"line":485},[482,1180,1173],{},[454,1182,1183,1186],{},[195,1184,1185],{},"常见错误提示：",[301,1187,1188,1194],{},[304,1189,1190,1193],{},[353,1191,1192],{},"The token '&&' is not a valid statement separator"," → 你当前在 PowerShell 中，应使用 PowerShell 安装命令",[304,1195,1196,1199],{},[353,1197,1198],{},"'irm' is not recognized as an internal or external command"," → 你当前在 CMD 中，应使用 CMD 安装命令",[207,1201,1203],{"id":1202},"_32-path-问题排查windows-最常见问题","3.2 PATH 问题排查（Windows 最常见问题）",[195,1205,1206,1207,1209],{},"安装成功后如果提示 ",[353,1208,558],{}," 不是可识别命令：",[473,1211,1213],{"className":1084,"code":1212,"language":1086,"meta":478,"style":478},"# 1. 检查 PATH 是否包含 ~\u002F.local\u002Fbin\necho $env:PATH\n\n# 2. 如缺失，手动添加（将 YourName 替换为你的用户名）\n# Win + R → sysdm.cpl → 高级 → 环境变量\n# 在用户变量的 Path 中新建：C:\\Users\\YourName\\.local\\bin\n\n# 3. 或通过 PowerShell 添加（谨慎操作，先备份）\n[Environment]::SetEnvironmentVariable(\n    \"Path\",\n    [Environment]::GetEnvironmentVariable(\"Path\", \"User\") + \";C:\\Users\\YourName\\.local\\bin\",\n    \"User\"\n)\n\n# 4. 完全关闭并重新打开终端\n",[353,1214,1215,1220,1225,1229,1234,1239,1244,1248,1253,1258,1263,1268,1273,1278,1282],{"__ignoreMap":478},[482,1216,1217],{"class":484,"line":485},[482,1218,1219],{},"# 1. 检查 PATH 是否包含 ~\u002F.local\u002Fbin\n",[482,1221,1222],{"class":484,"line":492},[482,1223,1224],{},"echo $env:PATH\n",[482,1226,1227],{"class":484,"line":564},[482,1228,568],{"emptyLinePlaceholder":567},[482,1230,1231],{"class":484,"line":571},[482,1232,1233],{},"# 2. 如缺失，手动添加（将 YourName 替换为你的用户名）\n",[482,1235,1236],{"class":484,"line":577},[482,1237,1238],{},"# Win + R → sysdm.cpl → 高级 → 环境变量\n",[482,1240,1241],{"class":484,"line":741},[482,1242,1243],{},"# 在用户变量的 Path 中新建：C:\\Users\\YourName\\.local\\bin\n",[482,1245,1246],{"class":484,"line":747},[482,1247,568],{"emptyLinePlaceholder":567},[482,1249,1250],{"class":484,"line":772},[482,1251,1252],{},"# 3. 或通过 PowerShell 添加（谨慎操作，先备份）\n",[482,1254,1255],{"class":484,"line":778},[482,1256,1257],{},"[Environment]::SetEnvironmentVariable(\n",[482,1259,1260],{"class":484,"line":798},[482,1261,1262],{},"    \"Path\",\n",[482,1264,1265],{"class":484,"line":927},[482,1266,1267],{},"    [Environment]::GetEnvironmentVariable(\"Path\", \"User\") + \";C:\\Users\\YourName\\.local\\bin\",\n",[482,1269,1270],{"class":484,"line":940},[482,1271,1272],{},"    \"User\"\n",[482,1274,1275],{"class":484,"line":945},[482,1276,1277],{},")\n",[482,1279,1280],{"class":484,"line":951},[482,1281,568],{"emptyLinePlaceholder":567},[482,1283,1285],{"class":484,"line":1284},15,[482,1286,1287],{},"# 4. 完全关闭并重新打开终端\n",[207,1289,1291],{"id":1290},"_33-wsl-安装linux-优先开发者","3.3 WSL 安装（Linux 优先开发者）",[195,1293,1294],{},"如果你主要开发面向 Linux 部署的项目（Node.js 后端、Python、Docker），WSL 是更干净的选择。",[473,1296,1298],{"className":1084,"code":1297,"language":1086,"meta":478,"style":478},"# 步骤 1：在管理员 PowerShell 中启用 WSL\nwsl --install\n\n# 步骤 2：按提示重启计算机\n# 步骤 3：重启后 Ubuntu 自动启动，创建用户名和密码\n# 步骤 4：在 Ubuntu 终端中更新系统\nsudo apt update && sudo apt upgrade -y\n\n# 步骤 5：安装 Claude Code（使用 Linux 安装命令）\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n",[353,1299,1300,1305,1310,1314,1319,1324,1329,1334,1338,1343],{"__ignoreMap":478},[482,1301,1302],{"class":484,"line":485},[482,1303,1304],{},"# 步骤 1：在管理员 PowerShell 中启用 WSL\n",[482,1306,1307],{"class":484,"line":492},[482,1308,1309],{},"wsl --install\n",[482,1311,1312],{"class":484,"line":564},[482,1313,568],{"emptyLinePlaceholder":567},[482,1315,1316],{"class":484,"line":571},[482,1317,1318],{},"# 步骤 2：按提示重启计算机\n",[482,1320,1321],{"class":484,"line":577},[482,1322,1323],{},"# 步骤 3：重启后 Ubuntu 自动启动，创建用户名和密码\n",[482,1325,1326],{"class":484,"line":741},[482,1327,1328],{},"# 步骤 4：在 Ubuntu 终端中更新系统\n",[482,1330,1331],{"class":484,"line":747},[482,1332,1333],{},"sudo apt update && sudo apt upgrade -y\n",[482,1335,1336],{"class":484,"line":772},[482,1337,568],{"emptyLinePlaceholder":567},[482,1339,1340],{"class":484,"line":778},[482,1341,1342],{},"# 步骤 5：安装 Claude Code（使用 Linux 安装命令）\n",[482,1344,1345],{"class":484,"line":798},[482,1346,1347],{},"curl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n",[195,1349,1350,1353],{},[307,1351,1352],{},"WSL 最佳实践","：",[301,1355,1356,1367,1370],{},[304,1357,1358,1359,1362,1363,1366],{},"项目文件存放在 WSL 文件系统内（",[353,1360,1361],{},"~\u002Fprojects\u002F","），而非 Windows 挂载路径（",[353,1364,1365],{},"\u002Fmnt\u002Fc\u002F...","）",[304,1368,1369],{},"跨文件系统操作显著更慢，可能导致 Claude Code 超时",[304,1371,1372],{},"WSL 内需要独立安装 Node.js（如有 npm 安装需求），Windows 侧的 Node.js 对 WSL 不可见",[207,1374,1376],{"id":1375},"_34-windows-特有配置","3.4 Windows 特有配置",[195,1378,1379],{},[307,1380,1381],{},"Git Bash 路径配置",[195,1383,1384,1385,1388],{},"Claude Code 在 Windows 上内部使用 Git Bash 执行命令。如果找不到 Git Bash，在 ",[353,1386,1387],{},"~\u002F.claude\u002Fsettings.json"," 中手动指定：",[473,1390,1394],{"className":1391,"code":1392,"language":1393,"meta":478,"style":478},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"env\": {\n    \"CLAUDE_CODE_GIT_BASH_PATH\": \"C:\\\\Program Files\\\\Git\\\\bin\\\\bash.exe\"\n  }\n}\n","json",[353,1395,1396,1401,1419,1458,1463],{"__ignoreMap":478},[482,1397,1398],{"class":484,"line":485},[482,1399,1400],{"class":506},"{\n",[482,1402,1403,1406,1410,1413,1416],{"class":484,"line":492},[482,1404,1405],{"class":506},"  \"",[482,1407,1409],{"class":1408},"spNyl","env",[482,1411,1412],{"class":506},"\"",[482,1414,1415],{"class":506},":",[482,1417,1418],{"class":506}," {\n",[482,1420,1421,1424,1427,1429,1431,1433,1436,1439,1442,1444,1446,1448,1451,1453,1456],{"class":484,"line":564},[482,1422,1423],{"class":506},"    \"",[482,1425,1426],{"class":495},"CLAUDE_CODE_GIT_BASH_PATH",[482,1428,1412],{"class":506},[482,1430,1415],{"class":506},[482,1432,763],{"class":506},[482,1434,1435],{"class":499},"C:",[482,1437,1438],{"class":753},"\\\\",[482,1440,1441],{"class":499},"Program Files",[482,1443,1438],{"class":753},[482,1445,345],{"class":499},[482,1447,1438],{"class":753},[482,1449,1450],{"class":499},"bin",[482,1452,1438],{"class":753},[482,1454,1455],{"class":499},"bash.exe",[482,1457,769],{"class":506},[482,1459,1460],{"class":484,"line":571},[482,1461,1462],{"class":506},"  }\n",[482,1464,1465],{"class":484,"line":577},[482,1466,1467],{"class":506},"}\n",[195,1469,1470],{},[307,1471,1472],{},"PowerShell 原生工具（实验性）",[195,1474,1475],{},"Claude Code 正在逐步推出 PowerShell 原生工具支持。可通过环境变量启用或禁用：",[473,1477,1479],{"className":1084,"code":1478,"language":1086,"meta":478,"style":478},"$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = \"1\"   # 启用\n$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = \"0\"   # 禁用\n",[353,1480,1481,1486],{"__ignoreMap":478},[482,1482,1483],{"class":484,"line":485},[482,1484,1485],{},"$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = \"1\"   # 启用\n",[482,1487,1488],{"class":484,"line":492},[482,1489,1490],{},"$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = \"0\"   # 禁用\n",[195,1492,1493],{},[307,1494,1495],{},"PowerShell 执行策略",[195,1497,1498],{},"如遇到执行策略错误：",[473,1500,1502],{"className":1084,"code":1501,"language":1086,"meta":478,"style":478},"Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned\n# 输入 Y 确认\n",[353,1503,1504,1509],{"__ignoreMap":478},[482,1505,1506],{"class":484,"line":485},[482,1507,1508],{},"Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned\n",[482,1510,1511],{"class":484,"line":492},[482,1512,1513],{},"# 输入 Y 确认\n",[199,1515],{},[202,1517,1519],{"id":1518},"四linux-安装","四、Linux 安装",[207,1521,1523],{"id":1522},"_41-通用安装ubuntu-debian-大多数发行版","4.1 通用安装（Ubuntu \u002F Debian \u002F 大多数发行版）",[473,1525,1527],{"className":475,"code":1526,"language":477,"meta":478,"style":478},"# 一键安装（与 macOS 相同命令）\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n",[353,1528,1529,1534],{"__ignoreMap":478},[482,1530,1531],{"class":484,"line":485},[482,1532,1533],{"class":488},"# 一键安装（与 macOS 相同命令）\n",[482,1535,1536,1538,1540,1542,1544],{"class":484,"line":492},[482,1537,496],{"class":495},[482,1539,500],{"class":499},[482,1541,503],{"class":499},[482,1543,507],{"class":506},[482,1545,510],{"class":495},[195,1547,1548],{},"安装器自动检测架构（x64 或 ARM64）并下载对应二进制文件。",[207,1550,1552],{"id":1551},"_42-包管理器安装","4.2 包管理器安装",[195,1554,1555,1556,1559],{},"Claude Code 提供官方签名的 apt、dnf 和 apk 仓库。",[307,1557,1558],{},"包管理器安装的版本不会通过 Claude Code 自动更新","，更新走系统正常的升级流程。",[195,1561,1562],{},[307,1563,1564],{},"apt（Debian \u002F Ubuntu）",[473,1566,1568],{"className":475,"code":1567,"language":477,"meta":478,"style":478},"sudo install -d -m 0755 \u002Fetc\u002Fapt\u002Fkeyrings\nsudo curl -fsSL https:\u002F\u002Fdownloads.claude.ai\u002Fkeys\u002Fclaude-code.asc \\\n  -o \u002Fetc\u002Fapt\u002Fkeyrings\u002Fclaude-code.asc\n\n# 验证 GPG 指纹（应为 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE）\ngpg --show-keys \u002Fetc\u002Fapt\u002Fkeyrings\u002Fclaude-code.asc\n\necho \"deb [signed-by=\u002Fetc\u002Fapt\u002Fkeyrings\u002Fclaude-code.asc] https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fapt\u002Fstable stable main\" \\\n  | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-code.list\n\nsudo apt update\nsudo apt install claude-code\n\n# 后续更新\nsudo apt update && sudo apt upgrade claude-code\n",[353,1569,1570,1590,1605,1613,1617,1622,1632,1636,1649,1663,1667,1677,1687,1691,1696],{"__ignoreMap":478},[482,1571,1572,1575,1577,1580,1583,1587],{"class":484,"line":485},[482,1573,1574],{"class":495},"sudo",[482,1576,607],{"class":499},[482,1578,1579],{"class":499}," -d",[482,1581,1582],{"class":499}," -m",[482,1584,1586],{"class":1585},"sbssI"," 0755",[482,1588,1589],{"class":499}," \u002Fetc\u002Fapt\u002Fkeyrings\n",[482,1591,1592,1594,1597,1599,1602],{"class":484,"line":492},[482,1593,1574],{"class":495},[482,1595,1596],{"class":499}," curl",[482,1598,500],{"class":499},[482,1600,1601],{"class":499}," https:\u002F\u002Fdownloads.claude.ai\u002Fkeys\u002Fclaude-code.asc",[482,1603,1604],{"class":753}," \\\n",[482,1606,1607,1610],{"class":484,"line":564},[482,1608,1609],{"class":499},"  -o",[482,1611,1612],{"class":499}," \u002Fetc\u002Fapt\u002Fkeyrings\u002Fclaude-code.asc\n",[482,1614,1615],{"class":484,"line":571},[482,1616,568],{"emptyLinePlaceholder":567},[482,1618,1619],{"class":484,"line":577},[482,1620,1621],{"class":488},"# 验证 GPG 指纹（应为 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE）\n",[482,1623,1624,1627,1630],{"class":484,"line":741},[482,1625,1626],{"class":495},"gpg",[482,1628,1629],{"class":499}," --show-keys",[482,1631,1612],{"class":499},[482,1633,1634],{"class":484,"line":747},[482,1635,568],{"emptyLinePlaceholder":567},[482,1637,1638,1640,1642,1645,1647],{"class":484,"line":772},[482,1639,750],{"class":717},[482,1641,763],{"class":506},[482,1643,1644],{"class":499},"deb [signed-by=\u002Fetc\u002Fapt\u002Fkeyrings\u002Fclaude-code.asc] https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fapt\u002Fstable stable main",[482,1646,1412],{"class":506},[482,1648,1604],{"class":753},[482,1650,1651,1654,1657,1660],{"class":484,"line":778},[482,1652,1653],{"class":506},"  |",[482,1655,1656],{"class":495}," sudo",[482,1658,1659],{"class":499}," tee",[482,1661,1662],{"class":499}," \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-code.list\n",[482,1664,1665],{"class":484,"line":798},[482,1666,568],{"emptyLinePlaceholder":567},[482,1668,1669,1671,1674],{"class":484,"line":927},[482,1670,1574],{"class":495},[482,1672,1673],{"class":499}," apt",[482,1675,1676],{"class":499}," update\n",[482,1678,1679,1681,1683,1685],{"class":484,"line":940},[482,1680,1574],{"class":495},[482,1682,1673],{"class":499},[482,1684,607],{"class":499},[482,1686,613],{"class":499},[482,1688,1689],{"class":484,"line":945},[482,1690,568],{"emptyLinePlaceholder":567},[482,1692,1693],{"class":484,"line":951},[482,1694,1695],{"class":488},"# 后续更新\n",[482,1697,1698,1700,1702,1705,1708,1710,1712,1714],{"class":484,"line":1284},[482,1699,1574],{"class":495},[482,1701,1673],{"class":499},[482,1703,1704],{"class":499}," update",[482,1706,1707],{"class":506}," &&",[482,1709,1656],{"class":495},[482,1711,1673],{"class":499},[482,1713,655],{"class":499},[482,1715,613],{"class":499},[195,1717,1718],{},[307,1719,1720],{},"dnf（Fedora \u002F RHEL）",[473,1722,1724],{"className":475,"code":1723,"language":477,"meta":478,"style":478},"sudo tee \u002Fetc\u002Fyum.repos.d\u002Fclaude-code.repo \u003C\u003C'EOF'\n[claude-code]\nname=Claude Code\nbaseurl=https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Frpm\u002Fstable\nenabled=1\ngpgcheck=1\ngpgkey=https:\u002F\u002Fdownloads.claude.ai\u002Fkeys\u002Fclaude-code.asc\nEOF\n\nsudo dnf install claude-code\n\n# 验证指纹后确认安装\n# 后续更新\nsudo dnf upgrade claude-code\n",[353,1725,1726,1741,1746,1751,1756,1761,1766,1771,1776,1780,1791,1795,1800,1804],{"__ignoreMap":478},[482,1727,1728,1730,1732,1735,1738],{"class":484,"line":485},[482,1729,1574],{"class":495},[482,1731,1659],{"class":499},[482,1733,1734],{"class":499}," \u002Fetc\u002Fyum.repos.d\u002Fclaude-code.repo",[482,1736,1737],{"class":506}," \u003C\u003C",[482,1739,1740],{"class":506},"'EOF'\n",[482,1742,1743],{"class":484,"line":492},[482,1744,1745],{"class":499},"[claude-code]\n",[482,1747,1748],{"class":484,"line":564},[482,1749,1750],{"class":499},"name=Claude Code\n",[482,1752,1753],{"class":484,"line":571},[482,1754,1755],{"class":499},"baseurl=https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Frpm\u002Fstable\n",[482,1757,1758],{"class":484,"line":577},[482,1759,1760],{"class":499},"enabled=1\n",[482,1762,1763],{"class":484,"line":741},[482,1764,1765],{"class":499},"gpgcheck=1\n",[482,1767,1768],{"class":484,"line":747},[482,1769,1770],{"class":499},"gpgkey=https:\u002F\u002Fdownloads.claude.ai\u002Fkeys\u002Fclaude-code.asc\n",[482,1772,1773],{"class":484,"line":772},[482,1774,1775],{"class":506},"EOF\n",[482,1777,1778],{"class":484,"line":778},[482,1779,568],{"emptyLinePlaceholder":567},[482,1781,1782,1784,1787,1789],{"class":484,"line":798},[482,1783,1574],{"class":495},[482,1785,1786],{"class":499}," dnf",[482,1788,607],{"class":499},[482,1790,613],{"class":499},[482,1792,1793],{"class":484,"line":927},[482,1794,568],{"emptyLinePlaceholder":567},[482,1796,1797],{"class":484,"line":940},[482,1798,1799],{"class":488},"# 验证指纹后确认安装\n",[482,1801,1802],{"class":484,"line":945},[482,1803,1695],{"class":488},[482,1805,1806,1808,1810,1812],{"class":484,"line":951},[482,1807,1574],{"class":495},[482,1809,1786],{"class":499},[482,1811,655],{"class":499},[482,1813,613],{"class":499},[195,1815,1816],{},[307,1817,1818],{},"apk（Alpine Linux）",[195,1820,1821],{},"Alpine 和其他 musl\u002FuClibc 发行版需要额外安装依赖：",[473,1823,1825],{"className":475,"code":1824,"language":477,"meta":478,"style":478},"# 安装依赖\napk add libgcc libstdc++ ripgrep\n\n# 添加仓库密钥\nwget -O \u002Fetc\u002Fapk\u002Fkeys\u002Fclaude-code.rsa.pub \\\n  https:\u002F\u002Fdownloads.claude.ai\u002Fkeys\u002Fclaude-code.rsa.pub\n\n# 验证密钥（sha256sum 应为 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6）\nsha256sum \u002Fetc\u002Fapk\u002Fkeys\u002Fclaude-code.rsa.pub\n\necho \"https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fapk\u002Fstable\" >> \u002Fetc\u002Fapk\u002Frepositories\napk add claude-code\n\n# 配置使用系统 ripgrep\necho '{\n  \"env\": {\n    \"USE_BUILTIN_RIPGREP\": \"0\"\n  }\n}' > ~\u002F.claude\u002Fsettings.json\n\n# 后续更新\napk update && apk upgrade claude-code\n",[353,1826,1827,1832,1849,1853,1858,1871,1876,1880,1885,1893,1897,1913,1921,1925,1930,1938,1944,1950,1955,1969,1974,1979],{"__ignoreMap":478},[482,1828,1829],{"class":484,"line":485},[482,1830,1831],{"class":488},"# 安装依赖\n",[482,1833,1834,1837,1840,1843,1846],{"class":484,"line":492},[482,1835,1836],{"class":495},"apk",[482,1838,1839],{"class":499}," add",[482,1841,1842],{"class":499}," libgcc",[482,1844,1845],{"class":499}," libstdc++",[482,1847,1848],{"class":499}," ripgrep\n",[482,1850,1851],{"class":484,"line":564},[482,1852,568],{"emptyLinePlaceholder":567},[482,1854,1855],{"class":484,"line":571},[482,1856,1857],{"class":488},"# 添加仓库密钥\n",[482,1859,1860,1863,1866,1869],{"class":484,"line":577},[482,1861,1862],{"class":495},"wget",[482,1864,1865],{"class":499}," -O",[482,1867,1868],{"class":499}," \u002Fetc\u002Fapk\u002Fkeys\u002Fclaude-code.rsa.pub",[482,1870,1604],{"class":753},[482,1872,1873],{"class":484,"line":741},[482,1874,1875],{"class":499},"  https:\u002F\u002Fdownloads.claude.ai\u002Fkeys\u002Fclaude-code.rsa.pub\n",[482,1877,1878],{"class":484,"line":747},[482,1879,568],{"emptyLinePlaceholder":567},[482,1881,1882],{"class":484,"line":772},[482,1883,1884],{"class":488},"# 验证密钥（sha256sum 应为 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6）\n",[482,1886,1887,1890],{"class":484,"line":778},[482,1888,1889],{"class":495},"sha256sum",[482,1891,1892],{"class":499}," \u002Fetc\u002Fapk\u002Fkeys\u002Fclaude-code.rsa.pub\n",[482,1894,1895],{"class":484,"line":798},[482,1896,568],{"emptyLinePlaceholder":567},[482,1898,1899,1901,1903,1906,1908,1910],{"class":484,"line":927},[482,1900,750],{"class":717},[482,1902,763],{"class":506},[482,1904,1905],{"class":499},"https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fapk\u002Fstable",[482,1907,1412],{"class":506},[482,1909,792],{"class":506},[482,1911,1912],{"class":499}," \u002Fetc\u002Fapk\u002Frepositories\n",[482,1914,1915,1917,1919],{"class":484,"line":940},[482,1916,1836],{"class":495},[482,1918,1839],{"class":499},[482,1920,613],{"class":499},[482,1922,1923],{"class":484,"line":945},[482,1924,568],{"emptyLinePlaceholder":567},[482,1926,1927],{"class":484,"line":951},[482,1928,1929],{"class":488},"# 配置使用系统 ripgrep\n",[482,1931,1932,1934,1936],{"class":484,"line":1284},[482,1933,750],{"class":717},[482,1935,783],{"class":506},[482,1937,1400],{"class":499},[482,1939,1941],{"class":484,"line":1940},16,[482,1942,1943],{"class":499},"  \"env\": {\n",[482,1945,1947],{"class":484,"line":1946},17,[482,1948,1949],{"class":499},"    \"USE_BUILTIN_RIPGREP\": \"0\"\n",[482,1951,1953],{"class":484,"line":1952},18,[482,1954,1462],{"class":499},[482,1956,1958,1961,1963,1966],{"class":484,"line":1957},19,[482,1959,1960],{"class":499},"}",[482,1962,789],{"class":506},[482,1964,1965],{"class":506}," >",[482,1967,1968],{"class":499}," ~\u002F.claude\u002Fsettings.json\n",[482,1970,1972],{"class":484,"line":1971},20,[482,1973,568],{"emptyLinePlaceholder":567},[482,1975,1977],{"class":484,"line":1976},21,[482,1978,1695],{"class":488},[482,1980,1982,1984,1986,1988,1991,1993],{"class":484,"line":1981},22,[482,1983,1836],{"class":495},[482,1985,1704],{"class":499},[482,1987,1707],{"class":506},[482,1989,1990],{"class":495}," apk",[482,1992,655],{"class":499},[482,1994,613],{"class":499},[207,1996,1998],{"id":1997},"_43-npm-安装","4.3 npm 安装",[473,2000,2002],{"className":475,"code":2001,"language":477,"meta":478,"style":478},"sudo npm install -g @anthropic-ai\u002Fclaude-code\n",[353,2003,2004],{"__ignoreMap":478},[482,2005,2006,2008,2011,2013,2015],{"class":484,"line":485},[482,2007,1574],{"class":495},[482,2009,2010],{"class":499}," npm",[482,2012,607],{"class":499},[482,2014,679],{"class":499},[482,2016,682],{"class":499},[195,2018,2019,2020,2023],{},"需要 Node.js 18+。npm 包通过平台特定的可选依赖（如 ",[353,2021,2022],{},"@anthropic-ai\u002Fclaude-code-linux-x64","）拉取原生二进制文件。",[195,2025,2026,2027,2030,2031,2030,2034,2030,2037,2030,2040,2030,2043,2030,2046,2030,2049,1164],{},"支持的 npm 平台：",[353,2028,2029],{},"darwin-arm64","、",[353,2032,2033],{},"darwin-x64",[353,2035,2036],{},"linux-x64",[353,2038,2039],{},"linux-arm64",[353,2041,2042],{},"linux-x64-musl",[353,2044,2045],{},"linux-arm64-musl",[353,2047,2048],{},"win32-x64",[353,2050,2051],{},"win32-arm64",[199,2053],{},[202,2055,2057],{"id":2056},"五网络要求与国内访问注意事项","五、网络要求与国内访问注意事项",[207,2059,2061],{"id":2060},"_51-安装阶段的网络问题","5.1 安装阶段的网络问题",[195,2063,2064,2065,2068,2069,2072],{},"Claude Code 的安装脚本和更新检查需要从 ",[353,2066,2067],{},"claude.ai"," 和 ",[353,2070,2071],{},"downloads.claude.ai"," 下载文件。国内直接访问可能遇到超时或失败。",[195,2074,2075],{},[307,2076,2077],{},"解决方案 1：使用 npm + 国内镜像源安装",[473,2079,2081],{"className":475,"code":2080,"language":477,"meta":478,"style":478},"# 配置淘宝 npm 镜像\nnpm config set registry https:\u002F\u002Fregistry.npmmirror.com\u002F\n\n# 验证配置\nnpm config get registry\n# 应输出：https:\u002F\u002Fregistry.npmmirror.com\u002F\n\n# 全局安装\nnpm install -g @anthropic-ai\u002Fclaude-code\n",[353,2082,2083,2088,2104,2108,2113,2125,2130,2134,2139],{"__ignoreMap":478},[482,2084,2085],{"class":484,"line":485},[482,2086,2087],{"class":488},"# 配置淘宝 npm 镜像\n",[482,2089,2090,2092,2095,2098,2101],{"class":484,"line":492},[482,2091,674],{"class":495},[482,2093,2094],{"class":499}," config",[482,2096,2097],{"class":499}," set",[482,2099,2100],{"class":499}," registry",[482,2102,2103],{"class":499}," https:\u002F\u002Fregistry.npmmirror.com\u002F\n",[482,2105,2106],{"class":484,"line":564},[482,2107,568],{"emptyLinePlaceholder":567},[482,2109,2110],{"class":484,"line":571},[482,2111,2112],{"class":488},"# 验证配置\n",[482,2114,2115,2117,2119,2122],{"class":484,"line":577},[482,2116,674],{"class":495},[482,2118,2094],{"class":499},[482,2120,2121],{"class":499}," get",[482,2123,2124],{"class":499}," registry\n",[482,2126,2127],{"class":484,"line":741},[482,2128,2129],{"class":488},"# 应输出：https:\u002F\u002Fregistry.npmmirror.com\u002F\n",[482,2131,2132],{"class":484,"line":747},[482,2133,568],{"emptyLinePlaceholder":567},[482,2135,2136],{"class":484,"line":772},[482,2137,2138],{"class":488},"# 全局安装\n",[482,2140,2141,2143,2145,2147],{"class":484,"line":778},[482,2142,674],{"class":495},[482,2144,607],{"class":499},[482,2146,679],{"class":499},[482,2148,682],{"class":499},[195,2150,2151],{},[307,2152,2153],{},"解决方案 2：配置代理后执行 curl 安装",[473,2155,2157],{"className":475,"code":2156,"language":477,"meta":478,"style":478},"export HTTPS_PROXY=http:\u002F\u002Fyour-proxy:port\nexport HTTP_PROXY=http:\u002F\u002Fyour-proxy:port\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n",[353,2158,2159,2173,2184],{"__ignoreMap":478},[482,2160,2161,2164,2167,2170],{"class":484,"line":485},[482,2162,2163],{"class":1408},"export",[482,2165,2166],{"class":753}," HTTPS_PROXY",[482,2168,2169],{"class":506},"=",[482,2171,2172],{"class":753},"http:\u002F\u002Fyour-proxy:port\n",[482,2174,2175,2177,2180,2182],{"class":484,"line":492},[482,2176,2163],{"class":1408},[482,2178,2179],{"class":753}," HTTP_PROXY",[482,2181,2169],{"class":506},[482,2183,2172],{"class":753},[482,2185,2186,2188,2190,2192,2194],{"class":484,"line":564},[482,2187,496],{"class":495},[482,2189,500],{"class":499},[482,2191,503],{"class":499},[482,2193,507],{"class":506},[482,2195,510],{"class":495},[195,2197,2198],{},[307,2199,2200],{},"解决方案 3：先下载安装脚本，再本地执行",[473,2202,2204],{"className":475,"code":2203,"language":477,"meta":478,"style":478},"# 通过浏览器或其他工具下载 install.sh\n# 然后本地执行\nbash install.sh\n",[353,2205,2206,2211,2216],{"__ignoreMap":478},[482,2207,2208],{"class":484,"line":485},[482,2209,2210],{"class":488},"# 通过浏览器或其他工具下载 install.sh\n",[482,2212,2213],{"class":484,"line":492},[482,2214,2215],{"class":488},"# 然后本地执行\n",[482,2217,2218,2220],{"class":484,"line":564},[482,2219,477],{"class":495},[482,2221,2222],{"class":499}," install.sh\n",[207,2224,2226],{"id":2225},"_52-使用阶段的网络问题","5.2 使用阶段的网络问题",[195,2228,2229,2230,2233],{},"Claude Code 运行时需要连接 Anthropic API（",[353,2231,2232],{},"api.anthropic.com","）。国内用户有以下选择：",[195,2235,2236],{},[307,2237,2238],{},"路线 A：API 中转站（使用 Claude 原版模型）",[195,2240,2241],{},"通过第三方 API 中转站代理请求，支持支付宝\u002F微信付款，按量计费。",[195,2243,2244,2245,2247],{},"配置方式（在 ",[353,2246,1387],{}," 中）：",[473,2249,2251],{"className":1391,"code":2250,"language":1393,"meta":478,"style":478},"{\n  \"env\": {\n    \"ANTHROPIC_AUTH_TOKEN\": \"sk-your-api-key\",\n    \"ANTHROPIC_BASE_URL\": \"https:\u002F\u002Fyour-router-domain.com\"\n  }\n}\n",[353,2252,2253,2257,2269,2290,2308,2312],{"__ignoreMap":478},[482,2254,2255],{"class":484,"line":485},[482,2256,1400],{"class":506},[482,2258,2259,2261,2263,2265,2267],{"class":484,"line":492},[482,2260,1405],{"class":506},[482,2262,1409],{"class":1408},[482,2264,1412],{"class":506},[482,2266,1415],{"class":506},[482,2268,1418],{"class":506},[482,2270,2271,2273,2276,2278,2280,2282,2285,2287],{"class":484,"line":564},[482,2272,1423],{"class":506},[482,2274,2275],{"class":495},"ANTHROPIC_AUTH_TOKEN",[482,2277,1412],{"class":506},[482,2279,1415],{"class":506},[482,2281,763],{"class":506},[482,2283,2284],{"class":499},"sk-your-api-key",[482,2286,1412],{"class":506},[482,2288,2289],{"class":506},",\n",[482,2291,2292,2294,2297,2299,2301,2303,2306],{"class":484,"line":571},[482,2293,1423],{"class":506},[482,2295,2296],{"class":495},"ANTHROPIC_BASE_URL",[482,2298,1412],{"class":506},[482,2300,1415],{"class":506},[482,2302,763],{"class":506},[482,2304,2305],{"class":499},"https:\u002F\u002Fyour-router-domain.com",[482,2307,769],{"class":506},[482,2309,2310],{"class":484,"line":577},[482,2311,1462],{"class":506},[482,2313,2314],{"class":484,"line":741},[482,2315,1467],{"class":506},[195,2317,2318],{},[307,2319,2320],{},"路线 B：接入国产模型（零成本方案）",[195,2322,2323,2324,2327],{},"使用 ",[353,2325,2326],{},"claude-code-router"," 等开源工具，将请求转发给硅基流动、DeepSeek、火山引擎等国内模型服务。",[473,2329,2331],{"className":475,"code":2330,"language":477,"meta":478,"style":478},"# 安装 router\nnpm install -g @musistudio\u002Fclaude-code-router\n\n# 配置 ~\u002F.claude-code-router\u002Fconfig.json\n# 然后使用 ccr code 启动\n",[353,2332,2333,2338,2349,2353,2358],{"__ignoreMap":478},[482,2334,2335],{"class":484,"line":485},[482,2336,2337],{"class":488},"# 安装 router\n",[482,2339,2340,2342,2344,2346],{"class":484,"line":492},[482,2341,674],{"class":495},[482,2343,607],{"class":499},[482,2345,679],{"class":499},[482,2347,2348],{"class":499}," @musistudio\u002Fclaude-code-router\n",[482,2350,2351],{"class":484,"line":564},[482,2352,568],{"emptyLinePlaceholder":567},[482,2354,2355],{"class":484,"line":571},[482,2356,2357],{"class":488},"# 配置 ~\u002F.claude-code-router\u002Fconfig.json\n",[482,2359,2360],{"class":484,"line":577},[482,2361,2362],{"class":488},"# 然后使用 ccr code 启动\n",[195,2364,2365],{},[307,2366,2367],{},"路线 C：企业代理配置",[473,2369,2371],{"className":475,"code":2370,"language":477,"meta":478,"style":478},"# 设置环境变量（当前会话有效）\nexport HTTPS_PROXY=http:\u002F\u002Fproxy.company.com:8080\n\n# 或在 settings.json 中持久化配置\n{\n  \"env\": {\n    \"HTTPS_PROXY\": \"http:\u002F\u002Fproxy.company.com:8080\"\n  }\n}\n",[353,2372,2373,2378,2389,2393,2398,2402,2411,2425,2429],{"__ignoreMap":478},[482,2374,2375],{"class":484,"line":485},[482,2376,2377],{"class":488},"# 设置环境变量（当前会话有效）\n",[482,2379,2380,2382,2384,2386],{"class":484,"line":492},[482,2381,2163],{"class":1408},[482,2383,2166],{"class":753},[482,2385,2169],{"class":506},[482,2387,2388],{"class":753},"http:\u002F\u002Fproxy.company.com:8080\n",[482,2390,2391],{"class":484,"line":564},[482,2392,568],{"emptyLinePlaceholder":567},[482,2394,2395],{"class":484,"line":571},[482,2396,2397],{"class":488},"# 或在 settings.json 中持久化配置\n",[482,2399,2400],{"class":484,"line":577},[482,2401,1400],{"class":506},[482,2403,2404,2407,2409],{"class":484,"line":741},[482,2405,2406],{"class":495},"  \"env\"",[482,2408,1415],{"class":717},[482,2410,1418],{"class":499},[482,2412,2413,2416,2418,2420,2423],{"class":484,"line":747},[482,2414,2415],{"class":495},"    \"HTTPS_PROXY\"",[482,2417,1415],{"class":717},[482,2419,763],{"class":506},[482,2421,2422],{"class":499},"http:\u002F\u002Fproxy.company.com:8080",[482,2424,769],{"class":506},[482,2426,2427],{"class":484,"line":772},[482,2428,1462],{"class":506},[482,2430,2431],{"class":484,"line":778},[482,2432,1467],{"class":753},[207,2434,2436],{"id":2435},"_53-国内安装检查清单","5.3 国内安装检查清单",[301,2438,2441,2450,2456,2462,2472],{"className":2439},[2440],"contains-task-list",[304,2442,2445,2449],{"className":2443},[2444],"task-list-item",[2446,2447],"input",{"disabled":567,"type":2448},"checkbox"," npm 已配置国内镜像源（推荐淘宝镜像）",[304,2451,2453,2455],{"className":2452},[2444],[2446,2454],{"disabled":567,"type":2448}," 终端以管理员身份运行（Windows）",[304,2457,2459,2461],{"className":2458},[2444],[2446,2460],{"disabled":567,"type":2448}," 安装完成后关闭并重新打开终端",[304,2463,2465,2467,2468,2471],{"className":2464},[2444],[2446,2466],{"disabled":567,"type":2448}," ",[353,2469,2470],{},"claude --version"," 能正常输出版本号",[304,2473,2475,2477],{"className":2474},[2444],[2446,2476],{"disabled":567,"type":2448}," 网络代理配置正确（如使用代理）",[199,2479],{},[202,2481,2483],{"id":2482},"六验证安装","六、验证安装",[207,2485,2487],{"id":2486},"_61-基础验证","6.1 基础验证",[473,2489,2491],{"className":475,"code":2490,"language":477,"meta":478,"style":478},"# 检查 claude 命令是否可用\nwhich claude          # macOS\u002FLinux\nwhere.exe claude      # Windows PowerShell\n\n# 查看版本号\nclaude --version\n# 预期输出类似：2.1.xxx\n\n# 详细诊断（强烈推荐首次安装后运行）\nclaude doctor\n",[353,2492,2493,2498,2507,2517,2521,2526,2532,2537,2541,2546],{"__ignoreMap":478},[482,2494,2495],{"class":484,"line":485},[482,2496,2497],{"class":488},"# 检查 claude 命令是否可用\n",[482,2499,2500,2502,2504],{"class":484,"line":492},[482,2501,871],{"class":717},[482,2503,874],{"class":499},[482,2505,2506],{"class":488},"          # macOS\u002FLinux\n",[482,2508,2509,2512,2514],{"class":484,"line":564},[482,2510,2511],{"class":495},"where.exe",[482,2513,874],{"class":499},[482,2515,2516],{"class":488},"      # Windows PowerShell\n",[482,2518,2519],{"class":484,"line":571},[482,2520,568],{"emptyLinePlaceholder":567},[482,2522,2523],{"class":484,"line":577},[482,2524,2525],{"class":488},"# 查看版本号\n",[482,2527,2528,2530],{"class":484,"line":741},[482,2529,558],{"class":495},[482,2531,561],{"class":499},[482,2533,2534],{"class":484,"line":747},[482,2535,2536],{"class":488},"# 预期输出类似：2.1.xxx\n",[482,2538,2539],{"class":484,"line":772},[482,2540,568],{"emptyLinePlaceholder":567},[482,2542,2543],{"class":484,"line":778},[482,2544,2545],{"class":488},"# 详细诊断（强烈推荐首次安装后运行）\n",[482,2547,2548,2550],{"class":484,"line":798},[482,2549,558],{"class":495},[482,2551,582],{"class":499},[195,2553,2554,2557],{},[353,2555,2556],{},"claude doctor"," 会检查：",[301,2559,2560,2563,2566,2569,2572,2575],{},[304,2561,2562],{},"安装完整性（原生\u002Fnpm\u002FWinGet）",[304,2564,2565],{},"版本信息",[304,2567,2568],{},"认证状态",[304,2570,2571],{},"Git 健康度",[304,2573,2574],{},"PATH 配置",[304,2576,2577],{},"网络连通性",[207,2579,2581],{"id":2580},"_62-首次启动","6.2 首次启动",[473,2583,2585],{"className":475,"code":2584,"language":477,"meta":478,"style":478},"# 进入你的项目目录\ncd \u002Fpath\u002Fto\u002Fyour\u002Fproject\n\n# 启动 Claude Code\nclaude\n",[353,2586,2587,2592,2600,2604,2609],{"__ignoreMap":478},[482,2588,2589],{"class":484,"line":485},[482,2590,2591],{"class":488},"# 进入你的项目目录\n",[482,2593,2594,2597],{"class":484,"line":492},[482,2595,2596],{"class":717},"cd",[482,2598,2599],{"class":499}," \u002Fpath\u002Fto\u002Fyour\u002Fproject\n",[482,2601,2602],{"class":484,"line":564},[482,2603,568],{"emptyLinePlaceholder":567},[482,2605,2606],{"class":484,"line":571},[482,2607,2608],{"class":488},"# 启动 Claude Code\n",[482,2610,2611],{"class":484,"line":577},[482,2612,2613],{"class":495},"claude\n",[195,2615,2616,2617,2620],{},"首次启动会打开浏览器进行 OAuth 认证。使用 Claude Pro \u002F Max \u002F Teams 账户登录并授权后，会话令牌会保存在 ",[353,2618,2619],{},"~\u002F.claude\u002Fsession.json","，后续无需重复登录。",[195,2622,2623,1353],{},[307,2624,2625],{},"无浏览器环境（CI\u002FCD、远程服务器）",[473,2627,2629],{"className":475,"code":2628,"language":477,"meta":478,"style":478},"export ANTHROPIC_API_KEY=\"sk-ant-api03-your-key\"\nclaude\n",[353,2630,2631,2647],{"__ignoreMap":478},[482,2632,2633,2635,2638,2640,2642,2645],{"class":484,"line":485},[482,2634,2163],{"class":1408},[482,2636,2637],{"class":753}," ANTHROPIC_API_KEY",[482,2639,2169],{"class":506},[482,2641,1412],{"class":506},[482,2643,2644],{"class":499},"sk-ant-api03-your-key",[482,2646,769],{"class":506},[482,2648,2649],{"class":484,"line":492},[482,2650,2613],{"class":495},[199,2652],{},[202,2654,2656],{"id":2655},"七升级与卸载","七、升级与卸载",[207,2658,2660],{"id":2659},"_71-自动更新原生安装","7.1 自动更新（原生安装）",[195,2662,2663],{},"原生安装的 Claude Code 会在启动时和运行期间自动检查更新，后台下载并在下次启动时生效。",[195,2665,2666,1353],{},[307,2667,2668],{},"配置更新通道",[473,2670,2672],{"className":475,"code":2671,"language":477,"meta":478,"style":478},"# 通过交互式配置\nclaude \u002Fconfig\n# 选择 Auto-update channel → latest 或 stable\n",[353,2673,2674,2679,2686],{"__ignoreMap":478},[482,2675,2676],{"class":484,"line":485},[482,2677,2678],{"class":488},"# 通过交互式配置\n",[482,2680,2681,2683],{"class":484,"line":492},[482,2682,558],{"class":495},[482,2684,2685],{"class":499}," \u002Fconfig\n",[482,2687,2688],{"class":484,"line":564},[482,2689,2690],{"class":488},"# 选择 Auto-update channel → latest 或 stable\n",[195,2692,2693,2694,2696],{},"或在 ",[353,2695,1387],{}," 中：",[473,2698,2700],{"className":1391,"code":2699,"language":1393,"meta":478,"style":478},"{\n  \"autoUpdatesChannel\": \"stable\"\n}\n",[353,2701,2702,2706,2724],{"__ignoreMap":478},[482,2703,2704],{"class":484,"line":485},[482,2705,1400],{"class":506},[482,2707,2708,2710,2713,2715,2717,2719,2722],{"class":484,"line":492},[482,2709,1405],{"class":506},[482,2711,2712],{"class":1408},"autoUpdatesChannel",[482,2714,1412],{"class":506},[482,2716,1415],{"class":506},[482,2718,763],{"class":506},[482,2720,2721],{"class":499},"stable",[482,2723,769],{"class":506},[482,2725,2726],{"class":484,"line":564},[482,2727,1467],{"class":506},[301,2729,2730,2736],{},[304,2731,2732,2735],{},[353,2733,2734],{},"latest","（默认）：新功能发布后立即可用",[304,2737,2738,2740],{},[353,2739,2721],{},"：约滞后一周，跳过有严重回归的版本",[195,2742,2743,1353],{},[307,2744,2745],{},"禁用自动更新",[473,2747,2749],{"className":1391,"code":2748,"language":1393,"meta":478,"style":478},"{\n  \"env\": {\n    \"DISABLE_AUTOUPDATER\": \"1\"\n  }\n}\n",[353,2750,2751,2755,2767,2785,2789],{"__ignoreMap":478},[482,2752,2753],{"class":484,"line":485},[482,2754,1400],{"class":506},[482,2756,2757,2759,2761,2763,2765],{"class":484,"line":492},[482,2758,1405],{"class":506},[482,2760,1409],{"class":1408},[482,2762,1412],{"class":506},[482,2764,1415],{"class":506},[482,2766,1418],{"class":506},[482,2768,2769,2771,2774,2776,2778,2780,2783],{"class":484,"line":564},[482,2770,1423],{"class":506},[482,2772,2773],{"class":495},"DISABLE_AUTOUPDATER",[482,2775,1412],{"class":506},[482,2777,1415],{"class":506},[482,2779,763],{"class":506},[482,2781,2782],{"class":499},"1",[482,2784,769],{"class":506},[482,2786,2787],{"class":484,"line":571},[482,2788,1462],{"class":506},[482,2790,2791],{"class":484,"line":577},[482,2792,1467],{"class":506},[195,2794,2795,2797,2798,2068,2801,2804,2805,1164],{},[353,2796,2773],{}," 仅停止后台检查，",[353,2799,2800],{},"claude update",[353,2802,2803],{},"claude install"," 仍然可用。如需完全阻止所有更新路径，使用 ",[353,2806,2807],{},"DISABLE_UPDATES",[207,2809,2811],{"id":2810},"_72-手动更新","7.2 手动更新",[473,2813,2815],{"className":475,"code":2814,"language":477,"meta":478,"style":478},"# 立即应用更新（不等待下次后台检查）\nclaude update\n\n# 安装特定版本\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash -s 2.1.89\n",[353,2816,2817,2822,2828,2832,2837],{"__ignoreMap":478},[482,2818,2819],{"class":484,"line":485},[482,2820,2821],{"class":488},"# 立即应用更新（不等待下次后台检查）\n",[482,2823,2824,2826],{"class":484,"line":492},[482,2825,558],{"class":495},[482,2827,1676],{"class":499},[482,2829,2830],{"class":484,"line":564},[482,2831,568],{"emptyLinePlaceholder":567},[482,2833,2834],{"class":484,"line":571},[482,2835,2836],{"class":488},"# 安装特定版本\n",[482,2838,2839,2841,2843,2845,2847,2850,2853],{"class":484,"line":577},[482,2840,496],{"class":495},[482,2842,500],{"class":499},[482,2844,503],{"class":499},[482,2846,507],{"class":506},[482,2848,2849],{"class":495}," bash",[482,2851,2852],{"class":499}," -s",[482,2854,2855],{"class":1585}," 2.1.89\n",[195,2857,2858,1353],{},[307,2859,2860],{},"版本锁定",[473,2862,2864],{"className":1391,"code":2863,"language":1393,"meta":478,"style":478},"{\n  \"autoUpdatesChannel\": \"stable\",\n  \"minimumVersion\": \"2.1.100\"\n}\n",[353,2865,2866,2870,2888,2906],{"__ignoreMap":478},[482,2867,2868],{"class":484,"line":485},[482,2869,1400],{"class":506},[482,2871,2872,2874,2876,2878,2880,2882,2884,2886],{"class":484,"line":492},[482,2873,1405],{"class":506},[482,2875,2712],{"class":1408},[482,2877,1412],{"class":506},[482,2879,1415],{"class":506},[482,2881,763],{"class":506},[482,2883,2721],{"class":499},[482,2885,1412],{"class":506},[482,2887,2289],{"class":506},[482,2889,2890,2892,2895,2897,2899,2901,2904],{"class":484,"line":564},[482,2891,1405],{"class":506},[482,2893,2894],{"class":1408},"minimumVersion",[482,2896,1412],{"class":506},[482,2898,1415],{"class":506},[482,2900,763],{"class":506},[482,2902,2903],{"class":499},"2.1.100",[482,2905,769],{"class":506},[482,2907,2908],{"class":484,"line":571},[482,2909,1467],{"class":506},[195,2911,2912,2914,2915,2917,2918,2920],{},[353,2913,2894],{}," 设置版本下限，防止从 ",[353,2916,2734],{}," 回退到 ",[353,2919,2721],{}," 时降级。",[207,2922,2924],{"id":2923},"_73-各平台卸载方法","7.3 各平台卸载方法",[195,2926,2927],{},[307,2928,2929],{},"原生安装",[473,2931,2933],{"className":475,"code":2932,"language":477,"meta":478,"style":478},"# macOS \u002F Linux \u002F WSL\nrm -f ~\u002F.local\u002Fbin\u002Fclaude\nrm -rf ~\u002F.local\u002Fshare\u002Fclaude\n\n# Windows PowerShell\nRemove-Item -Path \"$env:USERPROFILE\\.local\\bin\\claude.exe\" -Force\nRemove-Item -Path \"$env:USERPROFILE\\.local\\share\\claude\" -Recurse -Force\n",[353,2934,2935,2940,2951,2961,2965,2970,2991],{"__ignoreMap":478},[482,2936,2937],{"class":484,"line":485},[482,2938,2939],{"class":488},"# macOS \u002F Linux \u002F WSL\n",[482,2941,2942,2945,2948],{"class":484,"line":492},[482,2943,2944],{"class":495},"rm",[482,2946,2947],{"class":499}," -f",[482,2949,2950],{"class":499}," ~\u002F.local\u002Fbin\u002Fclaude\n",[482,2952,2953,2955,2958],{"class":484,"line":564},[482,2954,2944],{"class":495},[482,2956,2957],{"class":499}," -rf",[482,2959,2960],{"class":499}," ~\u002F.local\u002Fshare\u002Fclaude\n",[482,2962,2963],{"class":484,"line":571},[482,2964,568],{"emptyLinePlaceholder":567},[482,2966,2967],{"class":484,"line":577},[482,2968,2969],{"class":488},"# Windows PowerShell\n",[482,2971,2972,2975,2978,2980,2983,2986,2988],{"class":484,"line":741},[482,2973,2974],{"class":495},"Remove-Item",[482,2976,2977],{"class":499}," -Path",[482,2979,763],{"class":506},[482,2981,2982],{"class":753},"$env",[482,2984,2985],{"class":499},":USERPROFILE\\.local\\bin\\claude.exe",[482,2987,1412],{"class":506},[482,2989,2990],{"class":499}," -Force\n",[482,2992,2993,2995,2997,2999,3001,3004,3006,3009],{"class":484,"line":747},[482,2994,2974],{"class":495},[482,2996,2977],{"class":499},[482,2998,763],{"class":506},[482,3000,2982],{"class":753},[482,3002,3003],{"class":499},":USERPROFILE\\.local\\share\\claude",[482,3005,1412],{"class":506},[482,3007,3008],{"class":499}," -Recurse",[482,3010,2990],{"class":499},[195,3012,3013],{},[307,3014,3015],{},"Homebrew",[473,3017,3019],{"className":475,"code":3018,"language":477,"meta":478,"style":478},"# 稳定版\nbrew uninstall --cask claude-code\n\n# 最新版\nbrew uninstall --cask claude-code@latest\n",[353,3020,3021,3026,3036,3040,3045],{"__ignoreMap":478},[482,3022,3023],{"class":484,"line":485},[482,3024,3025],{"class":488},"# 稳定版\n",[482,3027,3028,3030,3032,3034],{"class":484,"line":492},[482,3029,604],{"class":495},[482,3031,893],{"class":499},[482,3033,610],{"class":499},[482,3035,613],{"class":499},[482,3037,3038],{"class":484,"line":564},[482,3039,568],{"emptyLinePlaceholder":567},[482,3041,3042],{"class":484,"line":571},[482,3043,3044],{"class":488},"# 最新版\n",[482,3046,3047,3049,3051,3053],{"class":484,"line":577},[482,3048,604],{"class":495},[482,3050,893],{"class":499},[482,3052,610],{"class":499},[482,3054,633],{"class":499},[195,3056,3057],{},[307,3058,3059],{},"WinGet",[473,3061,3063],{"className":1084,"code":3062,"language":1086,"meta":478,"style":478},"winget uninstall Anthropic.ClaudeCode\n",[353,3064,3065],{"__ignoreMap":478},[482,3066,3067],{"class":484,"line":485},[482,3068,3062],{},[195,3070,3071],{},[307,3072,3073],{},"apt \u002F dnf \u002F apk",[473,3075,3077],{"className":475,"code":3076,"language":477,"meta":478,"style":478},"# apt\nsudo apt remove claude-code\nsudo rm \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-code.list \u002Fetc\u002Fapt\u002Fkeyrings\u002Fclaude-code.asc\n\n# dnf\nsudo dnf remove claude-code\nsudo rm \u002Fetc\u002Fyum.repos.d\u002Fclaude-code.repo\n\n# apk\napk del claude-code\nsed -i '\\|downloads.claude.ai\u002Fclaude-code\u002Fapk|d' \u002Fetc\u002Fapk\u002Frepositories\nrm \u002Fetc\u002Fapk\u002Fkeys\u002Fclaude-code.rsa.pub\n",[353,3078,3079,3084,3095,3107,3111,3116,3126,3135,3139,3144,3153,3170],{"__ignoreMap":478},[482,3080,3081],{"class":484,"line":485},[482,3082,3083],{"class":488},"# apt\n",[482,3085,3086,3088,3090,3093],{"class":484,"line":492},[482,3087,1574],{"class":495},[482,3089,1673],{"class":499},[482,3091,3092],{"class":499}," remove",[482,3094,613],{"class":499},[482,3096,3097,3099,3102,3105],{"class":484,"line":564},[482,3098,1574],{"class":495},[482,3100,3101],{"class":499}," rm",[482,3103,3104],{"class":499}," \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-code.list",[482,3106,1612],{"class":499},[482,3108,3109],{"class":484,"line":571},[482,3110,568],{"emptyLinePlaceholder":567},[482,3112,3113],{"class":484,"line":577},[482,3114,3115],{"class":488},"# dnf\n",[482,3117,3118,3120,3122,3124],{"class":484,"line":741},[482,3119,1574],{"class":495},[482,3121,1786],{"class":499},[482,3123,3092],{"class":499},[482,3125,613],{"class":499},[482,3127,3128,3130,3132],{"class":484,"line":747},[482,3129,1574],{"class":495},[482,3131,3101],{"class":499},[482,3133,3134],{"class":499}," \u002Fetc\u002Fyum.repos.d\u002Fclaude-code.repo\n",[482,3136,3137],{"class":484,"line":772},[482,3138,568],{"emptyLinePlaceholder":567},[482,3140,3141],{"class":484,"line":778},[482,3142,3143],{"class":488},"# apk\n",[482,3145,3146,3148,3151],{"class":484,"line":798},[482,3147,1836],{"class":495},[482,3149,3150],{"class":499}," del",[482,3152,613],{"class":499},[482,3154,3155,3158,3161,3163,3166,3168],{"class":484,"line":927},[482,3156,3157],{"class":495},"sed",[482,3159,3160],{"class":499}," -i",[482,3162,783],{"class":506},[482,3164,3165],{"class":499},"\\|downloads.claude.ai\u002Fclaude-code\u002Fapk|d",[482,3167,789],{"class":506},[482,3169,1912],{"class":499},[482,3171,3172,3174],{"class":484,"line":940},[482,3173,2944],{"class":495},[482,3175,1892],{"class":499},[195,3177,3178],{},[307,3179,674],{},[473,3181,3183],{"className":475,"code":3182,"language":477,"meta":478,"style":478},"npm uninstall -g @anthropic-ai\u002Fclaude-code\n",[353,3184,3185],{"__ignoreMap":478},[482,3186,3187,3189,3191,3193],{"class":484,"line":485},[482,3188,674],{"class":495},[482,3190,893],{"class":499},[482,3192,679],{"class":499},[482,3194,682],{"class":499},[207,3196,3198],{"id":3197},"_74-彻底清理配置","7.4 彻底清理配置",[195,3200,3201],{},"如需完全移除 Claude Code 的所有痕迹（包括用户设置、项目配置、缓存数据）：",[473,3203,3205],{"className":475,"code":3204,"language":477,"meta":478,"style":478},"# macOS \u002F Linux \u002F WSL\n# 移除用户级设置和状态\nrm -rf ~\u002F.claude\nrm ~\u002F.claude.json\n\n# 在项目目录中移除项目级设置\nrm -rf .claude\nrm -f .mcp.json\n\n# Windows PowerShell\nRemove-Item -Path \"$env:USERPROFILE\\.claude\" -Recurse -Force\nRemove-Item -Path \"$env:USERPROFILE\\.claude.json\" -Force\nRemove-Item -Path \".claude\" -Recurse -Force\nRemove-Item -Path \".mcp.json\" -Force\n",[353,3206,3207,3211,3216,3225,3232,3236,3241,3250,3259,3263,3267,3286,3303,3320],{"__ignoreMap":478},[482,3208,3209],{"class":484,"line":485},[482,3210,2939],{"class":488},[482,3212,3213],{"class":484,"line":492},[482,3214,3215],{"class":488},"# 移除用户级设置和状态\n",[482,3217,3218,3220,3222],{"class":484,"line":564},[482,3219,2944],{"class":495},[482,3221,2957],{"class":499},[482,3223,3224],{"class":499}," ~\u002F.claude\n",[482,3226,3227,3229],{"class":484,"line":571},[482,3228,2944],{"class":495},[482,3230,3231],{"class":499}," ~\u002F.claude.json\n",[482,3233,3234],{"class":484,"line":577},[482,3235,568],{"emptyLinePlaceholder":567},[482,3237,3238],{"class":484,"line":741},[482,3239,3240],{"class":488},"# 在项目目录中移除项目级设置\n",[482,3242,3243,3245,3247],{"class":484,"line":747},[482,3244,2944],{"class":495},[482,3246,2957],{"class":499},[482,3248,3249],{"class":499}," .claude\n",[482,3251,3252,3254,3256],{"class":484,"line":772},[482,3253,2944],{"class":495},[482,3255,2947],{"class":499},[482,3257,3258],{"class":499}," .mcp.json\n",[482,3260,3261],{"class":484,"line":778},[482,3262,568],{"emptyLinePlaceholder":567},[482,3264,3265],{"class":484,"line":798},[482,3266,2969],{"class":488},[482,3268,3269,3271,3273,3275,3277,3280,3282,3284],{"class":484,"line":927},[482,3270,2974],{"class":495},[482,3272,2977],{"class":499},[482,3274,763],{"class":506},[482,3276,2982],{"class":753},[482,3278,3279],{"class":499},":USERPROFILE\\.claude",[482,3281,1412],{"class":506},[482,3283,3008],{"class":499},[482,3285,2990],{"class":499},[482,3287,3288,3290,3292,3294,3296,3299,3301],{"class":484,"line":940},[482,3289,2974],{"class":495},[482,3291,2977],{"class":499},[482,3293,763],{"class":506},[482,3295,2982],{"class":753},[482,3297,3298],{"class":499},":USERPROFILE\\.claude.json",[482,3300,1412],{"class":506},[482,3302,2990],{"class":499},[482,3304,3305,3307,3309,3311,3314,3316,3318],{"class":484,"line":945},[482,3306,2974],{"class":495},[482,3308,2977],{"class":499},[482,3310,763],{"class":506},[482,3312,3313],{"class":499},".claude",[482,3315,1412],{"class":506},[482,3317,3008],{"class":499},[482,3319,2990],{"class":499},[482,3321,3322,3324,3326,3328,3331,3333],{"class":484,"line":951},[482,3323,2974],{"class":495},[482,3325,2977],{"class":499},[482,3327,763],{"class":506},[482,3329,3330],{"class":499},".mcp.json",[482,3332,1412],{"class":506},[482,3334,2990],{"class":499},[454,3336,3337],{},[195,3338,3339,3340,3342],{},"注意：VS Code 扩展、JetBrains 插件和 Desktop 应用也会写入 ",[353,3341,961],{}," 目录。如果其中任一工具仍安装，该目录会在下次运行时重新创建。",[199,3344],{},[202,3346,3348],{"id":3347},"八安装方法对比速查表","八、安装方法对比速查表",[212,3350,3351,3369],{},[215,3352,3353],{},[218,3354,3355,3358,3360,3363,3366],{},[221,3356,3357],{},"安装方式",[221,3359,223],{},[221,3361,3362],{},"自动更新",[221,3364,3365],{},"依赖",[221,3367,3368],{},"适用人群",[231,3370,3371,3390,3406,3421,3434,3449,3466],{},[218,3372,3373,3376,3379,3382,3385],{},[236,3374,3375],{},"curl 原生安装",[236,3377,3378],{},"macOS \u002F Linux \u002F WSL",[236,3380,3381],{},"是",[236,3383,3384],{},"无",[236,3386,3387],{},[307,3388,3389],{},"大多数用户首选",[218,3391,3392,3395,3397,3399,3401],{},[236,3393,3394],{},"PowerShell 原生安装",[236,3396,249],{},[236,3398,3381],{},[236,3400,1006],{},[236,3402,3403],{},[307,3404,3405],{},"Windows 用户首选",[218,3407,3408,3410,3413,3416,3418],{},[236,3409,3015],{},[236,3411,3412],{},"macOS \u002F Linux",[236,3414,3415],{},"否",[236,3417,3015],{},[236,3419,3420],{},"Homebrew 用户",[218,3422,3423,3425,3427,3429,3431],{},[236,3424,3059],{},[236,3426,249],{},[236,3428,3415],{},[236,3430,3059],{},[236,3432,3433],{},"Windows 包管理用户",[218,3435,3436,3438,3441,3443,3446],{},[236,3437,674],{},[236,3439,3440],{},"全平台",[236,3442,3415],{},[236,3444,3445],{},"Node.js 18+",[236,3447,3448],{},"需要版本锁定或国内镜像用户",[218,3450,3451,3454,3457,3460,3463],{},[236,3452,3453],{},"apt\u002Fdnf\u002Fapk",[236,3455,3456],{},"Linux",[236,3458,3459],{},"否（系统升级）",[236,3461,3462],{},"对应包管理器",[236,3464,3465],{},"企业部署、服务器环境",[218,3467,3468,3471,3473,3476,3478],{},[236,3469,3470],{},"WSL + Linux 安装",[236,3472,249],{},[236,3474,3475],{},"是（通过 Linux）",[236,3477,1017],{},[236,3479,3480],{},"Linux 优先开发者",[199,3482],{},[202,3484,3486],{"id":3485},"九常见问题汇总faq","九、常见问题汇总（FAQ）",[195,3488,3489],{},[307,3490,3491],{},"Q1：Claude Code 需要 Node.js 吗？",[195,3493,3494],{},"不需要。原生安装器和 Homebrew 方式零外部依赖。只有 npm 安装方式需要 Node.js 18+。",[195,3496,3497],{},[307,3498,3499],{},"Q2：Apple Silicon Mac 支持吗？",[195,3501,3502],{},"支持。原生安装器自动检测架构并下载 ARM64 二进制文件。",[195,3504,3505],{},[307,3506,3507,3508,3510],{},"Q3：安装成功但 ",[353,3509,558],{}," 命令找不到？",[195,3512,3513,3514,3517],{},"最常见原因：终端会话未刷新 PATH。完全关闭终端并重新打开。如仍有问题，检查 ",[353,3515,3516],{},"~\u002F.local\u002Fbin"," 是否在 PATH 中。",[195,3519,3520],{},[307,3521,3522],{},"Q4：npm 安装遇到 EACCES 权限错误？",[195,3524,3525,3531],{},[307,3526,3527,3528],{},"切勿使用 ",[353,3529,3530],{},"sudo npm install -g","。正确做法：",[473,3533,3535],{"className":475,"code":3534,"language":477,"meta":478,"style":478},"mkdir -p ~\u002F.npm-global\nnpm config set prefix '~\u002F.npm-global'\necho 'export PATH=~\u002F.npm-global\u002Fbin:$PATH' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\nnpm install -g @anthropic-ai\u002Fclaude-code\n",[353,3536,3537,3548,3567,3583,3589],{"__ignoreMap":478},[482,3538,3539,3542,3545],{"class":484,"line":485},[482,3540,3541],{"class":495},"mkdir",[482,3543,3544],{"class":499}," -p",[482,3546,3547],{"class":499}," ~\u002F.npm-global\n",[482,3549,3550,3552,3554,3556,3559,3561,3564],{"class":484,"line":492},[482,3551,674],{"class":495},[482,3553,2094],{"class":499},[482,3555,2097],{"class":499},[482,3557,3558],{"class":499}," prefix",[482,3560,783],{"class":506},[482,3562,3563],{"class":499},"~\u002F.npm-global",[482,3565,3566],{"class":506},"'\n",[482,3568,3569,3571,3573,3576,3578,3580],{"class":484,"line":564},[482,3570,750],{"class":717},[482,3572,783],{"class":506},[482,3574,3575],{"class":499},"export PATH=~\u002F.npm-global\u002Fbin:$PATH",[482,3577,789],{"class":506},[482,3579,792],{"class":506},[482,3581,3582],{"class":499}," ~\u002F.bashrc\n",[482,3584,3585,3587],{"class":484,"line":571},[482,3586,718],{"class":717},[482,3588,3582],{"class":499},[482,3590,3591,3593,3595,3597],{"class":484,"line":577},[482,3592,674],{"class":495},[482,3594,607],{"class":499},[482,3596,679],{"class":499},[482,3598,682],{"class":499},[195,3600,3601],{},"或更好：迁移到原生安装器。",[195,3603,3604],{},[307,3605,3606],{},"Q5：Windows 上 Git 已安装但 Claude Code 仍报错？",[195,3608,3609,3610,3613],{},"确认 Git 在 PATH 中：",[353,3611,3612],{},"where.exe git","。如找不到，重新安装 Git for Windows 并确保 \"Add to PATH\" 已勾选。",[195,3615,3616],{},[307,3617,3618],{},"Q6：企业网络代理导致安装\u002F认证失败？",[473,3620,3622],{"className":475,"code":3621,"language":477,"meta":478,"style":478},"export HTTPS_PROXY=http:\u002F\u002Fproxy.company.com:8080\nexport HTTP_PROXY=http:\u002F\u002Fproxy.company.com:8080\n",[353,3623,3624,3634],{"__ignoreMap":478},[482,3625,3626,3628,3630,3632],{"class":484,"line":485},[482,3627,2163],{"class":1408},[482,3629,2166],{"class":753},[482,3631,2169],{"class":506},[482,3633,2388],{"class":753},[482,3635,3636,3638,3640,3642],{"class":484,"line":492},[482,3637,2163],{"class":1408},[482,3639,2179],{"class":753},[482,3641,2169],{"class":506},[482,3643,2388],{"class":753},[195,3645,3646,3647,2068,3649,3651],{},"某些企业防火墙会阻止 WebSocket 连接，需要 IT 部门将 ",[353,3648,2067],{},[353,3650,2232],{}," 加入白名单。",[195,3653,3654],{},[307,3655,3656],{},"Q7：可以免订阅使用 Claude Code 吗？",[195,3658,3659],{},"标准安装不行。需要 Claude Pro\u002FMax\u002FTeams\u002FEnterprise 订阅，或 Anthropic Console API 账户。国内用户可通过 API 中转站或国产模型替代方案实现零成本使用。",[195,3661,3662],{},[307,3663,3664],{},"Q8：Claude Code 有桌面应用或 IDE 插件吗？",[195,3666,3667],{},"有。除了终端 CLI，还提供 VS Code 扩展、JetBrains 插件和 Desktop 应用。IDE 扩展基于已安装的 CLI 二进制文件工作。",[195,3669,3670],{},[307,3671,3672],{},"Q9：Windows 粘贴图片的快捷键是什么？",[195,3674,3675,3676,3679,3680,3683],{},"Windows 上使用 ",[353,3677,3678],{},"Alt+V"," 粘贴图片（而非 ",[353,3681,3682],{},"Ctrl+V","，后者仅粘贴文本）。",[195,3685,3686],{},[307,3687,3688],{},"Q10：如何验证下载的二进制文件完整性？",[195,3690,3691,3692,3695],{},"每个版本发布包含签名的 ",[353,3693,3694],{},"manifest.json","，其中列出所有平台二进制文件的 SHA256 校验和。验证步骤：",[473,3697,3699],{"className":475,"code":3698,"language":477,"meta":478,"style":478},"# 1. 下载 manifest 和签名\ncurl -fsSL https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fmanifest.json -o manifest.json\ncurl -fsSL https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fmanifest.json.asc -o manifest.json.asc\n\n# 2. 导入 Anthropic GPG 密钥并验证签名\ngpg --keyserver keyserver.ubuntu.com --recv-keys BAA929FF1A7ECACE\ngpg --verify manifest.json.asc manifest.json\n\n# 3. 验证二进制文件 SHA256\nshasum -a 256 .\u002Fclaude    # macOS\nsha256sum .\u002Fclaude        # Linux\n# 与 manifest.json 中对应平台的 checksum 比对\n",[353,3700,3701,3706,3720,3734,3738,3743,3759,3771,3775,3780,3797,3806],{"__ignoreMap":478},[482,3702,3703],{"class":484,"line":485},[482,3704,3705],{"class":488},"# 1. 下载 manifest 和签名\n",[482,3707,3708,3710,3712,3715,3717],{"class":484,"line":492},[482,3709,496],{"class":495},[482,3711,500],{"class":499},[482,3713,3714],{"class":499}," https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fmanifest.json",[482,3716,828],{"class":499},[482,3718,3719],{"class":499}," manifest.json\n",[482,3721,3722,3724,3726,3729,3731],{"class":484,"line":564},[482,3723,496],{"class":495},[482,3725,500],{"class":499},[482,3727,3728],{"class":499}," https:\u002F\u002Fdownloads.claude.ai\u002Fclaude-code\u002Fmanifest.json.asc",[482,3730,828],{"class":499},[482,3732,3733],{"class":499}," manifest.json.asc\n",[482,3735,3736],{"class":484,"line":571},[482,3737,568],{"emptyLinePlaceholder":567},[482,3739,3740],{"class":484,"line":577},[482,3741,3742],{"class":488},"# 2. 导入 Anthropic GPG 密钥并验证签名\n",[482,3744,3745,3747,3750,3753,3756],{"class":484,"line":741},[482,3746,1626],{"class":495},[482,3748,3749],{"class":499}," --keyserver",[482,3751,3752],{"class":499}," keyserver.ubuntu.com",[482,3754,3755],{"class":499}," --recv-keys",[482,3757,3758],{"class":499}," BAA929FF1A7ECACE\n",[482,3760,3761,3763,3766,3769],{"class":484,"line":747},[482,3762,1626],{"class":495},[482,3764,3765],{"class":499}," --verify",[482,3767,3768],{"class":499}," manifest.json.asc",[482,3770,3719],{"class":499},[482,3772,3773],{"class":484,"line":772},[482,3774,568],{"emptyLinePlaceholder":567},[482,3776,3777],{"class":484,"line":778},[482,3778,3779],{"class":488},"# 3. 验证二进制文件 SHA256\n",[482,3781,3782,3785,3788,3791,3794],{"class":484,"line":798},[482,3783,3784],{"class":495},"shasum",[482,3786,3787],{"class":499}," -a",[482,3789,3790],{"class":1585}," 256",[482,3792,3793],{"class":499}," .\u002Fclaude",[482,3795,3796],{"class":488},"    # macOS\n",[482,3798,3799,3801,3803],{"class":484,"line":927},[482,3800,1889],{"class":495},[482,3802,3793],{"class":499},[482,3804,3805],{"class":488},"        # Linux\n",[482,3807,3808],{"class":484,"line":940},[482,3809,3810],{"class":488},"# 与 manifest.json 中对应平台的 checksum 比对\n",[195,3812,3813],{},"平台原生代码签名验证：",[473,3815,3817],{"className":475,"code":3816,"language":477,"meta":478,"style":478},"# macOS\ncodesign --verify --verbose .\u002Fclaude\n\n# Windows PowerShell\nGet-AuthenticodeSignature .\\claude.exe\n",[353,3818,3819,3824,3837,3841,3845],{"__ignoreMap":478},[482,3820,3821],{"class":484,"line":485},[482,3822,3823],{"class":488},"# macOS\n",[482,3825,3826,3829,3831,3834],{"class":484,"line":492},[482,3827,3828],{"class":495},"codesign",[482,3830,3765],{"class":499},[482,3832,3833],{"class":499}," --verbose",[482,3835,3836],{"class":499}," .\u002Fclaude\n",[482,3838,3839],{"class":484,"line":564},[482,3840,568],{"emptyLinePlaceholder":567},[482,3842,3843],{"class":484,"line":571},[482,3844,2969],{"class":488},[482,3846,3847,3850,3853,3856],{"class":484,"line":577},[482,3848,3849],{"class":495},"Get-AuthenticodeSignature",[482,3851,3852],{"class":499}," .",[482,3854,3855],{"class":753},"\\c",[482,3857,3858],{"class":499},"laude.exe\n",[199,3860],{},[202,3862,3864],{"id":3863},"十参考来源","十、参考来源",[515,3866,3867,3890,3929,3976],{},[304,3868,3869,3872],{},[307,3870,3871],{},"官方文档",[301,3873,3874,3882],{},[304,3875,3876,3881],{},[1055,3877,3880],{"href":3878,"rel":3879},"https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fsetup",[1059],"Claude Code 官方安装文档 - Advanced setup"," — Anthropic 官方维护的系统要求、安装方式、更新和卸载指南",[304,3883,3884,3889],{},[1055,3885,3888],{"href":3886,"rel":3887},"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@anthropic-ai\u002Fclaude-code",[1059],"@anthropic-ai\u002Fclaude-code - npm"," — npm 包官方页面",[304,3891,3892,3895],{},[307,3893,3894],{},"社区教程",[301,3896,3897,3905,3913,3921],{},[304,3898,3899,3904],{},[1055,3900,3903],{"href":3901,"rel":3902},"https:\u002F\u002Fblog.laozhang.ai\u002Fen\u002Fposts\u002Fhow-to-install-claude-code",[1059],"How to Install Claude Code in 2026 - LaoZhang AI Blog"," — 覆盖六种安装方式的综合指南",[304,3906,3907,3912],{},[1055,3908,3911],{"href":3909,"rel":3910},"https:\u002F\u002Fdev.to\u002Fxujfcn\u002Fclaude-code-installation-guide-for-windows-git-path-environment-variables-powershell-wsl-and-1lag",[1059],"Claude Code Installation Guide for Windows - DEV Community"," — Windows 安装深度指南，含 PATH 和环境变量详解",[304,3914,3915,3920],{},[1055,3916,3919],{"href":3917,"rel":3918},"https:\u002F\u002Fpq.hosting\u002Fen\u002Fhelp\u002Finstall-claude-code-windows",[1059],"Installing Claude Code on Windows - PQ.Hosting"," — Windows 原生安装、WinGet 和 WSL 方案",[304,3922,3923,3928],{},[1055,3924,3927],{"href":3925,"rel":3926},"https:\u002F\u002Fwww.lowtouch.ai\u002Fclaude-code-windows-wsl-setup-guide\u002F",[1059],"How to Set Up Claude Code on Windows Using WSL - lowtouch.ai"," — WSL 完整配置指南",[304,3930,3931,3934],{},[307,3932,3933],{},"国内用户资源",[301,3935,3936,3944,3952,3960,3968],{},[304,3937,3938,3943],{},[1055,3939,3942],{"href":3940,"rel":3941},"https:\u002F\u002Fwww.hoopyai.space\u002Fpost\u002Fclaude-code-china-install",[1059],"中国大陆安装 Claude Code 完全指南 - hoopyAI"," — 不翻墙、零成本的国产模型接入方案",[304,3945,3946,3951],{},[1055,3947,3950],{"href":3948,"rel":3949},"https:\u002F\u002Fblog.csdn.net\u002Fbinbingeee\u002Farticle\u002Fdetails\u002F158964151",[1059],"国内环境下 Claude Code 安装、更新与配置淘宝镜像 - CSDN"," — npm + 淘宝镜像的详细步骤",[304,3953,3954,3959],{},[1055,3955,3958],{"href":3956,"rel":3957},"https:\u002F\u002Fdeveloper.volcengine.com\u002Farticles\u002F7631799708167438355",[1059],"Claude Code 国内直连教程 - 火山引擎开发者社区"," — 含一键配置脚本",[304,3961,3962,3967],{},[1055,3963,3966],{"href":3964,"rel":3965},"https:\u002F\u002Fjuejin.cn\u002Fpost\u002F7572142436127817747",[1059],"国内使用 Claude Code 教程 - 掘金"," — API 中转站配置指南",[304,3969,3970,3975],{},[1055,3971,3974],{"href":3972,"rel":3973},"https:\u002F\u002Fwww.cnblogs.com\u002FComets9224\u002Fp\u002F19535975",[1059],"Claude Code Windows 安装与配置 - 博客园"," — 国内模型避坑指南",[304,3977,3978,3981],{},[307,3979,3980],{},"GitHub 资源",[301,3982,3983,3991],{},[304,3984,3985,3990],{},[1055,3986,3989],{"href":3987,"rel":3988},"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code",[1059],"anthropics\u002Fclaude-code"," — 官方仓库",[304,3992,3993,3998],{},[1055,3994,3997],{"href":3995,"rel":3996},"https:\u002F\u002Fgithub.com\u002Fclaude-code-chinese\u002Fclaude-code-guide",[1059],"claude-code-chinese\u002Fclaude-code-guide"," — 中文社区指南",[4000,4001,4002],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":478,"searchDepth":485,"depth":492,"links":4004},[4005,4011,4017,4023,4028,4033,4037,4043,4044,4045],{"id":204,"depth":492,"text":205,"children":4006},[4007,4008,4009,4010],{"id":209,"depth":564,"text":210},{"id":298,"depth":564,"text":299},{"id":331,"depth":564,"text":332},{"id":372,"depth":564,"text":373},{"id":463,"depth":492,"text":464,"children":4012},[4013,4014,4015,4016],{"id":467,"depth":564,"text":468},{"id":585,"depth":564,"text":586},{"id":660,"depth":564,"text":661},{"id":688,"depth":564,"text":689},{"id":967,"depth":492,"text":968,"children":4018},[4019,4020,4021,4022],{"id":1042,"depth":564,"text":1043},{"id":1202,"depth":564,"text":1203},{"id":1290,"depth":564,"text":1291},{"id":1375,"depth":564,"text":1376},{"id":1518,"depth":492,"text":1519,"children":4024},[4025,4026,4027],{"id":1522,"depth":564,"text":1523},{"id":1551,"depth":564,"text":1552},{"id":1997,"depth":564,"text":1998},{"id":2056,"depth":492,"text":2057,"children":4029},[4030,4031,4032],{"id":2060,"depth":564,"text":2061},{"id":2225,"depth":564,"text":2226},{"id":2435,"depth":564,"text":2436},{"id":2482,"depth":492,"text":2483,"children":4034},[4035,4036],{"id":2486,"depth":564,"text":2487},{"id":2580,"depth":564,"text":2581},{"id":2655,"depth":492,"text":2656,"children":4038},[4039,4040,4041,4042],{"id":2659,"depth":564,"text":2660},{"id":2810,"depth":564,"text":2811},{"id":2923,"depth":564,"text":2924},{"id":3197,"depth":564,"text":3198},{"id":3347,"depth":492,"text":3348},{"id":3485,"depth":492,"text":3486},{"id":3863,"depth":492,"text":3864},"macOS \u002F Windows \u002F Linux","md",null,{"date":4050},"2026-04-26",{"title":42,"description":4046},"twKGm2UNVi-hSZndMiH27aO3zKZIEdWvk9aSlirjrRs",[4054,4055],{"title":31,"path":32,"stem":33,"description":478,"children":-1},{"title":46,"path":47,"stem":48,"description":4056,"children":-1},"Claude Code 的认证体系远比表面上复杂。它同时支持订阅账户（Pro \u002F Max \u002F Team \u002F Enterprise）、Anthropic Console API Key、以及三大云提供商（AWS Bedrock \u002F Google Vertex AI \u002F Microsoft Foundry）三种完全不同的认证路径。每种路径的计费方式、使用限制、适用场景各不相同。本章将系统梳理所有认证方式，帮助你选择最适合自己的方案，并掌握多账户切换、故障排查的实用技巧。",1777395306167]