🚀 Claude Code 入门完全指南（一）：安装与首次体验

写在前面

Claude Code 2.1.79 正式发布！这一版本带来了 LSP 集成 、Skills 全面升级 、Sub-Agent 增强等重大更新。今天开始，我们将推出一系列 Claude Code 2.1.79 教程，从小白入门到高手进阶，带你全面掌握这款强大的 AI 编程助手！

---

📦 一、什么是 Claude Code？

Claude Code 是 Anthropic 公司推出的 AI 编程助手，专为开发者设计的 CLI 工具。它不仅能够理解代码、生成代码，还能够：

功能	说明
🔍 智能理解	理解复杂的代码逻辑和架构（LSP 原生支持）
✨ 代码生成	根据需求生成高质量代码
🐛 调试排错	帮助定位和修复 bug
📝 重构优化	提供专业的代码重构建议
🔧 命令行操作	强大的终端集成能力
🤖 Sub-Agent	支持子任务并行处理

一句话概括

Claude Code = 你的私人编程教练 + 代码助手 + 调试专家 + 团队协作工具

---

🖥️ 二、系统要求

在开始安装之前，先确认你的系统环境：

系统	要求
🍎 macOS	10.15+ (Catalina 或更高)
🐧 Linux	Ubuntu 20.04+ / Debian 10+
🪟 Windows	Windows 10+ (原生支持 / WSL / Git Bash)

前置条件

✅ 4 GB RAM 最低要求
✅ 有效的 Anthropic 账户（API Key）
✅ 网络连接（用于认证和 API 调用）

注意

Claude Code 2.1.79 推荐使用原生二进制安装，不再依赖 Node.js！

---

⚡ 三、安装步骤（Claude Code 2.1.79）

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

# macOS 和 Linux
curl -fsSL https://claude.ai/install.sh | bash

# 或者使用 Homebrew
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# 或者使用 winget（Windows）
winget install Anthropic.ClaudeCode

方式二：安装特定版本

# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.79

# 安装最新版本
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell 指定版本
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.79

方式三：NPM 安装（已废弃）

重要提醒

从 v2.1.15 开始，NPM 安装方式已废弃！建议迁移到原生二进制安装。

# 迁移到原生二进制（推荐）
claude install

# 旧版安装（仅用于兼容环境）
npm install -g @anthropic-ai/claude-code

验证安装

# 检查版本（应显示 2.1.x）
claude --version

# 运行诊断
/doctor

# 输出示例：
# Diagnostics
# └ Currently running: unknown (2.1.79)
# └ Path: /Users/shubingsun/.vite-plus/js_runtime/node/24.14.0/bin/node
# └ Invoked:
# /Users/shubingsun/.vite-plus/packages/@anthropic-ai/claude-#code/lib/node_modules/@anthropic-ai/claude-code/cli.js
#  └ Config install method: global
# └ Search: OK (vendor)
# Updates
# └ Auto-updates: enabled
# └ Auto-update channel: latest
# └ Stable version: 2.1.74
# └ Latest version: 2.1.81

---

🔑 四、认证配置

1. API Key 配置

# 方式一：环境变量（推荐）
export ANTHROPIC_API_KEY="your-api-key"

# 方式二：添加到配置文件 ~/.claude.json
cat > ~/.claude.json << 'EOF'
{
  "apiKey": "your-api-key"
}
EOF

2. OAuth 登录（可选）

# 交互式登录
claude auth login

# 查看认证状态
claude auth status

# 退出登录
claude auth logout

# 控制台认证（v2.1.41+）
claude auth login --console

3. 验证配置

# 测试连接
/status

# 输出示例：
#  Version: 2.1.79
#  Session name: /rename to add a name
# Session ID: 413e3828-a7a6-403d-a645-b43b19c7ba35
#  cwd: /Users/shubingsun
#  Auth token: ANTHROPIC_AUTH_TOKEN
#  Anthropic base URL: https://openrouter.ai/api

!success\]\> 配置完成！现在可以开始使用 Claude Code 了。

---

🔮 五、模型选择（Claude Code 2.1.79）

Claude Code 2.1.79 支持多种模型，可以根据需求选择：

支持的模型

模型	适用场景	特点
`claude-sonnet-4-	日常开发（默认）	性价比高，速度快
`claude-opus-4-5	复杂推理任务	最强能力，适合难题
`claude-3-5-sonnet	平衡性能与成本	稳定可靠
`claude-3-haiku	简单任务	最快最便宜
opus-4-6	超长上下文	支持 1M token 上下文

