Claude Code 安装与配置完全指南【2026】

详细讲解如何在 macOS、Linux 和 Windows 上安装 Claude Code，涵盖原生安装包、npm、Homebrew、身份验证、MCP 配置及 AnyCap 智能体能力扩展方法。

开发者终端在深色显示器上显示 Claude Code CLI 安装界面，带有绿色成功提示信息

Claude Code 是 Anthropic 推出的基于终端的 AI 编程智能体。 它能读取您的代码库、编辑真实文件、运行 Shell 命令并管理 git——全程在命令行中完成。无需浏览器标签页，无需复制粘贴。

本指南涵盖所有安装方式（原生安装包、npm、Homebrew）、身份验证、配置，以及最关键的——安装后应该做什么，将 Claude Code 从编程助手升级为具备图像生成、视频、网络搜索和云存储能力的全功能多模态智能体。

前提条件

安装前，请确认您已具备：

操作系统：macOS 13+（Ventura）、Ubuntu 20.04+ / Debian 10+，或搭载 WSL 的 Windows 10（1809+）
内存：最低 4 GB，处理大型代码库建议 8 GB
网络连接：所有 AI 处理均在 Anthropic 的云基础设施上运行——断网则无法使用 Claude Code
Anthropic 账户：Claude Pro（20 美元/月）、Max（100–200 美元/月）、Teams、Enterprise 或 Console（API）账户。免费版 Claude.ai 不包含 Claude Code。选择方案请参考Claude Code 定价方案对比。
终端：Bash、Zsh 或 PowerShell
Node.js 18+：仅在使用 npm 安装方式时需要

无需 GPU。您的设备仅运行轻量级 CLI 客户端，所有 AI 计算均在服务器端完成。

第一步：安装 Node.js（仅 npm 方式需要）

如果您打算使用原生安装包——目前 Anthropic 推荐的方式——请直接跳过此步骤。原生安装包无任何依赖项。

npm 用户请先检查 Node 版本：

node --version

若输出显示 v18.0.0 或更高版本，直接进入第二步。否则，请通过 nvm（Node 版本管理器）安装以避免权限问题：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

关闭并重新打开终端后：

nvm install 22
nvm use 22
node --version  # Should show v22.x.x

Node.js 22 是当前的 LTS 版本，与 Claude Code 完全兼容。

第二步：安装 Claude Code

三种安装方式，任选其一。

方式 A：原生安装包（推荐）

零依赖，后台自动更新。这是 Anthropic 主要测试和支持的安装方式。

macOS 和 Linux：

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

Windows（PowerShell，以管理员身份运行）：

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

安装包会将 claude 可执行文件添加到您的 PATH 并配置自动更新。从开始到完成不超过一分钟。

方式 B：Homebrew（macOS / Linux）

brew install --cask claude-code

注意：Homebrew 安装不会自动更新。请定期运行 brew upgrade claude-code。

方式 C：npm

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

请勿使用 sudo。 如果遇到 EACCES 权限错误，解决方案是使用 nvm——而非以 root 身份运行 npm。root 拥有的 npm 目录会引发级联权限问题。

验证安装

确认安装成功：

claude --version

完整的环境诊断：

claude doctor

第三步：身份验证

claude

首次启动时，Claude Code 会打开浏览器进行 OAuth 认证。登录您的 Anthropic 账户并授权 CLI，即可完成连接。

认证方式

浏览器 OAuth（默认）： 适合个人设备。支持 Pro、Max、Teams 和 Enterprise 账户。授权后，会话令牌将存储在本地。

API 密钥（CI/CD 及无头环境）： 适用于无法使用浏览器的服务器、容器或流水线：

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

请在 console.anthropic.com 生成密钥。API 用量按 Anthropic 标准费率按 token 计费。订阅与 API 计费的详细对比，请参阅Claude Code 定价指南。

