[claude code] 01 入门篇：安装与基础使用

01 入门篇：安装与基础使用

从零开始，5 分钟上手 Claude Code。

1.1 系统要求

避坑提示：Windows 用户必须安装 Git for Windows，Claude Code 依赖 Git Bash 环境。

1.2 安装方式

方式一：原生安装器（推荐）

这是 Anthropic 官方当前推荐的安装方式，不再依赖 npm。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

macOS 也可用 Homebrew：

brew install claude-code

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows WinGet：

winget install Anthropic.ClaudeCode

卸载：

# macOS / Linux
rm -rf ~/.local/bin/claude ~/.local/share/claude

# Windows：删除以下两个路径
# %USERPROFILE%\.local\bin\claude.exe
# %USERPROFILE%\.local\share\claude

方式二：npm 安装（旧版，仍可用）

npm install -g @anthropic-ai/claude-code
claude --version   # 验证安装
claude update      # 更新到最新版

注意：npm 安装方式会显示迁移警告，建议切换到原生安装器。

方式三：IDE 扩展

VS Code 扩展

1. 在 VS Code 扩展市场搜索 “Claude Code”（发布者：Anthropic）
2. 需要 VS Code 1.98.0+
3. 安装后，打开集成终端，运行 claude
4. 输入 /ide 连接到 IDE
5. 显示绿色 “IDE connected” 表示连接成功
6. 连接后，Claude 修改的文件会在编辑器中显示差异预览

JetBrains 插件

1. 从 JetBrains 市场安装 Claude Code 插件
2. 重启 IDE
3. 在终端中运行 claude，然后输入 /ide 连接

最佳实践：IDE 扩展 + CLI 配合使用效果最佳。CLI 做重活，IDE 扩展做实时预览和审查。

1.3 认证

首次运行 claude 会提示认证，有两种方式：

方式一：Claude 账户登录（OAuth）

• 需要 Claude Pro、Max、Team 或 Enterprise 订阅
• 浏览器自动打开，授权即可
• 适合个人用户

方式二：API 密钥

# 设置环境变量
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 或在配置文件中设置
# ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx"
  }
}

避坑提示：API 密钥按用量计费，建议设置月度预算上限。OAuth 方式包含在订阅中，无需额外付费。

1.4 首次启动

# 进入你的项目目录
cd your-project

# 启动 Claude Code
claude

你会看到 Claude Code 的交互式界面：

╭──────────────────────────────────────╮
│  Claude Code                          │
│  Model: claude-sonnet-4-6            │
│  Context: 0/200k tokens              │
╰──────────────────────────────────────╯

> _

非交互模式（管道模式）

适合脚本和自动化场景：

# 单次提问
claude -p "这个项目用了什么框架？"

# 带上下文管道
cat error.log | claude -p "分析这个错误日志"

# 输出纯文本（无格式）
claude -p "列出所有TODO" --output-format text

1.5 三种权限模式

通过 Shift+Tab 在三种模式间循环切换：

模式切换示意

普通模式 ──Shift+Tab──> 自动接受编辑 ──Shift+Tab──> 计划模式 ──Shift+Tab──> 普通模式

最佳实践：

• 新手从普通模式开始，熟悉 Claude 的行为后再切换
• 日常编码用自动接受编辑，减少确认次数，但命令仍需手动批准
• 大型重构前用计划模式先规划方案，确认后再切换执行

1.6 第一个任务

启动 Claude Code 后，直接用自然语言描述任务：

> 帮我看看这个项目的目录结构，告诉我用了什么技术栈

Claude 会自动：

1. 读取项目文件
2. 分析目录结构
3. 检查依赖配置（package.json、requirements.txt 等）
4. 给出分析结果

常见入门任务

# 代码分析
> 解释一下 src/auth.py 的逻辑

# Bug 修复
> 运行测试，看看哪些失败了，帮我修复

# 代码生成
> 在 src/utils/ 下添加一个日期格式化工具函数

# Git 操作
> 看看最近的提交记录，总结这周做了什么

# 重构
> 把这个函数拆分成更小的函数，提高可读性

1.7 基本交互技巧

确认与拒绝

当 Claude 请求权限时：

中断与取消

多行输入

> Shift+Enter    # 插入新行，继续输入

1.8 小结

下一篇：02 核心篇：高效对话与提示技巧