安装 Claude Code CLI：5 分钟快速配置指南（2026）

Q: Claude Code 的费用是多少？

Claude Code 支持两种计费模式。API 按量付费模式按 Anthropic 标准 API 费率逐 token 计费。一次典型的 30 到 60 分钟会话，视代码库规模和生成量而定，大约花费 0.50 至 3.00 美元。另一种是 Anthropic 的 Max 套餐（截至 2026 年年中，Max 5x 为每月 100 美元，Max 20x 为每月 200 美元，两者均为个人档位），其中已包含 Claude Code 用量，并提供更高的速率上限。您可以在 console.anthropic.com 查看 API 使用情况。

Blake Crosley 12分钟阅读

Part 1 of New to Claude Code

来自指南: Claude Code Comprehensive Guide

如何配置 Claude Code？ 用官方原生安装脚本 curl -fsSL https://claude.ai/install.sh | bash 安装 CLI，通过浏览器完成认证，然后在项目根目录创建 CLAUDE.md，写清技术栈细节和编码规范。接着在 .claude/settings.json 中配置权限，并添加一个格式化钩子，让每次编辑后自动修正代码风格。整套配置用不了五分钟。 {.answer-block}

ServiceNow 已向超过 29,000 名员工推广 Claude Code¹，Allianz 也宣布达成合作，将于 2026 年初让全体员工都能使用 Claude²。这条采用曲线折射出一个规律：开发者一旦在自己的终端里体验过智能体式编程，就不会再回到从聊天窗口复制粘贴的老路。下面的操作流程会带您从零起步，用大约五分钟跑通一次 Claude Code 会话，而且沿途产出的配置之后还能继续使用。

摘要： 用原生安装脚本（curl -fsSL https://claude.ai/install.sh | bash）安装 Claude Code，在浏览器中完成认证，创建一份写有项目背景的 CLAUDE.md，再到 .claude/settings.json 中配置权限。加上一个 Prettier 钩子，每次编辑后文件都会自动格式化。整个过程不到五分钟，配置会在多次会话之间持续生效。

要点速览

独立开发者： CLAUDE.md 加一个格式化钩子，就能覆盖八成需求。先用默认权限起步，随着信任逐步建立，再把常用工具预先放行。
团队负责人： 把 .claude/settings.json 提交到仓库，整个团队就共享同一份权限白名单和钩子配置。
安全工程师： 权限模型⁴（Ask/Manual、白名单、auto 模式的分类器、--dangerously-skip-permissions）与信任级别一一对应。Ask 模式下，每一次写入、每一条命令都需要明确批准；不过自 2026 年 8 月 14 日起，Pro/Max/Team 会话默认改为 auto 模式——如果您的威胁模型要求每次批准都有人把关，请用 "defaultMode": "manual" 固定下来。

前置条件

安装 Claude Code 之前，您需要准备两样东西。

一个 Anthropic 账号。 Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账号，免费的 Claude.ai 套餐并不包含使用权限³。订阅套餐本身已包含 Claude Code 用量（截至 2026 年年中，Max 5x 为每月 100 美元，Max 20x 为每月 200 美元，两者均为个人档位）⁶；您也可以在 console.anthropic.com 申请 API 密钥，按 token 计费。认证会在安装完成后于浏览器中进行，因此现在还不需要复制任何东西。

一个终端。 Claude Code 可以在任意终端模拟器中运行：Terminal.app、iTerm2、Windows Terminal、Alacritty，或者 VS Code 的集成终端都可以。建议终端宽度至少 120 列，因为 Claude Code 会展示文件差异和工具输出，横向空间越充裕越好读。

推荐的安装方式不需要 Node.js。只有当您选择下文的 npm 方案时才用得上，而截至 v2.1.198，该方案需要 Node.js 22 或更高版本。

安装

使用 Anthropic 推荐的原生安装脚本来安装 Claude Code³：

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

在 Windows 上，请改在 PowerShell 中执行 irm https://claude.ai/install.ps1 | iex。安装程序会把二进制文件放在 ~/.local/bin/claude；原生安装会在后台自动更新，无需手动升级即可保持最新。

验证安装是否成功：

claude --version

