Claude Code 安装与第一次使用：从登录到完成一个小改动

第一次使用 Claude Code，先跑通一个可以自己验收的小任务，比立即交给它整个项目更有帮助。这篇从终端安装、登录、进入项目开始，用一个金额汇总函数练习“说明需求、检查修改、运行测试”。

下面从 npm 安装开始，走完登录、修改代码和运行测试。文末也介绍了现在安装时可选择的原生安装方式。

开始前准备什么

准备一个终端、Git、Node.js 和你有权使用的 Claude 账号或 Anthropic API 访问方式。选择仍受支持的 Node.js LTS，并确认满足官方安装要求。

下面的 shell 命令面向 macOS、Linux 和 Windows 的 WSL 终端。原生 Windows 的安装方式请核对当前官方说明，不要直接把所有 shell 命令粘进 PowerShell。

bash

node --version
npm --version
git --version

安装软件、登录成功、拥有可用额度是三个独立步骤。CLI 能启动，不代表账号一定可以发起模型请求。Claude Code 于 2025 年 5 月正式推出，历史背景可参考 Anthropic 的 Claude 4 发布说明。

安装并检查命令

按本文的 npm 路线安装：

bash

npm install -g @anthropic-ai/claude-code
claude --version

如果出现全局目录权限错误，优先用 Node 版本管理器调整用户级安装环境，不要把 sudo npm install 当作通用修复。

如果提示 claude: command not found，检查 npm 全局安装目录与终端 PATH。刚安装或调整环境后，可能需要重新打开终端。此时还没有调用模型，不必先去更换账号或购买套餐。

登录：先确认你走的是哪种计费路径

进入一个工作目录再运行：

bash

claude

首次运行会引导认证，按终端提供的链接和提示完成。需要重新登录时，可以在 Claude Code 会话内使用 /login；它不是普通 shell 命令。

使用 Claude 订阅登录和通过 Anthropic API 使用额度，是不同的授权与计费路径。不要因为网页聊天能用，就认定 API 余额已经包含在同一套餐里。公司账号还可能受组织设置影响，具体以账号和当前官方入口显示为准。认证步骤可对照官方快速开始。

只在官方认证页面完成登录，不购买共享账号，不复制他人令牌。登录失败时保留错误类型与时间，隐藏密钥后再排查，不能靠反复注册保证解决。

用一个新目录做第一次练习

选择一个尚不存在的目录名。下面先创建项目，再放入一个故意有缺陷的小函数：空数组会触发 reduce 错误。

bash

mkdir claude-first-task
cd claude-first-task
git init

新建 total.mjs：

javascript

export function totalCents(items) {
  return items.reduce((sum, value) => sum + value);
}

新建 total.test.mjs：

javascript

import test from 'node:test';
import assert from 'node:assert/strict';
import { totalCents } from './total.mjs';

test('adds integer cents', () => {
  assert.equal(totalCents([199, 250]), 449);
});

test('empty basket is zero', () => {
  assert.equal(totalCents([]), 0);
});

用整数分表示金额，让这个例子只关注空数组边界，不夹杂小数精度问题。先自己运行一次测试：

bash

node --test total.test.mjs
git add total.mjs total.test.mjs
git commit -m "Add first task fixture"

预期一个测试通过，一个失败。提交的是供练习使用的基线，目的是之后能清楚看到 AI 修改了什么。如果 Git 要求配置作者信息，按你自己的本地 Git 设置完成，不要复制别人的姓名邮箱。

先让它解释，再允许一个小修改

在这个目录运行 claude，先输入：

代码

请阅读 total.mjs 和 total.test.mjs，说明两个测试各验证什么。
先不要修改文件，也不要安装依赖。
告诉我空数组失败的原因，以及最小修改方案。

确认解释符合实际代码后，再发出修改任务：

代码

请按最小方案修复 totalCents，使空数组返回 0。
只修改 total.mjs，不更改测试，不新增依赖。
完成后运行 node --test total.test.mjs，并说明测试结果。

遇到工具权限提示时，看清实际文件路径和命令再批准。不同版本的权限模式会变化，第一次练习应选择需要你确认的方式，不要打开跳过权限检查的选项。

预期修复是给 reduce 添加初始值：

javascript

export function totalCents(items) {
  return items.reduce((sum, value) => sum + value, 0);
}

如果它还顺手重写测试或引入依赖，就说明这次结果偏离了任务范围。要求缩小修改，或者根据差异手动保留需要的部分。

验收时看命令输出和 Git diff

退出或另开终端，在项目目录执行：

bash

node --test total.test.mjs
git diff --check
git diff -- total.mjs total.test.mjs
git status --short

应该看到两个测试通过，函数只增加初始值，测试文件没有被修改。这个练习验证了空数组和两个整数相加；它没有覆盖输入类型、负数、超大整数等完整业务规则，不应直接当成生产金额库。

本文的示例测试可在本地独立运行，不需要模型额度。是否由你的 Claude Code 账号完成同样的调用，仍需在自己的账号和环境里验证。

把项目规则写清楚

在真实仓库里，可以通过 CLAUDE.md 记录安装方式、测试命令、代码风格和需要避开的目录。例如：

markdown

# 项目约定

- 修改前先阅读相关测试。
- 本练习只使用 Node.js 内置模块，不新增依赖。
- 测试命令：node --test total.test.mjs。
- 不读取 .env 或与当前任务无关的私人文件。
- 完成后说明修改文件、测试结果和未验证事项。

这些内容是给助手的工作说明，不是操作系统权限隔离。敏感凭据仍应通过实际权限和密钥管理保护。更完整的加载规则见 Claude Code 项目记忆文档。

常见问题先按阶段分开

左右滑动查看完整表格

出现位置	现象	优先检查
安装后	找不到 `claude`	npm 全局目录、PATH、当前终端环境
登录时	回调失败、会话失效	官方登录流程、浏览器回调、账号授权
第一次请求	额度或权限错误	订阅/API 路径、可用额度、组织策略
修改项目时	找不到文件	启动目录、文件真实路径、工具权限
执行测试时	命令不存在	项目依赖、运行时版本、README 中的测试命令

远程服务器断线、tmux 会话、服务状态和账号风险排查，放在另一篇 Claude Code 服务器使用指南。出现访问限制时应查看官方政策或申诉入口，没有一种配置能够保证账号永不受限。

npm 与原生安装方式怎么选

官方当前更推荐原生安装方式。如果你还没有 Node.js 环境，可以先查看 Claude Code 安装文档，选择与你的系统匹配的方式；已经使用 npm 安装的用户，也应按官方说明管理更新，避免不同安装方式的命令互相冲突。

想在 VS Code 中比较扩展，可以继续读 AI 编程插件选型；已经使用 Cline，则可以从 MCP 实际调用练习继续扩展工具能力。