AI 编程工具的选择,最近真是越来越有意思了。最开始我习惯用 VS Code 的 Copilot,后来换了 Cursor,最近又开始琢磨 Claude Code。只不过,网上能找到的教程大多已经过时了——这工具更新速度太快,几个月就大变样,再加上国内网络的限制,配置起来确实有不少坑。
这里记录一下 2026 年 4 月的安装流程,供需要的朋友参考。注意时效性,后续工具更新后可能有些步骤就不适用了。
安装
参照官方文档安装即可,地址是 code.claude.com/docs/zh-CN/…(需要梯子)。我试过用香港节点运行不成功,切换到新加坡节点才安装好。安装完成后,在控制台执行 claude -v 查看版本号,如果显示正常,就说明安装成功了。
先别急着运行
如果你这时候直接执行 claude 启动,它会要求你登录 Claude 官方账号——需要国外手机号,而且很容易被封禁。国内环境跑通这一步相当麻烦,所以到这一步可以按 ctrl + c 退出来,我们后面有办法绕过。
注册 MiniMax
Claude Code 默认走的是官方的 Claude 大模型接口,国内用不了。好在可以配置成国内大模型。不少博主推荐 MiniMax,我跟着试了一下,确实好用,因为官方有非常详细的对接教程(platform.minimaxi.com/docs/token-…)。注册后实名认证,平台会赠送 15 元额度,足够跑通基本流程。创建一个 API Key 并复制下来(注意不要泄露)。
安装 cc-switch
要把 MiniMax 的接口和 API Key 配置到 Claude Code,官方文档推荐使用 cc-switch 这个工具。安装后运行 cc-switch,把模型切换为 MiniMax 即可(其他大模型也支持)。
启动
启动之前,打开本地 ~/.claude.json 配置文件,增加一个参数 "hasCompletedOnboarding": true,用来绕过 Claude Code 的区域限制。然后在控制台选择一个文件夹,执行 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 做项目,后续再分享一些使用技巧。
