如何设置Claude Code CLI：5分钟快速入门

ServiceNow已有超过29,000名开发者每天使用Claude Code，安联集团也在2026年初完成了全公司范围的部署。该工具的采用曲线呈现出一个规律：一旦开发者在自己的终端中体验过智能体编程，就再也不会回到从聊天窗口复制粘贴的方式。本快速入门指南将帮助您在大约五分钟内从零开始完成一个可用的Claude Code会话，并附带可以长期使用的实际配置。

摘要： 通过npm install -g @anthropic-ai/claude-code安装Claude Code，在浏览器中完成身份验证，创建包含项目上下文的CLAUDE.md文件，并在.claude/settings.json中配置权限。添加一个Prettier Hook，在每次编辑后自动格式化文件。整个设置过程不到五分钟，且配置在会话之间持久保存。

核心要点

独立开发者： CLAUDE.md和一个格式化Hook就能满足80%的需求。从默认权限开始，随着信任度的建立逐步预批准工具。
团队负责人： 将.claude/settings.json提交到代码仓库，确保整个团队共享相同的权限白名单和Hook。
安全工程师： 三层权限模型（默认、预批准、跳过）直接对应信任级别。默认模式下，每次写入和每条命令都需要显式批准。

前置条件

安装Claude Code前，您需要准备三样东西：

Node.js 18或更高版本。 Claude Code以npm包的形式发布。检查您的版本：

node --version
# v18.0.0 or higher

如果需要安装或升级Node.js，请使用nvm或从nodejs.org直接下载。

拥有API访问权限的Anthropic账户。 在console.anthropic.com的Settings > API Keys下创建API密钥。Claude Code的费用从您的API余额或Max订阅计划中扣除。请在身份验证步骤中准备好密钥。

一个终端。 Claude Code可在任何终端模拟器中运行：Terminal.app、iTerm2、Windows Terminal、Alacritty或VS Code的集成终端。我建议使用至少120列宽度的终端，因为Claude Code显示的文件差异和工具输出需要足够的水平空间。

安装

通过npm全局安装Claude Code：

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

验证安装是否成功：

claude --version

您应该会看到版本号输出到标准输出。如果出现”command not found”错误，请确保npm全局bin目录在您的PATH中。运行npm config get prefix，然后将该输出的/bin子目录添加到PATH中。

首次启动时，Claude Code会在浏览器中打开Anthropic控制台进行OAuth身份验证。您登录并授权后，令牌会存储在本地~/.claude/目录中。或者，您可以在启动前设置ANTHROPIC_API_KEY环境变量。无论哪种方式，凭证都保留在您的机器上，仅用于API请求的身份验证。

第一次会话

导航到任意项目目录并运行：

cd ~/Projects/my-app
claude

Claude Code启动一个交互式REPL会话。在新项目中首次启动时，它会自动完成以下操作：

扫描目录结构以了解项目布局
读取配置文件（如package.json、pyproject.toml或Cargo.toml）以识别技术栈
查找CLAUDE.md文件（项目根目录下的项目特定指令）

尝试一个简单的提示词来确认一切正常：

> Explain the structure of this project

Claude读取您的文件，综合分析架构，并在终端中进行响应。您将实时看到工具调用（每次文件读取、每条命令执行），以及在任何写入操作前的权限请求。

设置CLAUDE.md

CLAUDE.md是高效使用Claude Code最重要的文件。它位于项目根目录，包含Claude在每次会话开始时读取的指令。可以将其视为面向AI协作者的README。

创建该文件：

touch CLAUDE.md

以下是一个实用的起始模板：

# My App

## Project Context
Express.js API with React frontend. PostgreSQL database.

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e

## Code Standards
- Use async/await, never raw Promises
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging

## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations

根据我的经验，最有价值的部分是那些能防止重复错误的内容。如果Claude在您的ESM项目中总是使用CommonJS，就将这一点写入CLAUDE.md。如果有特定的测试命令或数据库设置步骤，请记录下来。Claude每次会话都会读取CLAUDE.md，因此您放入其中的内容都会成为持久指令。

