Claude Code 完整入门手册：安装、配置与实战指南

node -v
npm -v

# 使用winget安装（推荐）
winget install OpenJS.NodeJS

# 或使用Chocolatey
choco install nodejs

# 验证安装
node --version
npm --version

# 使用Homebrew安装（推荐）
brew install node

# 或使用MacPorts
sudo port install nodejs20

# 验证安装
node --version
npm --version

# 使用包管理器
sudo apt-get update
sudo apt-get install nodejs npm

# 或使用NodeSource官方仓库（获得最新版本）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm

npm config set registry https://registry.npmmirror.com
npm config set disturl https://registry.npmmirror.com/dist
npm config set sass_binary_site https://registry.npmmirror.com/mirrors/node-sass

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

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

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

brew install anthropic/claude-code/claude-code

winget install Anthropic.ClaudeCode

cd your-project
claude

$env:ANTHROPIC_API_KEY="your-zhipu-api-key"
$env:ANTHROPIC_API_BASE="https://open.bigmodel.cn/api/paas/v4"
$env:ANTHROPIC_MODEL="glm-5"

export ANTHROPIC_API_KEY="your-zhipu-api-key"
export ANTHROPIC_API_BASE="https://open.bigmodel.cn/api/paas/v4"
export ANTHROPIC_MODEL="glm-5"

{
  "model": "glm-5",
  "apiKey": "your-zhipu-api-key",
  "apiBase": "https://open.bigmodel.cn/api/paas/v4",
  "env": {
    "ANTHROPIC_API_KEY": "your-zhipu-api-key",
    "ANTHROPIC_API_BASE": "https://open.bigmodel.cn/api/paas/v4"
  }
}

{
  "model": "glm-5",
  "apiBase": "https://open.bigmodel.cn/api/paas/v4"
}

{
  "model": "qwen-max",
  "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "your-qwen-api-key"
}

{
  "model": "ernie-bot-4",
  "apiBase": "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/chat",
  "apiKey": "your-baidu-api-key"
}

{
  "model": "local-model",
  "apiBase": "http://localhost:8000",
  "apiKey": "optional-key"
}

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

# 查看当前模型
/settings

# 临时切换到Opus（深度推理）
/model opus

# 临时切换到Sonnet（日常任务）
/model sonnet

# 查看成本
/cost

# 添加marketplace
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/plugin install everything-claude-code@everything-claude-code

# 克隆项目
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# 安装依赖
npm install

# Windows PowerShell（完整安装）
.\install.ps1 --profile full

# 或仅安装特定语言
.\install.ps1 typescript python golang

# macOS/Linux
./install.sh --profile full
./install.sh typescript python golang

# 规划与设计
/plan "Add user authentication"
/architect "Design database schema"

# 开发流程
/tdd "Design test cases"
/code-review "Review my implementation"
/build-fix "Fix compilation errors"
/e2e "Generate Playwright tests"

# 学习与优化
/learn "Extract patterns from session"
/learn-eval "Evaluate patterns"
/verify "Run verification loop"

# 多模型编排
/multi-plan "Decompose complex task"
/multi-execute "Execute with team"
/multi-backend "Backend-focused workflow"
/multi-frontend "Frontend-focused workflow"

# 工具集成
/setup-pm "Configure package manager"
/skill-create "Generate skills from git"
/pm2 "Manage services with PM2"

# 持续学习
/instinct-status "View learned patterns"
/instinct-export "Export instincts"
/instinct-import "Import from others"
/evolve "Cluster into skills"

# 仅安装通用rules
mkdir -p ~/.claude/rules
cp -r everything-claude-code/rules/common ~/.claude/rules/

# 或安装特定语言的rules
cp -r everything-claude-code/rules/typescript ~/.claude/rules/
cp -r everything-claude-code/rules/python ~/.claude/rules/
cp -r everything-claude-code/rules/golang ~/.claude/rules/

# 项目级安装（当前项目优先）
mkdir -p .claude/rules
cp -r everything-claude-code/rules/common .claude/rules/
cp -r everything-claude-code/rules/typescript .claude/rules/

# 查看hooks
cat everything-claude-code/hooks/hooks.json

# 复制全部hooks到settings.json的hooks字段

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    },
    "supabase": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-supabase"],
      "env": {
        "SUPABASE_URL": "your-url",
        "SUPABASE_KEY": "your-key"
      }
    }
  }
}

# 已包含在installation中，常用skills：
# continuous-learning-v2 - 自动学习patterns
# frontend-patterns - React最佳实践  
# backend-patterns - API/数据库patterns
# security-scan - 安全审计
# tdd-workflow - 测试驱动开发

