Claude Code安装教程 2026最新版详细步骤

2026-05-29阅读 0热度 0

Claude

当下AI编程辅助工具迭代迅速，从VS Code的Copilot到独立编辑器Cursor，我最近聚焦在Claude Code上。不过网上流传的教程往往滞后——Claude Code月月更新，加上国内网络环境特殊，实际配置中会踩不少坑。

本文基于2026年4月的实际安装经验整理，供开发者参考。请注意工具版本可能快速迭代，后续步骤需以官方最新文档为准。

安装

直接参考官方文档安装（镜像地址：code.claude.com/docs/zh-CN/…，需代理）。实测香港节点安装失败，切换至新加坡节点后成功。完成后终端运行 claude -v 验证版本号，输出正常即安装就绪。

先别急着运行

如果此时直接输入 claude 启动，会要求登录Claude官方账号——需要海外手机号且极易封号。国内环境走通这一步极麻烦，建议按 Ctrl + C 退出，后续有替代方案。

注册 MiniMax

Claude Code默认调用官方Claude API，国内网络无法直连。好在可以替换为国产大模型。众多博主推荐MiniMax，我实测可行，官方提供了详尽对接教程（platform.minimaxi.com/docs/token-…）。注册并完成实名认证后，平台赠送15元体验金，足够跑通基础流程。创建并复制API Key（注意保密）。

安装 cc-switch

将MiniMax的接口和密钥注入Claude Code，官方推荐使用cc-switch工具。安装后运行cc-switch，选择模型为MiniMax即可（也支持其他国产模型）。

启动

启动前，编辑本地 ~/.claude.json 配置文件，添加参数 "hasCompletedOnboarding": true 以绕过区域限制。然后在目标文件夹下执行 claude，此时无需登录。系统会询问是否信任该目录，回车确认即可进入交互。

创建一个项目

我在空文件夹中运行 claude，被询问创建什么项目。简单输入「用 Next.js 创建一个 Todo-List Web App」，未附加任何额外要求——仅测试完整流程。它先生成规格文档列出常见需求，然后开始创建。随后持续提示我执行各类命令，我一路回车确认。最终项目成功运行，默认页面效果令人满意。

测试网络情况

将代理节点切回香港，再次启动也能正常使用，但响应延迟明显——推测是免费模型所致。

安装 VS Code 插件

Claude Code默认在终端中运行，在大项目中浏览文件目录和代码较为不便。可在VS Code中安装Claude Code插件，并修改配置，将模型指定为 minimax-m2.7：

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.selectedModel": "minimax-m2.7",
  "claudeCode.environmentVariables": []
}

用VS Code打开刚才的项目，右侧即出现Claude Code聊天面板。

本次费用

查看MiniMax控制台：初始余额15元，目前剩余14.34元，整个Todo-List项目仅花费不到0.7元。如果全天持续使用，费用可自行推算。MiniMax在同类产品中性价比突出——当然，并非最贵的那一档。

后续我会继续用Claude Code推进项目，届时再分享更多实用技巧。