您还可以在主目录（~/.claude/CLAUDE.md）放置一个CLAUDE.md用于跨项目的全局指令，也可以在子目录中放置用于monorepo特定部分的上下文。

权限基础

Claude Code在三个权限层级中运行，决定智能体拥有多大的自主权：

默认模式在每次文件写入、命令执行或破坏性操作前都会请求权限。您可以准确看到Claude打算做什么，并逐步批准或拒绝。我建议从此模式开始。

预批准权限允许您将特定工具和模式加入白名单，这样Claude就不会每次都询问。您可以在项目的.claude/settings.json中配置：

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npx prisma migrate dev)"
    ]
  }
}

此示例允许Claude读取文件、搜索代码库以及运行测试和迁移命令而无需询问。但写入文件或运行其他bash命令时仍会询问。

危险跳过权限（--dangerously-skip-permissions）禁用所有确认提示。此标志专门用于CI/CD流水线和无人值守的自动化工作流。切勿在您重视的代码库的交互式会话中使用它。

权限系统正是Claude Code可以安全用于实际项目的原因。从默认模式开始，观察哪些批准操作变得重复，然后有选择地预批准这些特定操作。

您的第一个Hook

Hook是在Claude Code生命周期特定节点执行的Shell命令。它们在LLM的概率行为之上提供确定性保障。以下是一个实用的第一个Hook：在Claude编辑文件后自动格式化。

在项目中创建或编辑.claude/settings.json：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

此Hook在每次Edit或Write工具调用后触发。Claude Code将$FILE_PATH设置为被修改的文件。Prettier对其进行就地格式化，|| true确保在Prettier未安装或文件类型不支持时Hook不会阻塞Claude。

我推荐的其他实用入门Hook：

Bash的PreToolUse：阻止危险命令，如rm -rf /或git push --force
SessionStart：将当前日期、活跃Git分支或环境变量注入上下文（SessionStart Hook的标准输出会馈入Claude的上下文）
Stop：在Claude完成任务后自动运行测试套件

Hook将Claude Code从一个对话工具转变为一个受治理的开发环境。即使只有一两个精心选择的Hook，也能消除整类错误。

后续步骤

本快速入门涵盖了基础要点：安装、第一次会话、项目配置、权限和入门Hook。如需了解涵盖全部5个核心系统（CLAUDE.md层级、完整权限模型、Hook架构、自定义斜杠命令和多智能体工作流）的完整参考，请阅读Claude Code完整指南。

该指南涵盖上下文窗口管理、子智能体委派、技能自动激活，以及在数月日常使用Claude Code后涌现的各种模式。如果您觉得本快速入门有用，完整指南是自然的下一步。

常见问题

Claude Code的费用是多少？

Claude Code支持两种计费模式。API按量付费模式按照标准Anthropic API费率按token计费。一个典型的30-60分钟会话的费用在0.50-3.00美元之间，具体取决于代码库大小和生成量。另外，Anthropic的Max计划（个人100美元/月，团队200美元/月）包含Claude Code使用量，并享有更高的速率限制。您可以在console.anthropic.com监控API使用情况。

我可以在VS Code中使用Claude Code吗？

可以。Claude Code可在任何终端中运行，包括VS Code的集成终端。在VS Code中打开终端面板，导航到项目目录，然后像在独立终端中一样运行claude。Claude Code直接在磁盘上读写文件，因此更改会立即显示在VS Code的编辑器标签页中。无需单独安装VS Code扩展。一些开发者会在编辑器旁边保持一个专用的终端分屏用于Claude Code，这对于实时审查变更效果很好。

Claude Code在生产代码库上使用安全吗？

Claude Code的默认权限模式在每次文件写入和每条命令执行前都会请求显式批准。未经您确认，磁盘上不会发生任何更改。权限系统与可以阻止强制推送或破坏性Shell命令等危险操作的Hook相结合，使其适用于生产环境。我每天都在服务真实用户的项目中使用Claude Code。关键在于从默认模式开始，在批准每个工具调用前理解其作用，然后逐步仅预批准您信任的操作。版本控制是您的最后安全网：在开始任何重要的Claude Code会话前先提交，这样您随时可以回滚。