Appearance
Claude Code 从零上手教程：安装、登录、VS Code 与第一次任务【2026】
更新日期：2026年09月30日
Claude Code 不是把聊天窗口放进终端的代码补全插件，而是 Anthropic 面向项目开发的终端 AI Agent。它可以读取项目结构、修改文件、执行命令并根据结果继续推进任务。本文把从零上手拆成一条可验证的路径：准备运行环境、安装官方工具、完成账号登录、在小项目中试跑，再用 VS Code 检查改动。
一、Claude Code 与普通编程插件有什么区别
Cursor、GitHub Copilot 等工具通常围绕编辑器中的补全和对话展开；Claude Code 更强调“接住一个任务并推进它”。你可以让它先理解仓库，再提出修改计划，随后在你的确认下编辑文件和运行测试。
| 工具类型 | 主要工作方式 | 更适合的任务 |
|---|---|---|
| 网页聊天 | 问答、解释、生成文本 | 学习、总结、方案讨论 |
| 编辑器插件 | 边写边补全、局部修改 | 函数补全、快速重构 |
| Claude Code | 读取项目、改文件、跑命令、汇报结果 | 多文件功能、排错、测试和代码审查 |
它的智能处理主要在云端，本地电脑负责提供项目文件、终端和命令执行环境。因此，首次上手最重要的是 Node.js、终端权限、账号可用性和项目边界，而不是显卡配置。
二、安装前准备：Node.js、账号与测试项目
开始前准备三个条件：
- 安装当前稳定版或 LTS 版 Node.js，并确认
node -v、npm -v能返回版本号。 - 准备可用的 Claude 账号或 Anthropic API 权限。登录方式、套餐和地区支持以 Claude Code 官方文档 为准。
- 新建一个不含机密信息的测试项目。第一次不要直接打开生产仓库，也不要把
.env、私钥、客户资料或数据库密码放进测试目录。
Windows 用户建议额外安装 Git for Windows，其中的 Git Bash 能提供更接近 Unix 的命令环境。macOS 用户使用 Terminal 或 iTerm2 即可。
三、安装 Claude Code 并确认命令生效
在 PowerShell、Windows Terminal、Terminal 或 iTerm2 中执行官方 npm 安装命令：
bash
npm install -g @anthropic-ai/claude-code安装完成后，继续检查版本：
bash
claude --version能看到版本号，说明命令已经进入当前终端的 PATH。若提示“找不到 claude”，先关闭并重新打开终端；仍然失败时，检查 npm 全局 bin 目录是否加入 PATH，以及全局安装是否真的完成。不要为了绕过权限错误，随意从陌生网站下载所谓绿色版或破解版。
四、第一次启动：先只读，再修改
进入测试项目根目录后运行：
bash
claude按页面提示完成官方账号登录或其他授权。启动后，建议先发送一条只读任务：
text
请先阅读这个项目的目录结构，说明入口文件、主要模块和测试命令。
只做分析，不要修改任何文件，也不要执行删除或发布操作。如果返回的目录、文件和命令与项目实际情况一致，再给一个局部且容易验证的修改任务，例如：
text
请为 src/utils/date.ts 中的 parseDate 函数补充空值判断。
先说明修改计划，只改这个文件，完成后运行相关测试并汇报结果。这样可以同时验证四件事：它能否读取项目、是否理解任务范围、能否正确修改文件，以及是否会按要求运行检查。
五、用 VS Code 配合 Claude Code
不习惯纯终端时，可以安装 Visual Studio Code，然后选择官方文档当前列出的 Claude Code 扩展，或直接在 VS Code 的集成终端里运行 claude。扩展名称和安装方式可能变化，安装前请确认发布者和官方说明。
推荐的工作分工是：
- VS Code 资源管理器用于浏览项目和定位文件。
- Claude Code 用于分析任务、编辑文件和执行命令。
- Git 面板或
git diff用于逐行审查改动。 - 测试命令用于验证行为，而不是把模型的“已完成”当成验收结果。
可以把第一次完整闭环固定为：提出计划 → 允许小范围修改 → 查看 diff → 运行测试 → 再决定是否提交。涉及配置、依赖升级、数据库和部署时，要求它先解释风险，并由你手动确认。
六、账号、套餐与 API 的区别
Claude Code 不是一个脱离账号体系独立售卖的本地软件。你需要关注的是当前 Claude 账号、可用套餐或 API 权限。不同套餐、模型和地区的额度会调整，不能把旧教程中的免费额度或型号当成长期承诺。
| 方式 | 适用场景 | 使用前核对 |
|---|---|---|
| Claude 账号登录 | 个人体验和日常开发 | 当前地区、登录方式、消息额度 |
| 订阅套餐 | 更高频率的个人使用 | 价格、周期、限额和自动续费 |
| API | 自定义脚本、服务和自动化 | API Key、计费、模型权限和速率限制 |
| 团队方案 | 统一管理与协作 | 管理员权限、数据政策和成员规则 |
API Key 只应通过环境变量或密钥管理器提供，不能写进 Git 仓库、截图或聊天记录。第三方兼容接口即使声称支持 Claude Code，也属于独立服务；使用前必须单独核对服务主体、数据保存、额度和退款规则。
七、国内访问受限时怎么排查
Claude 官方服务的可用性会受到账号、地区、网络和服务状态影响。排查时按这个顺序进行：
- 先确认 Node.js、npm 和 Claude Code 本地命令正常。
- 打开 Claude 官方产品页 和文档，确认入口与当前支持范围。
- 区分“网页无法登录”“模型请求失败”“npm 下载失败”和“命令找不到”，它们不是同一个问题。
- 检查终端代理、DNS、企业网络策略和 npm 源；只使用自己信任的网络配置。
- 不要通过伪造身份、共享账号、接码或所谓破解版绕过限制。
请遵守所在地法律法规、网络服务商规则和 Anthropic 产品条款。无法访问官方服务时，可以先在脱敏项目中完成本地流程演练，但不要因此把不明第三方平台当作官方入口。
八、第一次使用最容易犯的三个错误
1. 任务描述太宽泛
“帮我优化一下项目”无法定义范围。应该写明目标文件、期望行为、不能修改的目录、测试命令和验收标准。
2. 一上来就交给它大型旧项目
新手还不了解上下文、权限和回滚方式时，直接处理大型遗留项目很难判断结果。先做 Demo、补一个测试、修一个可复现的小 Bug，再逐步增加任务范围。
3. 不看 diff 就接受结果
Claude Code 可以执行真实命令，模型也可能误解需求。任何改动都应经过 diff、测试和人工检查，尤其是依赖、权限、部署和数据处理相关文件。
九、常见问题
Claude Code 和 Claude 网页版有什么区别？
网页版适合对话、写作和总结；Claude Code 运行在终端或 IDE 环境中，能够读取代码仓库、编辑文件并执行命令。
电脑配置一般能不能运行？
多数情况下可以。核心模型服务在云端，本地主要负责文件访问、终端和网络通信。项目规模、磁盘权限和网络质量通常比显卡更关键。
Windows 一定要安装 Git for Windows 吗？
原生 Windows 建议安装，Git Bash 能补齐部分 Bash 工具。是否必须以及具体要求，以当前官方文档为准。
claude 命令找不到怎么办？
确认 node -v 和 npm -v 正常，重新执行全局安装，重开终端，并检查 npm 全局 bin 目录是否位于 PATH。不要用未知安装包替代官方 npm 包。
第一次应该拿什么任务练习？
选择边界清楚、结果直观且可回滚的任务，例如生成小型 Demo、解释一个模块、补充单元测试或修复一个稳定复现的错误。
结语
Claude Code 的上手重点不是记住很多命令，而是建立一套可检查的开发流程：安装官方工具，确认账号与权限，在小项目中先只读探路，再允许局部修改，最后通过 diff 和测试验收。模型、套餐、地区支持和插件名称都会变化，实际操作前请回到 Anthropic 官方页面核对最新信息。
免责声明
本站与 Anthropic、Claude、OpenAI 及任何第三方兼容平台没有隶属或合作关系。文中链接和命令用于信息整理，具体功能、价格、额度、地区支持与条款以官方最新页面为准。请勿向 AI 工具或第三方服务提交 API Key、密码、个人隐私、客户资料或未公开的公司代码，并遵守当地法律法规。