Claude Code Mac使用指南#
(一) 安装 Node.js 环境#
Claude Code 需要 Node.js 环境才能运行。#
macOS 安装方法#
方法一:使用 Homebrew(推荐)#
如果你已经安装了 Homebrew,使用它安装 Node.js 会更方便:方法二:官网下载#
macOS 注意事项#
验证安装是否成功#
安装完成后,打开 Terminal,输入以下命令:#
如果显示版本号,说明安装成功了!#
(二) 安装 Claude Code#
安装 Claude Code#
打开 Terminal,运行以下命令:#
如果遇到权限问题,可以使用 sudo:#
验证 Claude Code 安装#
安装完成后,输入以下命令检查是否安装成功:#
如果显示版本号,恭喜你!Claude Code 已经成功安装了。#
(三) 设置环境变量#
配置 Claude Code 环境变量#
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:#
方法一:临时设置(当前会话)#
在 Terminal 中运行以下命令:#
记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二:永久设置#
编辑你的 shell 配置文件(根据你使用的 shell):#
对于 zsh (默认):#
对于 bash:#
(四) 开始使用 Claude Code#
现在 你可以开始使用 Claude Code 了!#
启动 Claude Code#
在特定项目中使用#
(五) macOS 常见问题解决#
安装时提示权限错误#
尝试以下解决方法:#
macOS 安全设置阻止运行#
如果系统阻止运行 Claude Code:#
或者在 Terminal 中运行:sudo spctl --master-disable
环境变量不生效#
检查以下几点:#
确认修改了正确的配置文件(.zshrc 或 .bash_profile)
验证设置:echo $ANTHROPIC_BASE_URL
你已经成功安装并配置了 Claude Code,现在可以开始享受 AI 编程助手带来的便利了。如果在使用过程中遇到任何问题,可以查看官方文档或社区讨论获取帮助。