标准输出应打印出一个版本号。如果提示 “command not found”，说明 ~/.local/bin 不在您的 PATH 中。把它写进 shell 配置文件并重新加载：

# Zsh (macOS default)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

想更深入地诊断安装与配置，可以运行 claude doctor——它会检查二进制文件、PATH、自动更新状态，并指出相互冲突的安装（例如原生版本旁边残留的 npm 全局副本）。

其他安装方式。 如果您偏爱受管理的 cask，Homebrew 同样可用：brew install --cask claude-code（用 brew upgrade --cask claude-code 更新，或自 v2.1.129 起设置 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1，让包管理器在后台更新）。npm 包目前仍能使用，但属于遗留方式，自 v2.1.15 起已被弃用——npm install -g @anthropic-ai/claude-code（需要 Node.js 22 以上，切勿加 sudo⁷），而且它在底层装的其实是同一个原生二进制文件。如果您当初是从 npm 起步，想切换到推荐方案，请先安装原生版本，再用 npm uninstall -g @anthropic-ai/claude-code 移除 npm 副本，以免版本冲突。

首次启动时，Claude Code 会打开浏览器进行 OAuth 认证。您登录并授权后，Claude Code 会把运行时认证状态保存在本地的 ~/.claude.json 中。此外也可以在启动前设置 ANTHROPIC_API_KEY 环境变量。无论采用哪种方式，凭据都只留在您自己的机器上，且仅用于认证 API 请求。

第一次会话

进入任意项目目录并运行：

cd ~/Projects/my-app
claude

Claude Code 会启动一个交互式 REPL 会话，并在启动时加载您的 CLAUDE.md 与各项设置。在新项目中输入第一条提示词时，Claude 会自行探索所需信息：

扫描目录结构，了解项目布局
读取配置文件，如 package.json、pyproject.toml 或 Cargo.toml，识别技术栈
应用项目根目录的 CLAUDE.md 指令，这些内容在启动时已经加载完毕

试一条简单的提示词，确认一切正常：

> Explain the structure of this project

Claude 会读取文件、梳理架构，并在终端里作答。您会实时看到每一次工具调用（读取的每个文件、执行的每条命令），并在任何写入操作之前收到权限请求。

第一次会话里值得留意什么。 请重点关注两件事：实时显示在每次动作之前的工具调用，以及权限提示。工具调用揭示了 Claude 如何在您的代码库中穿行。您会发现它读了一些自己原本想不到要查看的文件，而这些文件往往能带出有用的上下文。权限提示则在任何内容落盘之前，准确告诉您 Claude 打算改动什么。如果某处改动看起来不对，直接拒绝并补充说明。Claude 会在同一次会话中根据您的反馈调整做法⁸。

配置 CLAUDE.md

CLAUDE.md 是用好 Claude Code 最关键的一个文件。没有它，Claude 只能从文件内容推断技术栈，做出看似合理的猜测；有了它，Claude 从第一条提示词起就严格遵循您的规范。这个差别之所以重要，是因为基于推断的行为会漂移：Claude 可能在 ESM 项目里用 CommonJS，挑错测试运行器，或者忽略您的数据库迁移流程。CLAUDE.md 正是用来消除这种漂移的。

在项目根目录创建该文件：

touch CLAUDE.md

下面是一份适用于 Python 项目的实用起步模板：

# My App

## Project Context
FastAPI backend with HTMX frontend. PostgreSQL database.

## Stack
- Backend: Python 3.11, FastAPI, SQLAlchemy 2.0 (async)
- Frontend: HTMX + Alpine.js, Jinja2 templates
- Database: PostgreSQL 16, Alembic migrations
- Testing: pytest with pytest-asyncio

## Code Standards
- Type hints on all function signatures
- Pydantic v2 models for request/response validation
- Async database operations only (no sync SQLAlchemy)

## Commands
- `source venv/bin/activate` before any Python command
- `uvicorn app.main:app --reload` starts the dev server
- `python -m pytest -v` runs the test suite
- `alembic upgrade head` applies database migrations

对于 JavaScript/TypeScript 项目，结构大同小异：

# My App

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