# 将skill放入配置目录
mkdir -p ~/.claude/skills/
cp -r skill-name ~/.claude/skills/

# 验证skill元数据
head ~/.claude/skills/skill-name/SKILL.md

# 启动Claude Code会话（自动加载）
claude

import anthropic

client = anthropic.Anthropic(api_key="your-key")

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    skills=["frontend-design", "research-lookup"],
    messages=[{
        "role": "user",
        "content": "Create a landing page for a SaaS product analyzing climate data"
    }]
)

---
name: my-awesome-skill
description: 简洁描述这个skill的用途和何时使用
keywords: ["keyword1", "keyword2"]
---

# My Awesome Skill

完整描述skill的功能和能力。

## 何时使用此Skill

- 使用场景1
- 使用场景2
- 使用场景3

## 使用说明

详细的Claude执行此skill的指导（写给Claude，不是写给用户）

## 示例

展示此skill实际应用的例子

cp -r my-skill ~/.claude/skills/

# ✅ 只安装一次通用技能
# example-skills 已包含于 everything-claude-code
# document-skills 已包含于 everything-claude-code

# ❌ 避免重复
# 不要同时安装 anthropic-agent-skills 和 everything-claude-code
# 不要同时安装 awesome-claude-skills 的duplicate skills

# 检查已安装技能
ls ~/.claude/skills/

# 清理重复技能
rm -rf ~/.claude/skills/skill-name  # 保留最常用的版本

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx"
      }
    },
    
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    },
    
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-memory"]
    },
    
    "supabase": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-supabase"],
      "env": {
        "SUPABASE_URL": "https://xxx.supabase.co",
        "SUPABASE_KEY": "eyxxx"
      }
    },

    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["@upstash/context7-mcp"],
      "env": {
        "UPSTASH_REDIS_REST_URL": "https://xxx.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "xxx"
      }
    }
  }
}

from fastmcp import FastMCP
from typing import Any

app = FastMCP("my-service")

@app.tool()
def analyze_code(code: str) -> str:
    """分析代码质量"""
    return f"分析结果: {code[:50]}..."

@app.resource("file:///{path}")
def read_file(path: str) -> str:
    """读取文件内容"""
    with open(path) as f:
        return f.read()

if __name__ == "__main__":
    app.run()

import { MCPServer, Tool } from "@modelcontextprotocol/sdk/server/mcp.js";

const server = new MCPServer({
  name: "my-service",
  version: "1.0.0"
});

server.tool("analyze_code", {
  description: "分析代码质量",
  inputSchema: {
    type: "object",
    properties: {
      code: { type: "string" }
    }
  },
  execute: async (args) => {
    return `分析结果: ${args.code.substring(0, 50)}...`;
  }
});

server.start();

{
  "mcpServers": {
    "my-service": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/my_service.py"]
    }
  }
}

# 1. 使用Planner设计方案
/planner "Add OAuth2 authentication to Next.js app"

# 2. Claude会生成详细计划
# - 选择OAuth提供商
# - 实现flow
# - 处理token管理
# - 添加错误处理
# - 编写测试

# 3. 执行实现
# Claude自动实现每个步骤

# 4. 使用Code-Reviewer审查
/code-review "Review my OAuth implementation"

# 5. 修复发现的问题

{
  "features": {
    "multi_agent": true,
    "agent_delegation": true,
    "context_sharing": true
  },
  "agents": {
    "planner": {
      "role": "system designer",
      "model": "opus",
      "max_iterations": 5
    },
    "executor": {
      "role": "implementation",
      "model": "sonnet",
      "max_iterations": 10
    },
    "reviewer": {
      "role": "quality gate",
      "model": "opus",
      "max_iterations": 3
    }
  }
}

# 智能分解复杂任务
/multi-plan "Build production-grade REST API with auth, database, tests, deployment"

# 协调执行
/multi-execute

# 后端specific流程
/multi-backend "Implement microservices with Docker, K8s, monitoring"

# 前端specific流程
/multi-frontend "Build React dashboard with real-time data, charts, exports"

---
name: my-specialized-agent
description: 专注于特定领域的agent
model: opus
tools: ["Read", "Grep", "Bash", "Edit"]
---

# My Specialized Agent

你是一个专营X领域的专家AI助手。

## 专业领域

详细描述你的专业领域和特殊能力。

## 工作流程

列出你处理任务的标准流程：

1. 第一步 - ...
2. 第二步 - ...
3. 第三步 - ...

## 专业知识点

- 关键概念1及最佳实践
- 关键概念2及常见坑
- 关键概念3及性能优化

## 通信风格

