02. 安装与配置

系统要求

项目最低要求
操作系统macOS 11+、Ubuntu 20.04+、Windows 10+ (WSL2 推荐)
Node.js18.0+
内存8GB+
网络可访问 Anthropic API

安装步骤

macOS / Linux

# 推荐:(国内网络不支持)
curl -fsSL https://claude.ai/install.sh | bash

# 或使用 npm
npm install -g @anthropic-ai/claude-code

Windows

有两种方式:WSL2(推荐,兼容性最好)和原生 Windows。

方式一:WSL2(推荐)

# PowerShell (管理员)
wsl --install -d Ubuntu
# 重启后,在 Ubuntu 终端执行上面的 macOS/Linux 命令

方式二:Windows 原生(直接用 Node + npm)

不通过 WSL,直接在 Windows 上跑 Claude Code。国内网络环境下,claude.ai/install.sh 通常不可用,所以走 npm 路线最稳。

前置准备:

  1. 安装 Node.js 18+(推荐 LTS)

  2. 验证安装(在 PowerShell 或 cmd):

    node --version    # 应输出 v18.x 或更高
npm --version

安装 Claude Code:

# 推荐:用 npm 全局安装
npm install -g @anthropic-ai/claude-code

配置环境变量(如果走国内中转/代理,详见 06. ccswitch 配置国产大模型):

# PowerShell 永久环境变量
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://你的中转地址', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'YOUR_API_KEY', 'User')

# 立即生效:重启终端,或
$env:ANTHROPIC_BASE_URL = "https://你的中转地址"
$env:ANTHROPIC_API_KEY = "YOUR_API_KEY"

验证:

claude --version

Windows 原生常见问题:

问题解决
claude 命令找不到把 npm 全局 bin 目录加到 PATH(默认在 %AppData%\npm)
中文乱码chcp 65001 切到 UTF-8,或终端用 Windows Terminal
路径含空格报错把项目移到无空格路径,如 D:\projects\xxx
Git Bash 跑 Claude Code可以,推荐用 Git Bash 替代 cmd

想用国产大模型替代 Claude 模型 → 继续读 05. 国产大模型简介

验证安装

claude --version
# 输出形如: claude-code 1.x.x

账号与认证

首次运行 claude 会引导你登录:

claude
# 如错误提示，则检查上一步，cc-switch是否正确映射国内模型

常用配置

配置文件位置:~/.claude/settings.json(用户级)或项目内 .claude/settings.json(项目级)。

用户级最小配置

{
  "model": "deepseek-v4-pro",
  "theme": "dark",
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

项目级配置示例(放在 .claude/settings.json)

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run lint)"
    ]
  }
}

推荐目录结构

mkdir -p ~/projects
cd ~/projects
mkdir my-course-assistant
cd my-course-assistant
claude
# 进入交互模式,Claude Code 会自动识别当前目录

IDE 集成(推荐)

Claude Code 除了终端,还提供 TRAE 和 VS Code 等多种IDE集成。装好后在编辑器里可以直接对话、review 改动、@-mention 文件,体验比纯终端更直观。

IDE官方下载地址备注
TRAETRAE 官网直接在 TRAE 内置终端跑 claude CLI
VS CodeVS Code 直接在 TRAE 内置终端跑

完整官方文档:code.claude.com/docs/en/ide-integrations

常见安装问题

claude: command not found

  • 检查 ~/.npm-global/bin 或 ~/.local/bin 是否在 $PATH 中
  • macOS 需注意 ~/.zshrc 中是否有正确的 PATH 配置

API Key 无效

  • 确认 Key 没有多余空格/换行
  • 确认账号余额充足
  • 国内访问可能需要配置代理(请遵守学校相关政策)

如果发生中文乱码【没有发生可不执行，多见于各种版本的Linux】

终端设置 UTF-8:

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

下一步