如果你听说过 Claude Code，但被那些黑漆漆的命令行（Terminal）挡住了去路，这份文档就是为你准备的。我们不仅教你如何安装，更要把你可能踩到的“权限、网络、路径”大坑提前填平。
第一步：安装必备软件
1、安装 vs code
Visual 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?itemName=anthropic.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 里的两个勾选项有没有漏掉。