你应该如何与用户沟通（正式/非正式/技术性等）

# 1. 进入项目
cd my-project
claude

# 2. 制订计划
/multi-plan "Implement OAuth2 + JWT authentication for REST API"

# 3. 查看生成的计划
# Claude会分解为10+具体任务

# 4. 执行实现
/multi-execute

# 5. 运行测试
npm test

# 6. 代码审查
/code-review

# 7. 安全审计  
/security-scan

# 8. 创建提交
git add .
git commit -m "feat: OAuth2 authentication"
git push

# 9. 提交PR
gh pr create --title "OAuth2 Authentication System"

# 1. 启动调试
claude

# 2. 分析错误
# Claude自动读取错误日志、堆栈跟踪

# 3. 诊断根因
/root-cause-tracing "Debug memory leak in event listeners"

# 4. 实现修复
# Claude生成修复代码

# 5. 验证修复
npm test
npm run dev  # 本地测试

# 6. TDD流程（未来bug预防）
/tdd "Design tests for this component"
/e2e "Generate integration tests"

# 1. 启动重构会话
claude

# 2. 分析现有代码
/semantic-analysis "Analyze this codebase for improvements"

# 3. 制订重构计划
/plan "Refactor authentication module for testability and performance"

# 4. 自动清理
/refactor-clean "Remove dead code and unused dependencies"

# 5. 迁移到新模式
/code-migration "Migrate from Redux to TanStack Query"

# 6. 完整测试
/verify  # 运行lint、test、typecheck、security scan

# 7. 性能对比
/benchmark "Compare performance before and after"

# 1. 启动会话
claude

# 2. 自动更新API文档
/update-docs "Sync API documentation with code changes"

# 3. 生成changelog
/changelog-generator

# 4. 创建migration指南
/doc-coauthoring "Write migration guide from v2 to v3"

# 5. 发布变更
git add docs/ CHANGELOG.md
git commit -m "docs: Update API documentation"

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

# 每个无关任务之间清理context
/clear

# 在逻辑断点压缩context  
/compact

# 只在新会话启用高思考
/model opus  # 仅用于架构决策

# 学习完毕后导出instincts
/instinct-export > my-team-instincts.json

# 其他人导入
/instinct-import ./my-team-instincts.json

# 会话中自动学习patterns
/learn "Extract best practices from this session"

# 评估patterns质量
/learn-eval "Grade and store high-confidence patterns"

# 查看学到的patterns
/instinct-status

# 导出供团队使用
/instinct-export

# 集群相关patterns为skills
/evolve "Turn learned instincts into reusable skills"

{
  "sharedContext": {
    "teamRules": ".claude/team-rules.md",
    "architecture": "docs/ARCHITECTURE.md",
    "conventions": "docs/CONVENTIONS.md"
  },
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "team-token"
      }
    }
  }
}

# 验证API Key
$env:ANTHROPIC_API_KEY  # Windows PowerShell

# 测试连接
curl -X GET https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY"

# 检查network
ping api.anthropic.com

# 清除插件缓存
rm -rf ~/.claude/plugins-cache

# 重新启动Claude Code
claude

# 验证installation
/plugin list

// 增加超时时间
{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "...",
        "TIMEOUT": "30000"  // 30秒
      }
    }
  }
}

# 查看成本
/cost

# 切换到更便宜的模型
/model sonnet

# 压缩context
/compact

# 清理旧会话
/sessions  # 列出所有会话
# 垃圾回收旧会话内存

# 基础
claude                          # 启动会话
/clear                         # 清理context
/model sonnet                  # 切换模型
/cost                          # 查看费用

# 规划与设计  
/plan "your task"              # 制订实现计划
/architect "design task"       # 系统设计
/tdd "feature"                 # 测试驱动开发

# 开发工作流
/code-review                   # 代码审查
/security-review               # 安全审查
/build-fix                     # 修复构建错误
/e2e "test spec"              # E2E测试生成

# 持续学习
/learn                         # 提取patterns
/instinct-status               # 查看学习内容
/instinct-export               # 导出patterns
/evolve                        # 聚类为skills

# 多模型协调
/multi-plan                    # 多agent规划
/multi-execute                 # 多agent执行
/multi-backend                 # 后端工作流
/multi-frontend                # 前端工作流

# 插件与集成
/plugin list                   # 列表已安装插件
/plugin install X@X            # 安装插件
/settings                      # 查看配置

// ~/.claude/settings.json 标准配置
{
  "model": "sonnet",
  "apiKey": "your-api-key",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  },
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "xxx"}
    }
  },
  "rules": [".claude/rules"],
  "skills": [".claude/skills"]
}