​
系统要求

  • 操作系统: macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或通过 WSL 的 Windows
  • 硬件: 最少 4GB RAM
  • 软件:
    • Node.js 18+
    • git 2.23+（可选）
    • GitHub 或 GitLab CLI 用于 PR 工作流（可选）
  • 网络: 需要互联网连接进行认证和 AI 处理
  • 地区: 仅在支持的国家可用

​
安装和认证

1

安装 Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

导航到您的项目

cd your-project-directory
3

启动 Claude Code

claude
4

完成认证

Claude Code 提供多种认证选项：

  1. Anthropic Console: 默认选项。通过 Anthropic Console 连接并 完成 OAuth 流程。需要在 console.anthropic.com 激活计费。
  2. Claude App（Pro 或 Max 计划）: 订阅 Claude 的 Pro 或 Max 计划，获得包含 Claude Code 和网页界面的统一订阅。以相同价格获得更多价值，同时在一个地方管理您的账户。使用您的 Claude.ai 账户登录。在启动期间，选择与您的订阅类型匹配的选项。
  3. 企业平台: 配置 Claude Code 使用 Amazon Bedrock 或 Google Vertex AI 进行企业部署，使用您现有的云基础设施。

​
初始化您的项目

对于首次使用的用户，我们建议：

1

启动 Claude Code

claude
2

运行一个简单命令

> summarize this project
3

生成 CLAUDE.md 项目指南

/init
4

提交生成的 CLAUDE.md 文件

要求 Claude 将生成的 CLAUDE.md 文件提交到您的仓库。

​
故障排除

​
WSL 安装故障排除

目前，Claude Code 不能直接在 Windows 中运行，而是需要 WSL。

您可能在 WSL 中遇到以下问题：

操作系统/平台检测问题: 如果您在安装过程中收到错误，WSL 可能正在使用 Windows npm。尝试：

  • 在安装前运行 npm config set os linux
  • 使用 npm install -g @anthropic-ai/claude-code --force --no-os-check 安装（不要使用 sudo）

找不到 Node 错误: 如果您在运行 claude 时看到 exec: node: not found，您的 WSL 环境可能正在使用 Windows 安装的 Node.js。您可以通过 which npm 和 which node 确认这一点，它们应该指向以 /usr/ 开头的 Linux 路径，而不是 /mnt/c/。要解决这个问题，请尝试通过您的 Linux 发行版的包管理器或通过 nvm 安装 Node。

​
优化您的终端设置

Claude Code 在您的终端正确配置时效果最佳。遵循这些指南来优化您的体验。

支持的 shell:

  • Bash
  • Zsh
  • Fish

​
主题和外观

Claude 无法控制您终端的主题。这由您的终端应用程序处理。您可以在入门时或通过 /config 命令随时将 Claude Code 的主题与您的终端匹配

​
换行

您有几个选项可以在 Claude Code 中输入换行：

  • 快速转义: 输入 \ 然后按 Enter 创建新行
  • 键盘快捷键: 通过适当配置按 Option+Enter（Meta+Enter）

在您的终端中设置 Option+Enter：

对于 Mac Terminal.app:

  1. 打开设置 → 配置文件 → 键盘
  2. 勾选”使用 Option 作为 Meta 键”

对于 iTerm2 和 VSCode 终端:

  1. 打开设置 → 配置文件 → 键
  2. 在常规下，将左/右 Option 键设置为”Esc+”

iTerm2 和 VSCode 用户提示: 在 Claude Code 中运行 /terminal-setup 以自动配置 Shift+Enter 作为更直观的替代方案。

​
通知设置

通过适当的通知配置，永远不会错过 Claude 完成任务的时机：

​
终端铃声通知

在任务完成时启用声音警报：

claude config set --global preferredNotifChannel terminal_bell

对于 macOS 用户: 不要忘记在系统设置 → 通知 → [您的终端应用] 中启用通知权限。

​
iTerm 2 系统通知

对于任务完成时的 iTerm 2 警报：

  1. 打开 iTerm 2 偏好设置
  2. 导航到配置文件 → 终端
  3. 启用”静音铃声”和过滤器警报 → “发送转义序列生成的警报”
  4. 设置您首选的通知延迟

请注意，这些通知特定于 iTerm 2，在默认的 macOS 终端中不可用。

​
处理大型输入

在处理大量代码或长指令时：

  • 避免直接粘贴: Claude Code 可能难以处理非常长的粘贴内容
  • 使用基于文件的工作流: 将内容写入文件并要求 Claude 读取它
  • 注意 VS Code 限制: VS Code 终端特别容易截断长粘贴

​
Vim 模式

Claude Code 支持 Vim 键绑定的子集，可以通过 /vim 启用或通过 /config 配置。

支持的子集包括：

  • 模式切换: Esc（到 NORMAL）、i/I、a/A、o/O（到 INSERT）
  • 导航: h/j/k/l、w/e/b、0/$/^、gg/G
  • 编辑: x、dw/de/db/dd/D、cw/ce/cb/cc/C、.（重复）