Claude Code 入门教程：安装、登录与第一个任务

一句话介绍：Claude Code 是 Anthropic 推出的 AI 编程代理，你用自然语言描述任务，它会自己读取项目文件、规划步骤、修改代码、运行命令，并在需要时请你确认。它可以在终端、VS Code / JetBrains 编辑器、桌面应用和网页中使用。

截图待补充

上线前补充实际操作截图并核验软件版本。本文写作时查到的最新版本为 2.1.292，命令均摘自官方文档 code.claude.com/docs。

CClaude Code

在终端和编辑器中读懂项目、修改代码、运行命令

官方入口

claude.com/product/claude-code

收费方式

Claude 付费订阅或 API 按量付费

适合人群

开发者、想用 AI 建站的用户

教程

Claude Code 介绍与教程

资料核验：2026-10-09

第一次接触 AI 编程工具，建议先看 AI 编程工具入门：开始使用前需要准备什么，那里讲了编辑器、Git、练习项目等通用准备。本页只讲 Claude Code 本身。

1. 主要功能

功能	说明
读懂项目	按需读取项目文件，回答“这个项目是做什么的”“入口在哪里”等问题，不需要手动粘贴代码
修改代码	跨多个文件实现功能、修复错误、重构、写测试
运行命令	运行测试、构建、安装依赖等命令，并根据输出继续修改
Git 操作	查看改动、写提交说明、建分支，用对话方式完成
项目说明文件	在项目根目录放 CLAUDE.md，写入代码规范和注意事项，每次会话开始时自动读取
扩展能力	支持 MCP（连接外部工具和数据）、技能（skills）、钩子（hooks）、子代理等
多种使用界面	终端命令行、VS Code 与 JetBrains 插件、桌面应用、网页版（claude.ai/code）

2. 适合谁 / 不适合谁

适合：

• 想让 AI 完成一整块任务（比如“加一个登录页并写测试”）的开发者；
• 想用 AI 做网页、写小脚本的新手——只要愿意学会用 git diff 检查修改；
• 需要理解一个陌生项目的人。

不太适合：

• 只想要编辑器里的逐行补全，不想让 AI 改文件的人——可以看 GitHub Copilot 或 Cursor；
• 只有 Claude 免费版、不打算付费的人——官方文档列出的账号类型不包含免费版。

3. 收费方式

方式	说明
Claude 付费订阅	官方推荐。Pro、Max、Team、Enterprise 方案可登录使用，用量随订阅档位不同
Anthropic Console（API）	预充值后按用量计费，首次登录时会自动创建一个名为“Claude Code”的工作区方便统计花费
企业云平台	也可通过 Amazon Bedrock、Google Cloud、Microsoft Foundry 等平台接入，适合企业

具体价格和每个档位的用量限制变化较快，请以 官方定价页 为准。是否值得付费可参考 免费 AI 工具和付费订阅怎么选。

4. 安装

以下命令摘自官方文档原文。官方推荐原生安装，安装后会在后台自动更新。

macOS、Linux、WSL：

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

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

也可以用包管理器安装（这两种方式不会自动更新，需要定期手动升级）：

# Homebrew（macOS）
brew install --cask claude-code

# WinGet（Windows）
winget install Anthropic.ClaudeCode

安装完成后，打开一个新的终端窗口，运行：

claude --version

能显示版本号就说明安装成功。

Windows 用户注意

• 提示 The token '&&' is not a valid statement separator：说明你在 PowerShell 里运行了 CMD 命令，换用 PowerShell 那条命令。
• 提示 'irm' is not recognized：说明你在 CMD 里，换用 CMD 那条命令。
• 官方建议在 Windows 上同时安装 Git for Windows；使用 WSL 则不需要。
• 提示找不到 claude 命令：通常是安装目录还没加入 PATH，先关闭终端重新打开再试。

5. 登录

进入任意项目文件夹，运行：

claude

第一次运行会提示登录，按提示在浏览器中完成授权即可。可用的账号类型：

• Claude Pro、Max、Team、Enterprise 订阅账号（官方推荐）；
• Claude Console 账号（API 预充值）；
• 企业云平台账号。

登录信息会保存在本机，之后不用再登录。需要切换账号时，在会话中输入 /login。

