Mac上安装Claude Code的步骤

发布于:2025-07-23 ⋅ 阅读:(16) ⋅ 点赞:(0)

以下是基于现有信息的简明安装指南,适用于macOS系统。请按照以下步骤操作:

前提条件

  1. 操作系统:macOS 10.15或更高版本。
  2. Node.js和npm:Claude Code基于Node.js,需安装Node.js 18+和npm。请检查是否已安装:
    • 打开终端,运行 node --versionnpm --version
    • 如果未安装,访问 Node.js官方网站 下载并安装最新LTS版本,或使用Homebrew:
      brew install node
      
  3. Anthropic API密钥:需要Anthropic账户和API密钥:
    • 访问 Anthropic官网 创建账户。
    • 在“Settings” > “Billing”中添加支付方式并购买至少5美元的API信用。
    • 在“API Keys”页面点击“Create Key”,保存生成的密钥(仅显示一次,建议存入macOS密码管理器)。

安装步骤

  1. 打开终端

    • 在Mac上,打开“应用程序”文件夹中的“终端”。
  2. 安装Claude Code

    • 在终端中运行以下命令以全局安装Claude Code:
      npm install -g @anthropic-ai/claude-code
      
    • 避免使用 sudo,若遇到权限问题,请检查npm配置(参考Anthropic官方文档)。
  3. 验证安装

    • 安装完成后,运行以下命令检查Claude Code版本:
      claude doctor
      
    • 这将显示安装类型和版本信息。
  4. 认证Claude Code

    • 首次运行 claude 命令时,会提示通过Anthropic Console进行OAuth认证:
      claude
      
    • 按照提示在浏览器中登录Anthropic账户,或输入API密钥。
    • 或者,将API密钥设置为环境变量以实现持久化:
      echo 'export ANTHROPIC_API_KEY=你的API密钥' >> ~/.zshrc
      source ~/.zshrc
      
    • 如果使用bash,替换 ~/.zshrc~/.bashrc
  5. 开始使用

    • 导航到项目目录:
      cd 你的项目目录
      
    • 运行 claude 进入交互模式,开始与Claude Code交互,例如:
      claude > summarize this project's architecture
      

可选:集成开发环境(IDE)

  • VS Code
    • 安装Claude Code的VS Code扩展:
      • Visual Studio Marketplace 下载 .vsix 文件。
      • 在VS Code中:Extensions > More Actions > Install from VSIX,选择下载的文件。
    • 使用 Cmd+Esc 快捷键启动Claude Code,自动获取当前文件上下文。
  • JetBrains
    • 在JetBrains IDE(如PyCharm)中,从JetBrains Marketplace安装Claude Code插件。
    • 在IDE终端中运行 claude,或使用 Cmd+Esc 快捷键。

注意事项

  • 安全性:API密钥需妥善保存,避免泄露。若需撤销,可在Anthropic Console中删除密钥。
  • 费用:Claude Code使用Anthropic API按使用量计费,建议监控使用情况。可考虑Claude Pro($20/月)或Max($100/月)订阅以获得更高配额。
  • 更新:Claude Code会自动检查并安装更新,运行时会显示通知。
  • 问题排查:若遇到安装问题,运行 claude doctor 查看错误,或参考 Anthropic官方文档mac.install.guide

其他建议

  • 推荐安装 Warp TerminalZed Editor,它们与Claude Code兼容,提供AI辅助功能。

网站公告

今日签到

点亮在社区的每一天
去签到