Claude Code macOS 安装指南
专为 macOS 用户设计的 Claude Code 详细安装教程。
第一步:安装 Node.js
Claude Code 需要 Node.js 运行环境,请参考详细的安装指南:
👉 Node.js 安装指南 - macOS 部分 - 包含 Homebrew 和官网下载两种方法
ℹ️
安装完成后请返回此页面继续后续步骤。
第二步:安装 Claude Code
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
安装完成后验证:
# 检查 Claude Code 版本
claude --version
第三步:配置环境变量
临时设置(当前终端会话)
export ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
永久设置
如果使用 Zsh(macOS 默认)
# 添加到 .zshrc 文件
echo 'export ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
# 重新加载配置
source ~/.zshrc
如果使用 Bash
# 添加到 .bash_profile 文件
echo 'export ANTHROPIC_BASE_URL="https://cc.aihezu.dev/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
# 重新加载配置
source ~/.bash_profile
🔐
重要:请将实际的代理地址和API密钥替换到配置中,我们会在购买服务后提供这些信息。
第四步:验证安装
检查环境变量
# 检查环境变量是否设置正确
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
测试 Claude Code
# 测试基本功能
claude "Hello, Claude!"
成功的话,你会看到 Claude 的回复。
第五步:VS Code 集成
详细的 VS Code 集成配置请参考:
👉 VS Code 集成指南 - 完整的编辑器集成教程
🔧 高级配置
创建配置文件
# 创建 Claude 配置目录
mkdir -p ~/.claude
# 创建配置文件
cat > ~/.claude/config.json << EOF
{
"editor": "vscode",
"theme": "auto",
"autoSave": true,
"maxTokens": 4096,
"suggestions": {
"enabled": true,
"maxSuggestions": 5
}
}
EOF
设置代理(如需要)
# 设置 HTTP 代理
claude config set proxy.http http://proxy.example.com:8080
# 设置 HTTPS 代理
claude config set proxy.https https://proxy.example.com:8080
故障排除
遇到安装或使用问题?查看详细的解决方案:
👉 故障排除指南 - 全面的问题诊断和解决方案
🗑️ 卸载指南
如需卸载 Claude Code,请参考:
👉 卸载指南 - 完整的卸载和清理说明
第一个项目
创建测试项目
# 创建新目录
mkdir ~/my-first-claude-project
cd ~/my-first-claude-project
# 初始化项目
claude init
# 开始对话
claude "帮我创建一个 Python Hello World 程序"
在 VS Code 中使用
详细的 VS Code 使用请参考 VS Code 集成指南
获取支持
遇到问题?我们提供专业技术支持:
🎉
恭喜! 你已在 macOS 上成功安装 Claude Code,现在可以开始 AI 辅助编程了!
📚 相关文档
- 快速开始 - 学习基本使用流程
- VS Code 集成 - 编辑器集成配置
- 故障排除 - 解决常见问题
- 卸载指南 - 完整卸载说明
- 选择套餐 - 了解服务套餐