教程

Claude Code 新手入门完整教程:安装、登录、第一个任务全流程(2026 最新)

Claude Code 新手入门完整教程:从安装到第一个任务全流程,涵盖 macOS/Windows/Linux 安装、常见报错处理、核心命令速查和 5 个高频使用场景。

2026/4/93分钟 阅读ClaudeEagle

很多人第一次听说 Claude Code,都有这样的疑问:它是网页版 Claude 吗?需要会编程才能用吗?

都不是。Claude Code 是一个跑在终端(命令行)里的 AI 编程助手,你用自然语言告诉它做什么,它就直接读你的代码、写代码、运行命令。不需要切换窗口,不需要复制粘贴。


第一步:安装

macOS / Linux / WSL

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

安装后输入 claude --version 验证。

Windows(PowerShell)

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

Windows 用户需先安装 Git for Windows

Homebrew(macOS)

bash
brew install --cask claude-code

安装失败速查

报错解决
command not found: claude重启终端,或 source ~/.zshrc
安装脚本返回 HTML挂代理或改用 Homebrew
TLS 错误检查代理设置
Windows && 不识别你在 PowerShell,用 PowerShell 命令

第二步:登录

首次运行 claude 会提示登录:

bash
claude
# 按提示在浏览器完成登录

支持:Claude Pro/Max/Team/Enterprise、Console API、AWS Bedrock / GCP Vertex / Azure。


第三步:进入项目开始使用

bash
cd /path/to/your/project
claude

直接用中文告诉它要做什么:

text
这个项目是做什么的?
帮我修 src/auth.ts 里 token 刷新后返回 401 的 bug
给 calculator.py 的函数写单元测试

核心命令速查

命令作用
claude进入交互模式
claude "任务"直接执行一次性任务
claude -c继续上次对话
/compact压缩对话(省 Token)
/model切换模型
Shift+Tab切换权限模式
Ctrl+D退出

5 个高频场景

修 bug有个 bug:用户提交空表单不报错,帮我修一下

Code Reviewreview 我最近的改动,看看有没有问题

提交代码把我的改动提交,写一个描述性的 commit message

写测试给 calculator.py 里的函数写单元测试

更新文档根据当前代码更新 README 的安装说明


新手最容易犯的 3 个错误

1. 提示太模糊:「修一下 bug」不如「修 src/auth.ts 里 token 刷新返回 401 的 bug」。

2. 对话太长不 /compact:长对话又贵又慢,一个任务完成就 /compact

3. 把它当聊天用:Claude Code 最强的是直接操作代码库,要多说「帮我做 XX」。


来源:Claude Code 官方 Quickstart | 整理:ClaudeEagle

相关文章推荐

教程Claude Code Plan Mode 深度解析:让 AI 先想清楚再动手,避免改代码越改越乱Claude Code Plan Mode 深度解析:进入只读分析模式,让 AI 先制定完整方案再动手,彻底解决「越改越乱」。含典型工作流、4 大使用价值和场景判断。2026/4/9教程Claude Code GitHub Actions 实战:用 @claude 让 AI 自动修 bug、实现功能、生成 PRClaude Code GitHub Actions 实战教程:配置 @claude 命令触发 AI 自动修 bug、实现功能、生成 PR。含 2 步快速配置、3 个工作流示例、安全设置和常见问题排查。2026/4/9教程Claude Code Linux 安装完整指南:Ubuntu/Debian/CentOS/Arch 全平台覆盖Claude Code 在 Linux 各发行版的完整安装教程:Ubuntu 22.04/24.04、Debian、CentOS/RHEL、Arch Linux 安装步骤,Node.js 版本要求,权限配置,WSL2 特殊处理,无 GUI 服务器部署,以及 Linux 下常见安装报错解决方案。2026/3/16教程Claude Code Windows 安装完全指南:原生安装、WSL2 和 PowerShell 三种方式Claude Code Windows 完整安装教程:PowerShell 原生安装、WinGet 安装、WSL2 Ubuntu 安装三种方式详解,PATH 配置、Git 依赖、WSL2 OAuth 登录问题解决、JetBrains/VS Code 集成,附 Windows 特有问题解决方案。2026/3/15教程零基础终端入门:macOS/Linux/Windows 三平台安装 Claude Code 的逐步指南零基础终端入门指南:macOS 四步(Command+空格打开终端/安装脚本/重启/claude 启动)、Linux 四步(Ctrl+Alt+T/安装/source/.bashrc/启动)、Windows 五步(安装 Git for Windows/打开 PowerShell/irm 安装脚本/重启/启动)、SSL/TLS 错误修复、安装后三个入门示例(网页/文件整理/规划咨询)、五大常见安装问题(command not found/HTML 错误/irm not recognized/Git Bash 缺失/claude not recognized),以及无需终端的替代方案(桌面应用/VS Code 插件/网页版)。2026/3/8教程Claude Code 最佳实践官方指南:上下文管理、验证策略与自动化扩展Claude Code 官方最佳实践指南,涵盖上下文窗口管理(最核心约束)、提供验证途径让 Claude 自我检验、四阶段工作流(探索→计划→确认→编码)、CLAUDE.md 编写原则、权限管理、Subagent 使用技巧,以及 Writer/Reviewer 并行开发模式等高效实践。2026/2/28