切换模型

# 方式一：命令行指定模型
claude --model opus-4-6 "帮我分析这个大型项目"

# 方式二：配置默认模型
export ANTHROPIC_DEFAULT_MODEL="claude-opus-4-5-20251120"

# 方式三：在对话中切换
claude
> /module opus-4-6
> 帮我解决这个复杂的算法问题

配置文件方式

# macOS/Linux
cat > ~/.claude.json << 'EOF'
{
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 8192,
  "temperature": 1
}
EOF

模型选择建议

• 简单任务（写函数、修 bug）：用 Haiku 或 Sonnet
• 复杂任务（架构设计、深度调试）：用 Opus
• 超长上下文（分析大型代码库）：用 Opus 4.6
• 日常开发：默认 Sonnet 性价比最高

---

⌨️ 六、常用命令详解（Claude Code 2.1.79）

基础命令

命令	功能
claude	启动交互式会话
claude --version	查看版本号
claude --help	显示帮助信息
claude -n <name>	设置会话名称

会话管理

命令	功能
claude --resume	恢复之前的会话
claude --continue	从上次继续
/rename	重命名当前会话

---

🎯 七、对话内命令（/xxx）

在 Claude Code 2.1.79 交互式会话中，可以使用以下命令：

常用命令

命令	功能	示例
/module <model>	切换使用的模型	/module opus-4-6
/help	显示帮助	/help
/exit（quit）	退出当前会话	/exit /quit
/clear	清除对话历史	/clear
/compact	压缩上下文，释放空间	/compact
/context	查看当前上下文状态	/context
/resume	恢复之前的工作	/resume
/effort	设置任务努力级别	/effort high
/plan	进入计划模式	/plan
/branch	创建分支会话	/branch
/mcp	MCP 服务器管理	/mcp list
/skills	查看 Skills 列表	/skills
/agents	列出配置的代理	/agents
/plugin	插件管理	/plugin install
/config	配置设置	/config
/copy	复制输出	/copy
/doctor	运行诊断	/doctor

新增命令（v2.1+）

命令	功能	版本
/btw	侧边问题回答	v2.1.78+

快捷键

快捷键	功能
Shift+Enter	换行输入（终于支持了！）
Ctrl+B	后台化 agent 或 shell 命令
Escape	中止请求

---

🚀 八、首次体验

启动 Claude Code

# 交互式模式（推荐新手）
claude

# 指定项目目录
claude /path/to/your/project

# 单次对话模式
claude "请帮我写一个 Hello World 程序"

第一次对话示例

$ claude

👋 欢迎使用 Claude Code v2.1.79！
当前模型: claude-sonnet-4-20250514

请告诉我你想做什么：
> 请帮我创建一个 Python 计算器程序

🤖 好的，我会帮你创建一个简单的计算器程序。
让我先确认一下项目目录...

✅ 已创建文件：calculator.py
✅ 代码功能：
  • 加减乘除运算
  • 错误处理
  • 用户友好的交互界面

你可以运行命令：
python calculator.py

---

🛠️ 九、与编辑器集成

VS Code 集成 (Claude Code for VS Code插件)

Neovim 集成

# 使用 vim-plug 安装
Plug 'anthropic/claude-code.nvim'

# 或使用 packer
use 'anthropic/claude-code.nvim'

Zed 编辑器支持

新增支持

Claude Code 2.1.79 原生支持 Zed 编辑器！

---

📝 十、常见问题

Q1：免费版本有使用限制吗？

A：Claude Code 需要 API Key，会根据你的 Anthropic 套餐产生费用。新用户通常有免费额度。

Q2：访问国外 API 速度慢怎么办？

A：可以配置代理或使用国内的 API 代理服务：

export ANTHROPIC_BASE_URL="https://api.proxy.com/v1"

Q3：如何更新到最新版本？

A：

# 自动更新
claude update

# 或手动更新
curl -fsSL https://claude.ai/install.sh | bash

Q4：NPM 安装方式还能用吗？

A：从 v2.1.15 开始已废弃，建议使用 claude install 迁移到原生二进制。

---

🎉 总结

内容	重点
安装方式	`curl -fsSL https://claude.ai/install.sh
认证	claude auth login 或 API Key
首次使用	claude 启动交互式会话
新版本	Claude Code 2.1.79
学习路径	基础 → 进阶 → 高级

---

!success\]\> **下期预告** 第二篇我们将讲解 **基础对话与提示词技巧**，教你如何与 Claude Code 2.1.79 高效沟通！ 敬请期待！