教程

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 高级提示技巧:TDD 驱动、截图验证、面试需求、让 AI 自我检查 7 个方法Claude Code 高级提示技巧 7 个方法:TDD 先写测试、截图验证 UI、面试确认需求、新会话 Reviewer 自检、参考现有模式、可中断大型任务、三阶段探索-计划-执行工作流。2026/4/13教程Claude Code Remote Control 详解:用手机或另一台电脑控制本地 AI 编程会话Claude Code Remote Control 完整指南:3 种启动方式(Server/交互/现有会话)、手机扫码连接步骤、实际使用场景,以及与网页版的核心区别、安全机制和常见报错解决方法。2026/4/13教程Claude Code 定时任务完整指南:每天自动 review 代码、检查依赖、生成日报Claude Code 定时任务完整配置指南:Desktop 本地任务、云端任务、/loop 三种方式对比,含 5 个实用任务模板(每日代码 review、依赖漏洞扫描、技术债报告),以及权限防卡死和补跑机制详解。2026/4/13教程Claude Code in Slack:在团队聊天里直接触发 AI 修 bug、创建 PRClaude Code Slack 集成完整配置指南:4 步配置从团队聊天触发 AI 编码任务,含路由模式选择、上下文利用、仓库自动检测、权限管理,以及 Slack 提示词写法技巧。2026/4/12教程Claude Code SKILL.md 自定义技能教程:创建可复用 AI 工作流,告别重复配置Claude Code SKILL.md 自定义技能教程:4 种技能类型详解(领域知识、工作流、安全检查、支付约束),含团队共享配置和全局 Skill 设置,告别每次重复配置。2026/4/10教程Claude Code VS Code 插件使用指南:安装、@ 文件引用、内联 diff 和多会话并行Claude Code VS Code 插件完整指南:安装配置、@ 引用精确代码行、内联 diff 审阅、多会话标签页并行、Plan 模式文档预览,及与 CLI 的功能对比表。2026/4/10