## Code Standards
- ESM imports only (no require())
- 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.md 中最有价值的部分，是那些能防止重复犯错的内容。如果 Claude 老是用 require() 而不是 import，就在 Code Standards 里加上 “ESM imports only”。如果运行测试前必须先激活虚拟环境，就把这个顺序写清楚。Claude 在每次会话开始时都会读取 CLAUDE.md，因此其中每一行都会变成长期有效的指令，在成百上千次交互中不断累积效果。关于怎样写出有效的 CLAUDE.md，我在 AGENTS.md 模式一文中做了梳理，也在上下文即架构中讨论了背后更普遍的原则。开放规范 AGENTS.md⁹ 为其他智能体工具采用了类似的模式，但 CLAUDE.md 支持技能、规则目录等更丰富的特性。

层级关系很关键。 CLAUDE.md 可以放在三个位置，Claude 会按照由泛到专的顺序合并它们：

~/.claude/CLAUDE.md：适用于所有项目的全局指令（您个人的编码偏好）
./CLAUDE.md：项目级指令（提交到仓库，与团队共享）
./src/CLAUDE.md：目录级指令（作用范围限定于 monorepo 的某个模块或子系统）

真正需要纳入版本控制的是项目级 CLAUDE.md。使用 Claude Code 的团队成员会自动继承您定下的规范。

权限基础

Claude Code 有三档权限级别⁴，决定了智能体拥有多大自主度。您选择的级别控制着一个根本性的取舍：自主度越高，会话推进越快，但对改动的可见性越低。

Ask 模式（自 v2.1.200 起在 CLI 中显示为 “Manual”）要求在每次写文件、执行命令或做破坏性操作之前先获得批准。您能准确看到 Claude 打算做什么，并逐步批准或拒绝。请注意默认值已在 2026 年 8 月 14 日发生变化：Pro、Max 和 Team 会话现在以 auto 模式启动，由安全分类器审查每个动作，而不再逐条询问您——按 Shift+Tab 可以切回 Manual，也可以在设置中用 "defaultMode": "manual" 固定。我仍然建议从 Manual 起步，因为这些批准提示本身就在教您 Claude Code 的运作方式。用上几次之后，您自然会形成判断：哪些操作可以放心预先放行，哪些每次都值得仔细看一眼。

白名单权限让您预先放行特定的工具和模式，免得 Claude 每次都要询问。相关配置写在项目的 .claude/settings.json 中：

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(python -m pytest:*)",
      "Bash(alembic upgrade head)"
    ]
  }
}

上面这份配置允许 Claude 读取文件、搜索代码库，并直接运行您的测试和迁移命令，无需询问。而在写文件或运行任何其他 bash 命令之前，它仍会征求同意。请留意其中的规律：只把读操作和已知安全的命令放进白名单；写操作保留在 Ask 模式下，因为您希望在内容落盘之前先审阅 Claude 写了什么。

危险地跳过权限检查（--dangerously-skip-permissions）会关闭确认提示（自 v2.1.126 起保留了一道安全网：灾难性的删除命令仍会提示）。这个标志专为 CI/CD 流水线和无人值守的自动化流程而设。在您在乎的代码库上进行交互式会话时，千万不要使用它。

正是这套权限机制，让 Claude Code 能安全地用于真实项目。这个推进顺序是有意为之：先在 Ask 模式下建立理解，把重复出现的操作加入白名单，同时让写操作始终受控，确保改动落地之前您都能过一遍。

您的第一个钩子

钩子是在 Claude Code 生命周期的特定节点上执行的 shell 命令⁵。我写过一篇完整的钩子教程，从零构建五个可用于生产的钩子；关于构建自定义技能的文章则介绍了更进一步的自动化。钩子解决的是基于 LLM 的工具的一个根本问题：模型大多数时候会遵守您的格式规范，但“大多数时候”意味着每十次文件编辑就会混进一次风格不一致。模型给的是概率性保证，钩子给的是确定性保证。格式化钩子会在每次写入文件之后运行格式化工具，次次如此，与模型当时怎么决定无关。下面就是一个实用的入门钩子：在 Claude 编辑文件后自动格式化。

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

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

