Shell / BashNode.jsAI
Claude Code macOS 安装与配置指南
在 macOS 系统上安装和配置 Claude Code 命令行工具的完整流程。内容包括安装 Node.js 环境、通过 npm 全局安装 Claude Code、配置 API 密钥及环境变量、以及基本的使用方法和常见问题的解决方案。适用于希望利用 AI 辅助编程的开发人员。
在 macOS 系统上安装和配置 Claude Code 命令行工具的完整流程。内容包括安装 Node.js 环境、通过 npm 全局安装 Claude Code、配置 API 密钥及环境变量、以及基本的使用方法和常见问题的解决方案。适用于希望利用 AI 辅助编程的开发人员。
Claude Code 需要 Node.js 环境才能运行。
如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node
如果尚未安装 Homebrew：
访问 https://brew.sh/ 或在终端运行以下命令安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
https://nodejs.org/.pkg 文件安装完成后，打开终端（Terminal 或 iTerm2），输入以下命令：
node --version
npm --version
如果显示版本号，说明安装成功了！
macOS 注意事项：
sudo 命令打开终端，运行以下命令：
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果遇到权限问题，可以使用 sudo：
sudo npm install -g @anthropic-ai/claude-code
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
安装完成后，输入以下命令检查是否安装成功：
claude --version
如果显示版本号，恭喜你！Claude Code 已经成功安装了。
提示：
注册相应的 AI 服务账号，并在控制台创建新的 API 密钥。
登录控制台，在 API 密钥页面创建一个新的密钥。
为了让 Claude Code 连接到服务，需要设置环境变量。
macOS Catalina (10.15) 及更高版本默认使用 zsh，而较早版本使用 bash。
检查当前 shell：
echo $SHELL
/bin/zsh，使用 zsh 配置方法/bin/bash，使用 bash 配置方法在终端中运行以下命令：
export ANTHROPIC_API_KEY="你的 API 密钥"
注意：这种方式只在当前终端会话有效，关闭终端后需要重新设置。
对于 zsh（macOS Catalina 及更高版本）：
# 编辑 .zshrc 文件
echo 'export ANTHROPIC_API_KEY="你的 API 密钥"' >> ~/.zshrc
# 重新加载配置
source ~/.zshrc
对于 bash（较早版本 macOS）：
# 编辑 .bash_profile 文件
echo 'export ANTHROPIC_API_KEY="你的 API 密钥"' >> ~/.bash_profile
# 重新加载配置
source ~/.bash_profile
你也可以使用文本编辑器手动编辑配置文件：
对于 zsh：
# 使用 nano 编辑器
nano ~/.zshrc
# 或使用 vim 编辑器
vim ~/.zshrc
对于 bash：
# 使用 nano 编辑器
nano ~/.bash_profile
# 或使用 vim 编辑器
vim ~/.bash_profile
在文件末尾添加以下内容：
export ANTHROPIC_API_KEY="你的 API 密钥"
保存文件后，重新加载配置：
# zsh
source ~/.zshrc
# bash
source ~/.bash_profile
设置完环境变量后，可以通过以下命令验证是否设置成功：
echo $ANTHROPIC_API_KEY
预期输出示例：
sk-xxxxxxxxxxxxxxxxxx
如果输出为空，说明环境变量设置失败，请检查配置文件并重新加载。
现在你可以开始使用 Claude Code 了！
claude
# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude
这通常是权限问题，尝试以下解决方法：
方法一：使用 sudo
sudo npm install -g @anthropic-ai/claude-code
方法二：配置 npm 使用用户目录
# 创建全局安装目录
mkdir ~/.npm-global
# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'
# 将路径添加到 shell 配置文件
# zsh
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
# bash
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
如果系统提示 "无法打开，因为无法验证开发者"：
# 临时允许所有来源（不推荐）
sudo spctl --master-disable
# 使用完后建议恢复
sudo spctl --master-enable
检查以下几点：
~/.zshrc~/.bash_profile# zsh
source ~/.zshrc
# bash
source ~/.bash_profile
echo $ANTHROPIC_API_KEY
如果 Homebrew 安装很慢，可以尝试更换镜像源。
如果你使用的是搭载 Apple Silicon 的 Mac：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online