ClaudeCode安装教程

ClaudeCode安装教程_Windows10

| 深谙代码工程逻辑，可深度协同开发的 AI 助手

▲ Claude Code 核心架构全景图

本文速览

本文基于 Windows 10 真实环境，手把手带你从零安装 Claude Code，涵盖 3 种安装方式（PowerShell / CMD / WinGet）、5 种使用界面、GitHub MCP 扩展配置、CLAUDE.md 私人知识库搭建，以及 9 大常见问题解决方案。读完即可上手，让 AI 真正替你写代码。

— · — · —

01 Claude Code 是什么？5 种使用界面全覆盖

02 安装前准备系统要求 + Git 依赖检测

03 安装 Claude CodePowerShell / CMD / WinGet 三种方式

04 首次启动与登录Anthropic 账号配置

05 核心功能一览7 大核心能力矩阵

06 配置 MCP 扩展GitHub MCP 配置实战

07 高级定制CLAUDE.md / 环境变量 / Hooks

08 常见问题 FAQ9 大核心问题解决方案

09 进阶：多 Agent 协作/subtask 并行任务分配

10 总结与下一步完成清单 + 进阶路线图

▼

| 01 Claude Code 是什么？

Claude Code 是 Anthropic 出品的 agentic（主动式）编程工具。它能理解你的整个代码库，跨文件分析问题，自动编写代码、运行命令、管理 Git，甚至帮你创建完整的 PR。

使用方式	说明	适用场景
Terminal CLI	完整功能的命令行工具	深度开发、自动化脚本
VS Code / Cursor	IDE 插件，内联 diff	日常编码、代码审查
JetBrains IDE	IntelliJ/PyCharm 插件	Java/Python 开发
Desktop App	桌面客户端，可视化界面	多会话管理、定时任务
Web	浏览器在线使用	快速试用、远程协作

| 02 安装前准备

2.1 系统要求

项目	最低要求	推荐配置
操作系统	Windows 10（64位）	Windows 11
内存	8GB RAM	16GB+ RAM
磁盘空间	200MB+	500MB+ SSD
网络	需联网	稳定宽带

2.2 前置依赖

Claude Code 必须安装 Git for Windows：

git --version

正常输出：

git version 2.44.0.windows.1

下载地址：https://git-scm.com/download/win

| 03 第一步：安装 Claude Code

3.1 PowerShell 安装（推荐）

打开 PowerShell，执行：

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

3.2 CMD 安装

curl -fsSL https://claude.ai/install.cmd -o install.cmd

install.cmd

del install.cmd

3.3 WinGet 安装

winget install Anthropic.ClaudeCode

3.4 验证安装

claude --version

claude --help

| 04 第二步：首次启动与登录

在项目目录中运行：

cd your-project

claude

首次启动会引导你登录 Anthropic 账号，或配置 API Key。登录后即可使用。

| 05 第三步：核心功能一览

功能	说明	命令示例
代码解释	理解任意代码的逻辑	claude "解释这段代码"
Bug 修复	根据错误信息定位根因	claude "修复这个 bug"
写测试	自动生成单元测试	claude "为 auth 模块写测试"
Git 操作	commit / branch / PR	claude "提交我的更改"
定时任务	定期自动化任务	/schedule review PR
管道操作	管道输出到 Claude	tail -f log \| claude -p "分析"
MCP 扩展	连接外部数据源	claude "查 Jira 最新 ticket"

| 06 第四步：配置 MCP 扩展

MCP（Model Context Protocol）是连接外部工具的开放标准。

安装 GitHub MCP

npx @anthropic-ai/github-mcp-server

配置 claude.json

{

"mcpServers": {

"github": {

"command": "npx",

"args": ["@anthropic-ai/github-mcp-server"]

}

| 07 第五步：高级定制

7.1 CLAUDE.md

CLAUDE.md

项目概述

这是一个 React + Node.js 项目

编码规范

使用 TypeScript

函数式组件优先

构建命令

npm run dev

7.2 环境变量

变量	说明
ANTHROPIC_API_KEY	Anthropic API 密钥
CLAUDE_MODEL	默认使用的模型
HTTP_PROXY	代理配置

7.3 Hooks

在提交前自动 lint

claude config set hooks.pre-commit "npm run lint"

| 08 常见问题 FAQ

Q1：claude 不是内部或外部命令？

$env:Path += ";$env:LOCALAPPDATA\Programs\Claude Code"

Q2：如何更新？

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

或 winget

winget upgrade Anthropic.ClaudeCode

Q3：如何卸载？

winget uninstall Anthropic.ClaudeCode

Q4：支持离线吗？

Claude Code 需联网。但可配合 Ollama 等本地模型使用。

| 09 进阶：多 Agent 协作

Claude Code 支持多个 Agent 并行工作，用 /subtask 启动子任务：

/subtask "分析 auth 模块的依赖关系"

也可通过 Claude Code Agent SDK 构建自定义工作流。

| 10 总结与下一步

序号	完成项	状态
1	已了解 Claude Code 核心概念	已完成
2	已掌握多种安装方式	已完成
3	已完成首次登录	已完成
4	已了解核心功能	已完成
5	已掌握 MCP 配置	已完成
6	已了解高级定制	已完成

阶段	目标
入门	熟练 CLI 基本命令
进阶	MCP + Skills 定制
专家	Agent SDK 集成

你的智能编程之旅，才刚刚开始。