PostToolUse 钩子⁵会在每次 Edit 或 Write 工具调用之后触发。Claude Code 会把 $FILE_PATH 设为被修改文件的路径。Prettier 就地完成格式化，而 || true 可确保在 Prettier 未安装或文件类型不受支持时，非零退出码不会阻塞 Claude⁵。

我还推荐几个实用的入门钩子：

针对 Bash 的 PreToolUse：拦截 rm -rf / 或 git push --force 这类危险命令
SessionStart：把当前日期、当前 git 分支或环境变量注入上下文（SessionStart 钩子的标准输出会进入 Claude 的上下文）
Stop：在 Claude 完成任务时自动运行测试套件

钩子能把 Claude Code 从一个对话式工具，变成一套受治理的开发环境。哪怕只配置一两个选得好的钩子，也能消灭整整一类错误。

出问题的时候

在使用 Claude Code 的第一周里，有四种情况会反复出现。提前了解它们，能省下不少排查时间。

Claude 无视您 CLAUDE.md 里的指令。 最常见的原因是：在您修改文件之前，Claude 已经读过它并缓存了理解。运行 /clear 重置上下文，或者新开一次会话。Claude 只在会话开始时重新读取 CLAUDE.md，而不是每条提示词都读一遍。如果新会话里它仍然无视这些指令，请检查是否有优先级更高的 CLAUDE.md（用户级的 ~/.claude/CLAUDE.md）与您的项目级文件相冲突。

Claude 做了您没有批准的改动。 如果白名单模式写得太宽（比如放了一条包罗万象的 Bash 规则，而不是 Bash(python -m pytest:*) 这样的窄前缀），Claude 就能不经询问直接执行命令。请收窄白名单模式。最稳妥的做法是：只把读操作和具名的特定命令放进白名单。如果 Claude 已经做出了不想要的改动，git diff 会准确显示改了什么，git checkout -- <file> 则可以还原。

长时间会话中上下文窗口被占满。 上下文窗口填满时，Claude Code 会压缩较早的消息（截至 2026 年年中，默认模型都具备 100 万 token 的窗口，因此比过去要难触顶得多），但压缩可能会丢掉对话早期的重要细节。对于超过 30 分钟的会话，建议定期提交已完成的改动，然后用 /clear 开始新会话。全新的上下文会重新读取 CLAUDE.md，从干净的状态出发。我自己是每完成一个子任务就提交一次，这样既留下了回滚点，也形成了天然的会话分界。

Claude 改错文件，或做了不必要的改动。 当 Claude 开始“优化”您根本没让它碰的代码时，问题通常出在提示词太模糊。与其说“把 auth 模块整理一下”，不如说“在 app/auth/handlers.py 中，把 verify_user 重命名为 verify_user_credentials，并更新所有调用方”。越具体，副作用越少。如果不想要的编辑已经发生，git diff 会准确显示改动内容，git checkout -- <file> 可以逐个文件还原，而不影响其他工作。

后续步骤

上面的流程覆盖了最要紧的部分：安装、第一次会话、项目配置、权限，以及一个入门钩子。若想把 Claude Code 与其他智能体工具做个比较，可参阅 Claude Code 与 Codex 对比。若需要涵盖全部五大核心系统（CLAUDE.md 层级、完整权限模型、钩子架构、自定义斜杠命令、多智能体工作流）的完整参考，请阅读 Claude Code 完全指南。

那份指南讲解了上下文窗口管理、子智能体委派、技能自动激活，以及每天使用 Claude Code 数月之后才会浮现的那些模式。如果这份快速入门对您有帮助，完整指南就是自然的下一步。若想快速查阅每一条命令、每个标志和每个快捷键，请看 Claude Code 速查表。

如果您的项目是 iOS 或 macOS 应用，iOS 智能体开发指南涵盖了 Apple 平台特有的 Claude Code 模式：用于构建和模拟器的 XcodeBuildMCP 集成、保护 .pbxproj 不被智能体改动的 Apple 开发钩子，以及讲解 App Intents、MCP 服务器、Foundation Models 和框架层面智能体平台连接的 Apple 生态系列。

参考资料

常见问题

安装 Claude Code 需要哪些条件？

