Claude Code 深度安装与避坑指南（小白级实操版）

如果你听说过 Claude Code但被那些黑漆漆的命令行Terminal挡住了去路这份文档就是为你准备的。我们不仅教你如何安装更要把你可能踩到的“权限、网络、路径”大坑提前填平。第一步安装必备软件1、安装 vs codeVisual Studio Code简称VS Code是由微软开发的一个现代化、轻量级的代码编辑器它支持几十种主流编程语言如 JavaScript、Python、C、Java、Go 等并通过扩展提供更广泛的语言支持。VSCode 可以在 Windows、macOS 和 Linux 操作系统上运行为开发者提供了一个统一的开发环境。VSCode 因其强大的功能和灵活性已经成为全球开发者广泛使用的代码编辑器之一。点击下方链接下载https://code.visualstudio.com/2、安装 claude code 插件ClaudeCode是由Anthropic开发的全新终端AI编程工具旨在通过自然语言指令帮助开发者高效率地完成代码编写、调试和项目管理任务。它直接集成在开发者的工作环境如终端中无需依赖额外服务器或复杂配置即可运行。在实际的使用过程中Claude Code是一个比较通用的智能体他输出的代码也比cursor简练很多更像是一个熟悉整个项目的高级程序员研究和学习这个框架对于开发自己的Agent至关重要。点击下方链接下载会自动跳转到 vs code 安装https://marketplace.visualstudio.com/items?itemNameanthropic.claude-code或者在 vs code 插件市场搜索Claude code也可第二步配置账号别被 Claude Code 这个名字吓到。它本质上只是个“容器”大模型才是真正干活的那位。问题出在官方——只要你顶着中国身份封你没商量。所以现实的选择就两个中转麻烦一点但效果能打国产模型够用省心不用折腾账号。不想被封号、不想搞梯子用中转。1、推荐 hongmacc支持订阅套餐按量购买比较灵活HongMaCC - 企业级 AI API 中转平台 | Claude Code 国内直连服务它的作用就是替你请求 Claude 官方你只管用不用管账号和网络。点击创建账户创建完成登录进去你会看到这样的界面进入产品中心你会看到有很多套餐可以先买个¥9.9的体验一下买完后点击API 密钥你会看到你的API key要保管好2、智谱AI注册、实名认证后会送点token智谱AI开放平台登录后点击API Key就可以看到自己的api key了第三步在 Claude Code 里配置账号配置账号这一步推荐用工具来搞定省去手写配置文件的麻烦。方案一使用 cc-switch推荐cc-switch是一个专门用来配置 Claude Code API Key、切换和管理配置的工具用起来很方便。cc-switch这里是GitHub打不开的话就要科学上网了https://github.com/farion1231/cc-switch找到Releases下载打开链接往下滑https://github.com/farion1231/cc-switch/releases注意由于作者没有苹果开发者账号首次打开可能出现未知开发者警告请先关闭然后前往系统设置 → 隐私与安全性 → 点击仍要打开之后便可以正常打开。第四步配置cc-switch点击右上角「新建」选择「自定义配置」供应商名字随便填自己认识就行填入两样东西API Key就是你之前购买账号时拿到的 API 密钥请求地址服务商给你的地址例如https://hongmacc.com/apihttps://4api.top具体以你买的那家服务商提供的配置文档为准点击「保存」搞定在 cc-switch 里勾选两项✅「应用到 Claude code 插件」✅「跳过初次安装确认」重新启动 VS Code完成。第五步如何判断账号是否配置成功配置完成后验证方法很简单点开Claude Code 插件随便跟它说句话比如 hello如果它能正常回应你→ ✅ 配置成功可以开始用了如果报错或不响应→ 回头检查一下 API Key 和请求地址是否填对或者看看 cc-switch 里的两个勾选项有没有漏掉。