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

智编小酒馆
0 阅读6分钟

写在前面

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 = 你的私人编程教练 + 代码助手 + 调试专家 + 团队协作工具

🖥️ 二、系统要求

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

系统要求
🍎 macOS10.15+ (Catalina 或更高)
🐧 LinuxUbuntu 20.04+ / Debian 10+
🪟 WindowsWindows 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>设置会话名称

image.png

会话管理

命令功能
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
/mcpMCP 服务器管理/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插件)

image.png

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 | bash
认证claude auth login 或 API Key
首次使用claude 启动交互式会话
新版本Claude Code 2.1.79
学习路径基础 → 进阶 → 高级

[!success]>
下期预告

第二篇我们将讲解 基础对话与提示词技巧，教你如何与 Claude Code 2.1.79 高效沟通！

敬请期待！

avatar
文章
阅读
粉丝