浏览器授权成功，终端却一直等待

这是网络问题最常见的表现：浏览器走了代理，终端里的程序没有走。处理方法见 浏览器能访问，为什么应用程序连接失败，通常开启代理客户端的 TUN 模式即可，见 代理客户端 TUN 模式怎么开。

6. 第一个任务

建议在一个已经用 Git 管理的练习项目里开始（创建方法见 AI 编程工具入门）。

1. 先了解项目。启动 claude 后输入：

   这个项目是做什么的？主要用了哪些技术？入口文件在哪里？

2. 提一个小改动，并要求先给计划：

   给首页加一个“返回顶部”按钮，滚动超过一屏时才显示。
   先说明你打算改哪些文件，等我确认后再动手。

3. 查看并确认修改。Claude Code 会展示改动；如果它询问是否执行，选择同意即可。

4. 自己验证：在浏览器里打开页面看效果，在终端运行 git diff 看具体改了什么。

5. 提交：可以直接让它做——

   用一句清楚的说明提交这次修改

关于权限模式

较新版本中，终端会话默认使用“自动模式”：由分类器代替你审查操作，大部分文件修改和命令会直接执行，不再逐条询问。新手如果希望每一步都自己确认，可以随时按 Shift+Tab 切换权限模式。无论哪种模式，都不要在含有密码、密钥的目录中使用。

7. 常用命令

在终端里启动时用：

命令	作用
claude	启动交互模式
claude "任务描述"	启动并直接带上第一个任务
claude -p "问题"	只回答一次就退出，适合脚本里使用
claude -c	继续当前目录最近一次的对话
claude -r	从历史对话中选择一个继续

在会话里用：

命令 / 按键	作用
/help	查看可用命令
/clear	清空当前对话历史，开始新任务前使用可节省额度
/login	切换账号或重新登录
/resume	恢复之前的对话
/exit 或连按两次 Ctrl+D	退出
Shift+Tab	切换权限模式
输入 /	列出可用的命令和技能

8. 常用技巧与提示词示例

• 说具体：不要只说“修一下 bug”，而是“修复输入错误密码后页面变成空白的问题”。
• 拆步骤：大任务写成 1、2、3 步，让它逐步完成。
• 先探索再动手：先让它“分析一下数据库结构”，再提修改要求。
• 用 CLAUDE.md 记住规则：例如“所有页面文字用简体中文”“改完必须运行测试”。
• 一个任务一个会话：换任务前用 /clear，避免旧上下文干扰、浪费额度。

更多实战做法见 用 AI 读懂和修改已有项目代码 和 用 AI 做一个网页：从需求描述到上线。

9. 和同类工具怎么选

对比	怎么选
Claude Code vs Codex	都是编程代理，工作方式接近。已经订阅 Claude 选 Claude Code，已经订阅 ChatGPT 选 Codex，用自己的项目各试一次最准
Claude Code vs Cursor	Cursor 是图形界面编辑器，适合习惯点选操作的人；Claude Code 以终端为主，也可在编辑器插件和桌面应用中使用
Claude Code vs GitHub Copilot	Copilot 有免费方案、强在编辑器补全；需要 AI 独立完成整块任务时 Claude Code 更直接

整体对比见 AI 编程工具入门 和 AI 导航：AI 编程与建站工具。

10. 常见问题

问题	处理
安装脚本报 403、syntax error near unexpected token '<' 或超时	多为网络问题，命令行没有走代理，见 AI 工具报错或无法访问怎么排查
使用中频繁提示请求失败、连接中断	检查节点稳定性，避免任务进行中切换节点；排查步骤同上
免费版能用吗	官方文档列出的账号类型不包含 Claude 免费版
额度很快用完	一次只给一个明确任务，换任务前 /clear，不要让它反复读取整个大项目
改坏了怎么办	用 Git 回退，方法见 AI 编程工具入门 第 5 节

另外，Claude 有自己公布的支持地区与使用条款，能否注册和付费以服务方公布的支持地区为准。

相关阅读

• AI 编程工具入门：开始使用前需要准备什么
• Codex 入门教程：安装、登录与第一个任务
• 用 AI 做一个网页：从需求描述到上线
• AI 工具报错或无法访问怎么排查
• 浏览器能访问，为什么应用程序连接失败