如何选择计费方式？ 订阅（Pro/Max）日常使用更简便，月度计划中已包含 Claude Code。API 计费适合需要精细控制的可变或自动化工作负载。

第四步：您的第一个 Claude Code 会话

切换到任意项目目录：

cd ~/my-project
claude

Claude Code 会读取您的项目结构并启动交互式 REPL。从低风险的操作开始：

> Explain the architecture of this project

它会扫描您的文件，识别技术栈，并给出结构性概述。再尝试有实际影响的操作：

> Add input validation to the user registration form

Claude Code 会识别相关文件，提出修改方案，并等待您确认。在接受前，您可以在 diff 视图中逐一审查每处变更——它不会盲目覆盖文件。

若要在不进入交互模式的情况下执行单次任务，使用 -p（打印）标志：

claude -p "Write unit tests for the auth module"

执行任务，输出结果，然后退出。非常适合脚本编写和 CI/CD 流水线。

第五步：配置 Claude Code

模型选择

Claude Code 默认使用最新可用模型。如需覆盖：

# 设置默认模型
claude config set model claude-opus-4-7

# 或仅在当前会话中使用
claude --model claude-sonnet-4-6

权限设置

Claude Code 在写入文件或运行命令前会请求确认。如果您信任某个项目：

claude config set permissions.auto-accept-edits true

可提升速度，但不适合在生产代码上操作。关于所有权限模式、子智能体和钩子的深入介绍，请参阅Claude Code 高级功能指南。

项目级设置

在项目根目录创建 .claude/settings.json 用于团队共享配置（请提交此文件）：

{
  "permissions": {
    "allow": ["read", "write", "shell"],
    "deny": ["shell:rm -rf *"]
  },
  "model": "claude-sonnet-4-6",
  "environment": {
    "NODE_ENV": "development"
  }
}

个人覆盖配置（不应提交）请使用 .claude/settings.local.json。

CLAUDE.md

影响最大的配置项。在项目根目录创建 CLAUDE.md 文件，为 Claude 提供持久性上下文：构建命令、代码规范、架构决策。在 Claude Code 内运行 /init 可自动生成，然后再进行定制。

优秀的 CLAUDE.md 简洁明了——目标 50–100 行。对每一行问自己：「删掉这行会让 Claude 犯错吗？」如果不会，就删掉。

各平台安装说明

macOS

支持 Apple Silicon（M1–M4）和 Intel Mac。原生安装包是最简洁的方式：

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

Linux

支持 Ubuntu 20.04+、Debian 10+ 及大多数现代发行版。使用与 macOS 相同的原生安装包。旧版发行版请使用 nvm 配合 npm 安装。

Windows

方式一：原生 PowerShell 安装包

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

方式二：WSL（推荐，可获得完整 Linux 兼容性）

wsl --install
# 重启后，在 WSL 终端中：
curl -fsSL https://claude.ai/install.sh | bash

Docker

FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code

运行时，请以环境变量方式传入 API 密钥——不要将其内置到镜像中。

CI/CD（GitHub Actions 示例）

- name: AI Code Review
  run: |
    npx @anthropic-ai/claude-code -p "Review this PR for bugs" --output-format json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

IDE 集成

Claude Code 以终端为核心，但 IDE 插件可提供原生 diff 查看体验。

VS Code： 在扩展面板中搜索安装「Claude Code」，或：

code --install-extension anthropic.claude-code

JetBrains： 设置 → 插件 → Marketplace → 搜索「Claude Code」→ 安装。变更将显示在 IDE 的原生 diff 查看器中。

安装之后：为 Claude Code 赋予智能体能力

大多数安装指南到此为止。Claude Code 已安装、已认证、正在运行——但仅限于基础 CLI 提供的功能：文件编辑、Shell 命令、git 操作。

Claude Code 默认无法做到的事：

生成图像或编辑照片
创建或分析视频
搜索实时网络
在云存储中存取文件
向网络发布内容