您需要一个 Anthropic 账号（Pro、Max、Team、Enterprise 或 Console——免费套餐不包含 Claude Code），以及任意一款终端模拟器。Claude Code 可运行在 macOS 13 及以上、Linux 和 Windows（原生或 WSL）上。推荐的安装方式是原生安装脚本——curl -fsSL https://claude.ai/install.sh | bash——它不需要 Node.js、不需要 Docker，也不依赖其他运行时。只有选择 npm 方案（npm install -g @anthropic-ai/claude-code）时才需要 Node.js 22 以上。

CLAUDE.md 是什么？为什么需要它？

CLAUDE.md 是放在项目根目录的一个 markdown 文件，用来告诉 Claude Code 您的技术栈、编码规范和常用命令。没有它，Claude 只能从文件内容推断项目情况并做出看似合理的猜测，而这些猜测会在不同会话之间漂移。有了 CLAUDE.md，Claude 每次会话都会从第一条提示词起严格遵循您的规范。它支持三级层次结构：用户级（~/.claude/CLAUDE.md）、项目级（./CLAUDE.md）和目录级（./src/CLAUDE.md），按由泛到专的顺序合并。

Claude Code 的费用是多少？

Claude Code 支持两种计费模式。API 按量付费模式按 Anthropic 标准 API 费率逐 token 计费⁶。一次典型的 30 到 60 分钟会话，视代码库规模和生成量而定，大约花费 0.50 至 3.00 美元。另一种是 Anthropic 的 Max 套餐⁶（截至 2026 年年中，Max 5x 为每月 100 美元，Max 20x 为每月 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 的 Ask 模式要求在每次写文件、每次执行命令之前都明确批准。未经您确认，磁盘上不会有任何变化。这套权限机制，再配合能拦截强制推送、破坏性 shell 命令等危险操作的钩子，使 Claude Code 足以胜任生产环境的工作。我自己每天都在服务真实用户的项目上使用 Claude Code。关键在于：从 Ask 模式起步，在批准之前弄清每次工具调用到底做了什么，然后只把您真正信任的操作逐步加入白名单。版本控制是最后一道安全网：在开始任何重要的 Claude Code 会话之前先提交一次，这样您随时可以回退。

新手最常犯的错误是什么？

把本该写进 CLAUDE.md 的内容统统塞进提示词里。新手往往把整套编码规范粘贴到每一条提示词中，既浪费上下文窗口，也让不同会话之间的结果参差不齐。把反复用到的指令一次性挪进 CLAUDE.md，提示词则留给当次会话特有的诉求。第二常见的错误是把 Bash(*) 加入白名单，而不是具体命令。通配符式的 Bash 白名单会让 Claude 无需询问就能执行任意 shell 命令，权限机制也就形同虚设。

Anthropic, “ServiceNow chooses Claude to power customer apps and increase internal productivity.” anthropic.com/news/servicenow-anthropic-claude —— “rolling out Claude and Claude Code across its global workforce of more than 29,000 employees.” ↩
Allianz, “Allianz and Anthropic forge global partnership”，媒体通稿，2026年1月9日。allianz.com/en/mediacenter/news/media-releases/260109 ↩
Anthropic, “Advanced setup”（安装方式、系统要求、认证）。code.claude.com/docs/en/installation。推荐使用原生安装脚本；二进制文件位于 ~/.local/bin/claude；截至 v2.1.198，npm 包需要 Node.js 22 以上，且安装的是同一个原生二进制文件。检索日期 2026-08-08。来源：github.com/anthropics/claude-code ↩↩
Anthropic, “Claude Code Permissions.” code.claude.com/docs/en/permissions ↩↩
Anthropic, “Claude Code Hooks.” code.claude.com/docs/en/hooks ↩↩↩
Anthropic, “Pricing”（包含 Max 5x 与 Max 20x 的各档套餐）。anthropic.com/pricing；API token 费率见 platform.claude.com/docs/en/about-claude/pricing ↩↩↩
npm Documentation, “Resolving EACCES permissions errors when installing packages globally.” docs.npmjs.com/resolving-eacces-permissions-errors ↩
Anthropic, “Effective usage of Claude Code.” code.claude.com/docs/en/best-practices ↩
“AGENTS.md”，面向智能体指令的开放规范。agents.md ↩