Mac安装Claude Code完整指南：3分钟搞定AI开发环境

想在Mac上跑Claude Code，结果被各种环境配置搞得头大？别慌，这篇教程把整个流程拆成几步，跟着做就行。

准备工作：获取API密钥

在正式安装之前，你需要先拿到一个可用的API Key。

👉 注册AICodeMirror获取Claude Code API密钥

完成注册后，进入仪表板的「API密钥」页面，创建一个新的API密钥。这里有个坑要注意：密钥只在创建时显示一次，关掉弹窗就看不到了，务必先复制保存好。

开始安装Claude Code

Claude Code原生支持macOS 10.15及以上系统，整个安装过程相当丝滑。

第一步：环境检查

打开终端，先跑一下环境检查脚本：

bash
curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash

第二步：清理旧版本（可选）

如果你之前装过其他版本的Claude Code，建议先卸载干净：

bash
npm uninstall -g @anthropic-ai/claude-code

没装过的话直接跳过这步。

第三步：安装官方包

执行安装命令：

bash
npm install -g @anthropic-ai/claude-code

等进度条跑完就行。

第四步：配置API Key

把之前保存的API密钥填进去：

bash
curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的API_KEY"

注意把引号里的内容换成你自己的密钥。

验证安装是否成功

这步很关键——一定要重启终端，不然环境变量不会生效。

重启后输入：

bash
claude -v

如果能看到版本号输出（比如1.0.83），说明安装成功了。

实际使用

安装完成后，在任何项目目录里都能用。操作很简单：

1. 先cd到你的项目目录

2. 输入claude启动

看到"Welcome to Claude Code"的欢迎界面，就可以开始敲代码了。

说到这里，如果你平时需要频繁调用Claude的API做开发， 👉 AICodeMirror提供了更稳定的国内访问方案，省去折腾网络的麻烦。

常见问题速查

Q：安装时报权限错误怎么办？

试试在命令前加sudo，或者检查npm的全局安装路径权限。

Q：重启终端后claude -v还是提示命令不存在？

可能是环境变量没配置对，重新跑一遍环境配置脚本。

Q：之前装过其他版本，现在各种报错？

先彻底卸载旧版本，确认npm list -g里没有claude相关的包了，再重新安装。

整个流程顺利的话，3分钟内就能把环境跑起来。遇到其他问题欢迎留言交流。