这些能力需要 MCP 服务器（Model Context Protocol，模型上下文协议）。MCP 是让 AI 智能体连接外部工具的开放标准。Claude Code 原生支持 MCP——配置服务器后，Claude 可直接调用它们。完整操作指南请参阅使用 MCP 为 Claude Code 添加能力的指南。

快速方式：AnyCap Agent CLI

无需逐一配置单独的 MCP 服务器，只需一条命令即可为 Claude Code 提供完整的智能体能力套件：

npx -y skills add anycap-ai/anycap -a claude-code

此命令安装 AnyCap 智能体能力运行时，让 Claude Code 获得以下访问权限：

能力	功能说明	示例
图像生成	根据文字提示创建和编辑图像	"为登录页生成主视觉图"
视频生成	从文字或图像制作视频	"制作产品演示流程视频"
网络搜索	搜索和抓取实时互联网内容	"查找最新 API 变更"
云存储	上传、分享和获取文件	"存储项目资源并生成分享链接"
网页发布	将内容部署到网络	"将更新日志发布为网页"

一个 CLI，一次认证，全部能力。 无需为图像生成、视频、搜索和存储分别管理 API 密钥——AnyCap 通过单次安装统一处理所有这些。MCP 集成的深度介绍（含手动服务器配置选项），请参阅MCP 能力指南。

手动 MCP 配置

如果您希望单独配置 MCP 服务器，请将其添加到项目根目录的 .mcp.json：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

或以交互方式添加：

claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp list
claude mcp get github

故障排查

问题	解决方案
「command not found: claude」	打开新的终端窗口。若仍无效，重新运行安装包或检查 PATH。
Node.js 版本过低	`nvm install 22 && nvm use 22`
npm EACCES 错误	绝对不要使用 `sudo`。请改用 nvm。
浏览器未打开进行认证	使用 API 密钥：`export ANTHROPIC_API_KEY=sk-ant-...`
安装过程中出现网络错误	检查代理设置。设置 npm 镜像源：`npm config set registry https://registry.npmjs.org/`
Claude Code 运行缓慢	Anthropic API 的网络延迟问题。查看 `status.anthropic.com`。如有 VPN，请尝试断开。

在手动调试前先运行 claude doctor——它能自动检测大多数配置问题。

保持 Claude Code 更新

原生安装包： 自动更新，无需任何操作。通过 claude --version 查看当前版本。

npm： npm update -g @anthropic-ai/claude-code

Homebrew： brew upgrade claude-code

下一步

Claude Code 已安装完成。接下来：

生成 CLAUDE.md — 在 Claude Code 内运行 /init，为其提供持久性项目上下文。
添加智能体能力 — 安装 AnyCap，为 Claude Code 赋予图像生成、视频、搜索和存储能力。参阅MCP 能力指南。
尝试真实任务 — 选一个通常需要 20 分钟的工作，看看 Claude 如何处理。

Claude Code vs Cursor：2026 年哪款 AI 编程智能体更胜一筹？ — 终端原生智能体与 IDE 分叉对比。比较自主性、上下文处理、定价、实际任务及各自适用场景。
Claude Code 高级功能：子智能体、自动批准与 Bash 模式 — 掌握并行处理子智能体、加速工作流的自动批准以及获取完整 Shell 访问权限的 Bash 执行。
如何使用 MCP 为 Claude Code 添加智能体能力 — 逐步 MCP 配置指南，以及 AnyCap 一键快速部署图像生成、视频、网络搜索和云存储的方法。
Claude Code 定价与方案对比 — Pro（20 美元/月）、Max（100–200 美元/月）、Teams、Enterprise 和 API 计费的完整分析。
Claude Code 速率限制与 Token 限制详解 — 保持高效并避免触及速率限制和会话上限的实用策略。

Claude Code 是将 AI 融入开发工作流而无需切换工具的最快方式。一旦配置完成，效果立竿见影。

如何安装和配置 Claude Code：完整指南（2026年）