笑川：完整教程：Claude Code 零门槛安装指南（MiniMax + Switch CC 方案）

笑川：完整教程：Claude Code 零门槛安装指南（MiniMax + Switch CC 方案） 笑川：完整教程：Claude Code 零门槛安装指南（MiniMax + Switch CC 方案） Modified February 25 Code block Plain Text Copy 新增 参数 { "hasCompletedOnboarding": true } 如果发现在mac里找不到 .claude.json 文件，可以同时按 command+shift+. 来打开隐藏文件，然后打开这个文件，再新增下面的内容。 在新增的时候，一定要注意语法错误，每次新增完重新打开，后面的动作都打开不了，或者没有任何的变化，那你直接把相关的错误的内容发给大模型，让大模型帮你修改 这个也是很多新手小白会犯的错误，一定要注意 Code block Plain Text Copy { "hasCompletedOnboarding": true } 第六部分 验证连接 现在验证 Claude Code 是否能通过 Switch CC 连接到 MiniMax。 H3: 6.1 重启终端 重要 ：修改 Switch CC 配置后，需要 重启终端 或重新打开 Claude Code 才能生效。 H3: 6.2 测试连接 在终端中输入： Code block Plain Text Copy claude 如果一切正常，你应该能看到 Claude Code 的欢迎界面。 尝试输入一句话测试： Code block Plain Text Copy 你好，请介绍一下你自己 ⚠️ 坑点预警 ：如果出现以下错误： • API Key 验证失败 ：检查 API Key 是否正确复制 • 连接超时 ：检查网络，或尝试更换网络环境 • model not found ：确认 Model 字段填写正确 第七部分 进阶：多 API 切换 有时候你可能需要同时使用多个 API 服务商。 7.1 添加多个提供商 在 Switch CC 中添加多个 API 提供商： ⚠️ 坑点预警 ：不同提供商的 Model 名称可能不同。比如 MiniMax 用 abab6.5s ，而 OpenAI 用 gpt 4o 。填错了会导致模型找不到的错误。 7.2 快速切换 添加多个提供商后，切换只需： 1. 取消当前启用的提供商 2. 勾选新的提供商 3. 重启终端 第九部分 常见问题汇总 Q1: 安装脚本报错怎么办？ 解决 ：检查网络连接，或使用代理，或手动下载安装包 Q2: API Key 验证失败怎么解决？ 解决 ： 1. 检查 Key 是否复制完整 2. 确认 API Key 是否已启用 3. 尝试重新创建新的 API Key Q3: 连接超时如何排查？ 解决 ： 1. 确认 Switch CC 中的 MiniMax 已启用 2. 重启终端 3. 检查是否有其他代理软件冲突 Q4: 如何切换回官方API？ 解决 ： 1. 在 Switch CC 中取消勾选 MiniMax 2. 重新在环境变量中设置 ANTHROPIC API KEY Q5: 响应慢怎么办？ 解决 ：网络延迟高，建议换用国内 API 或检查网络 总结 恭喜你完成了全部教程！ 你现在已经掌握： 1. ✅ 安装 Claude Code 2. ✅ 注册 MiniMax 账号并获取 API Key 3. ✅ 安装 Switch CC 4. ✅ 配置并验证连接 5. ✅ 进阶：多 API 切换 + MCP 配置 🎉 恭喜你已经成为 Claude Code 玩家！ 如果发现在mac里找不到 .claude.json 文件，可以同时按 command+shift+. 来打开隐藏文件，然后打开这个文件，再新增下面的内容。 在新增的时候，一定要注意语法错误，每次新增完重新打开，后面的动作都打开不了，或者没有任何的变化，那你直接把相关的错误的内容发给大模型，让大模型帮你修改 这个也是很多新手小白会犯的错误，一定要注意 第六部分 验证连接 现在验证 Claude Code 是否能通过 Switch CC 连接到 MiniMax。 H3: 6.1 重启终端 重要 ：修改 Switch CC 配置后，需要 重启终端 或重新打开 Claude Code 才能生效。 H3: 6.2 测试连接 在终端中输入： 如果一切正常，你应该能看到 Claude Code 的欢迎界面。 尝试输入一句话测试： ⚠️ 坑点预警 ：如果出现以下错误： • API Key 验证失败 ：检查 API Key 是否正确复制 • 连接超时 ：检查网络，或尝试更换网络环境 • model not found ：确认 Model 字段填写正确 第七部分 进阶：多 API 切换 有时候你可能需要同时使用多个 API 服务商。 7.1 添加多个提供商 在 Switch CC 中添加多个 API 提供商： ⚠️ 坑点预警 ：不同提供商的 Model 名称可能不同。比如 MiniMax 用 abab6.5s ，而 OpenAI 用 gpt 4o 。填错了会导致模型找不到的错误。 7.2 快速切换 添加多个提供商后，切换只需： 1. 取消当前启用的提供商 2. 勾选新的提供商 3. 重启终端 第九部分 常见问题汇总 Q1: 安装脚本报错怎么办？ 解决 ：检查网络连接，或使用代理，或手动下载安装包 Q2: API Key 验证失败怎么解决？ 解决 ： 1. 检查 Key 是否复制完整 2. 确认 API Key 是否已启用 3. 尝试重新创建新的 API Key Q3: 连接超时如何排查？ 解决 ： 1. 确认 Switch CC 中的 MiniMax 已启用 2. 重启终端 3. 检查是否有其他代理软件冲突 Q4: 如何切换回官方API？ 解决 ： 1. 在 Switch CC 中取消勾选 MiniMax 2. 重新在环境变量中设置 ANTHROPIC API KEY Q5: 响应慢怎么办？ 解决 ：网络延迟高，建议换用国内 API 或检查网络 总结 恭喜你完成了全部教程！ 你现在已经掌握： 1. ✅ 安装 Claude Code 2. ✅ 注册 MiniMax 账号并获取 API Key 3. ✅ 安装 Switch CC 4. ✅ 配置并验证连接 5. ✅ 进阶：多 API 切换 + MCP 配置 🎉 恭喜你已经成为 Claude Code 玩家！ 🔗 原文链接： https://mp.weixin.qq.com/s/3QtI5hk9... https://mp.weixin.qq.com/s/3QtI5hk9... 原创 笑川 AI产品 笑川 AI产品 笑川AI进化论2026年2月25日 12:07 浙江 引言 为什么你需要这篇教程 你是否遇到过这样的情况： • 想用 Claude Code 这个强大的 AI 编程助手 • 结果卡在 Anthropic 账号注册上：要绑卡、要翻墙、还可能触发风控 别慌！ 这篇教程就是为你准备的。 我将教你一种 完全免费 的替代方案：用 Switch CC + MiniMax API 来使用 Claude Code。 为什么选择这个方案？ 1、零成本 MiniMax 赠送免费额度，足够新手玩家日常使用很长时间。 2、国内访问快 MiniMax 是国产 API，不需要翻墙，延迟低，速度稳定。 3、灵活性高 Switch CC 支持多提供商切换，未来想换其他 API 也很方便。 第一部分：整体架构说明 在开始安装之前，先了解一下整个方案的架构： 1. Claude Code ：AI 编程助手客户端 2. Switch CC ：配置管理工具，负责转发请求 3. MiniMax API ：提供 AI 能力的服务商 第二部分 安装 Claude Code Claude Code 支持 macOS、Linux 和 Windows。 2.1 macOS / Linux 安装 打开终端，输入以下命令： 或者使用 Homebrew： 2.2 Windows 安装 打开 PowerShell（不是 CMD），输入： 2.3 验证安装 安装完成后，在终端输入： 如果看到版本号，说明安装成功。 ⚠️ 坑点预警 ：安装脚本可能因为网络问题失败。如果遇到报错，尝试： 1. 检查网络连接 2. 使用代理 3. 或者直接下载官方安装包手动安装 第三部分 获取 MiniMax API 安装好 Claude Code 后，下一步是获取 MiniMax API Key。 3.1 注册 MiniMax 账号 1. 打开浏览器，访问 https://platform.minimaxi.com/ 2. 点击"注册/登录" 3. 使用手机号或邮箱注册 ⚠️ 坑点预警 ：MiniMax 需要 实名认证 ，这是必须完成的步骤。如果不实名，很多功能会受限。 3.2 创建 API Key https://platform.minimaxi.com/user center/basic information/interface key 1. 登录后，在左侧菜单找到 API Keys 2. 点击 创建新的 API Key 3. 给你的 Key 起个名字（比如 "Claude Code"） 4. 点击创建， 立即复制保存 ！这个 Key 只显示一次，丢失就找不回来了 ⚠️ 坑点预警 ： • API Key 创建后立即复制保存，刷新页面就看不到了 • 不要把 Key 泄露给他人 3.3 免费额度说明 MiniMax 新用户有免费额度，具体可以在 账户管理 → 余额 查看。 ⚠️ 坑点预警 ：免费额度用完后需要充值才能继续使用。充值支持支付宝和微信支付。 第四部分 安装 Switch CC Switch CC 是一个桌面端 AI 助手配置管理工具。 4.1 获取安装包 访问 Switch CC 的 GitHub 主页： https://github.com/farion1231/cc switch 根据你的操作系统选择对应的安装包： macOS 安装命令： 或者手动下载： 1. 打开 GitHub Release 页面 2. 下载最新的 cc switch xxx x64.dmg 文件 3. 打开并拖拽到 Applications 文件夹 个人建议直接在终端直接复制黏贴 macOS 安装命令就好了，后面的东西你就一直无脑点点点就好了 Windows 安装： 1. 下载 cc switch xxx x64.msi 2. 双击安装 ⚠️ 坑点预警 ：如果遇到"无法打开，因为来自身份不明的开发者"的提示： • macOS：右键点击应用 → 打开 → 仍要打开 • Windows：忽略安全警告，继续安装 下载完成之后，你就出现了这么一个应用 第五部分 配置 MiniMax 提供商 安装完成后，打开 Switch CC。 关于minimax的配置可以查看官网的开放平台，有很详细的介绍： https://platform.minimaxi.com/docs/coding plan/claude code macos %2F linux 5.1 添加新的提供商 1. 点击界面上的 "Add Provider" 按钮（通常是 + 号图标） 2. 选择默认的MiniMax供应商，并填写您的MiniMax API Key。 配置模型名称将模型名称全部改为 MiniMax M2.5 ，完成后点击右下角的“添加”。 ⚠️ 坑点预警 ： • API Key 是你之前复制的，粘贴时注意不要有多余的空格 5.2 启用配置 添加完成后： 1. 在左侧的提供商列表中，找到 MiniMax 2. 勾选或点击 "Enable" 按钮 3. 界面显示"使用中"状态 5.3.编辑配置文件 编辑或新增 .claude.json 文件 MacOS & Linux 为 /.claude.json Windows 为 用户目录/.claude.json