Claude Code 安装指南

用官方原生安装器装好 Claude Code，完成登录，并跑通第一个「读代码 → 小改动 → 验证」开发闭环。

概述

Claude Code 是 Anthropic 推出的终端 AI 编程助手：在项目目录里用自然语言让 Agent 读代码、改文件、跑命令。本篇覆盖安装、登录与入门开发流；进阶工作流（CLAUDE.md 精简、hooks、skills）见站内《Claude Code 日常使用技巧》。

前置条件

• macOS / Linux / WSL，或 Windows（推荐 PowerShell）
• Anthropic 账号（或团队提供的 API / 代理配置）
• 项目最好已用 Git 管理，便于审 diff 与回滚

npm 全局安装已弃用；优先使用官方原生安装器（后台自动更新，且不依赖 Node.js）。

安装与获取

macOS / Linux / WSL（推荐）：

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

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

装完后新开一个终端，确认 PATH 生效：

claude --version

若以前用过 npm install -g @anthropic-ai/claude-code，可在终端执行 claude install 迁移到原生安装并保留设置。更多选项见 Setup 文档。

首次配置

1. 进入任意项目目录，运行 claude
2. 按提示登录 Anthropic 账号（或配置 API Key / 企业端点）
3. 用 /init 生成脚手架式 CLAUDE.md（之后务必手改，见使用技巧篇）
4. 可选：安装编辑器扩展，与终端会话联动

核心用法

常用习惯：

• 大任务先让它列计划，再同意执行
• 用 @ 或明确路径收窄上下文，避免瞎改无关文件
• 每次改动后自己看 diff，再提交

开发实践

一次最小可用闭环：

1. cd 到 Git 仓库根目录，执行 claude
2. 让 Agent 解释模块边界与构建/测试命令
3. 提一个可验收的小需求（例如补一个单元测试或修一个明确 bug）
4. 审阅 diff → 跑测试 → git commit
5. 把反复要提醒的约定写进精简版 CLAUDE.md（技术栈、禁止事项、验证命令）

原则：小步提交、Agent 改代码、人把关质量。

常见问题

• claude 找不到：新开终端；检查安装器是否写入 ~/.local/bin 等 PATH
• 仍提示 npm 安装：执行 claude install 迁到原生安装
• 权限过宽：在设置中收紧允许的工具/路径，敏感目录用 deny 规则
• 上下文飘：任务说清「只改哪些目录」，并维护短 CLAUDE.md

延伸阅读

• Claude Code Overview
• Setup / Install
• 站内：Claude Code 日常使用技巧、Claude Code 资源页