返回市场
克劳德代码补全配置

克劳德代码补全配置

作者:arturo-ebuck11 星标更新:2025-09-01

项目介绍

Claude Code 完整安装设置

一个全面的、即插即用的 Claude Code 安装设置,包括所有配置、工具、MCP 服务器和全局内存系统。此仓库使您能够在任何安装了 WSL2/Ubuntu 的 Windows PC 上复制整个 Claude Code 安装。

🚀 快速开始

# 克隆仓库
git clone https://github.com/yourusername/claude-code-complete-setup.git
cd claude-code-complete-setup

# 运行自动设置脚本
./setup.sh

就这样!设置脚本会自动处理一切。

📋 包含内容

核心组件

  • Claude Code 命令行界面 - 最新版本,包含所有配置
  • 19 个活跃的 MCP 服务器 - 预配置并准备好使用
  • 全局内存系统 - 完整的知识库和文档
  • GitHub 工作流自动化 - 分支保护和自动化工作流
  • SuperClaude 框架 - 高级命令和角色系统
  • 安全配置 - Git 钩子、分支保护、安全默认设置

包含的 MCP 服务器

  1. 核心基础设施:文件系统、Git、时间、Docker
  2. AI 和搜索:顺序思考、Perplexity、Exa
  3. 网络和自动化:FireCrawl、Puppeteer、GitHub
  4. 生产力:Slack、Notion、Google Drive、Google Maps、Reddit
  5. 数据库和云服务:Postgres、AWS、Memory
  6. 创意:EverArt

目录结构

~/
├── .claude/                        # Claude 配置和 SuperClaude 框架
│   ├── CLAUDE.md                  # 用户指南
│   ├── COMMANDS.md                # SuperClaude 命令
│   ├── FLAGS.md                   # 标志参考
│   ├── PRINCIPLES.md              # 核心原则
│   ├── RULES.md                   # 操作规则
│   ├── MCP.md                     # MCP 服务器参考
│   ├── PERSONAS.md                # 角色系统
│   ├── ORCHESTRATOR.md            # 路由智能
│   └── MODES.md                   # 操作模式
├── .config/claude-code/           # MCP 服务器配置
│   └── claude_desktop_config.json # MCP  服务器定义
├── claude_global_memory/          # 持久内存系统
│   ├── knowledge/                 # 核心文档
│   ├── tools/                     # 自定义工具
│   ├── projects/                  # 项目特定记忆
│   ├── templates/                 # 可重用模板
│   └── logs/                      # 活动日志
└── claude-code-desktop02-setup/   # 设置基础设施
    ├── mcp-servers/              # MCP 服务器安装
    ├── scripts/                   # 实用脚本
    └── config/                    # 额外配置

🔧 先决条件

  • Windows 10/11 并启用 WSL2
  • 在 WSL2 中安装 Ubuntu
  • 在 WSL2 中安装 Git
  • Node.js 18+(如果缺少将被安装)
  • Python 3.8+(如果缺少将被安装)

📦 安装

自动安装(推荐)

  1. 在 WSL2 Ubuntu 中克隆此仓库

    git clone https://github.com/yourusername/claude-code-complete-setup.git
    cd claude-code-complete-setup
    
  2. 设置环境变量(可选):

    cp .env.example .env
    # 使用您的 API 密钥编辑 .env(或使用 Doppler)
    
  3. 运行设置脚本

    chmod +x setup.sh
    ./setup.sh
    

脚本将:

  • 安装所有依赖项
  • 设置 Claude Code 命令行界面
  • 配置所有 MCP 服务器
  • 复制全局内存系统
  • 设置 Git 钩子和安全性
  • 配置您的 IDE(Cursor/VS Code/Windsurf)

手动安装

如果您更喜欢手动控制,请参阅 MANUAL_SETUP.md

🔑 环境变量

设置支持三种管理密钥的方法:

  1. Doppler(推荐):自动密钥管理
  2. 环境文件:从 .env.example 创建 .env
  3. 系统环境:在您的 shell 中导出变量

所需变量:

  • GITHUB_TOKEN - 用于 GitHub MCP 服务器
  • PERPLEXITY_API_KEY - 用于 Perplexity 搜索(可选)
  • 使用特定 MCP 服务器所需的其他 API 密钥

🎯 安装后

验证安装

# 检查 Claude Code
claude --version

# 列出 MCP 服务器
claude mcp list

# 测试简单命令
claude "Hello, test my setup"

IDE 集成

Cursor

  • 设置将自动配置
  • 安装后重启 Cursor

VS Code

  • 安装 Claude Code 扩展
  • 配置将自动检测

Windsurf

  • 按照文档中的 IDE 特定设置进行操作

🛡️ 安全功能

  • 分支保护:防止直接提交到主分支
  • Git 钩子:预提交和预推送验证
  • 安全默认设置:适当的文件权限(600)
  • 无硬编码密钥:使用环境变量
  • 审计日志:跟踪所有操作

🚨 重要说明

  1. 主分支保护:系统强制执行严格的分支保护。您不能直接提交到主分支。
  2. 并行处理:系统使用并行代理以提高性能 6 倍。
  3. 自主操作:设计为零人工干预。

🔄 更新

要更新您的安装:

cd claude-code-complete-setup
git pull
./update.sh

🐛 故障排除

常见问题

  1. 权限拒绝

    chmod +x setup.sh
    sudo chown -R $USER:$USER ~/.claude ~/.config/claude-code ~/claude_global_memory
    
  2. 未找到 MCP 服务器

    # 重新启动 Claude Code
    claude restart
    
  3. Doppler 认证

    • WSL2 有密钥环限制
    • 使用环境变量作为备用方案

更多解决方案请参阅 TROUBLESHOOTING.md

📚 文档

🤝 贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 进行更改
  4. 提交拉取请求

📄 许可证

MIT 许可证 - 查看 LICENSE 文件

🙏 致谢

  • Anthropic 为 Claude Code
  • 所有 MCP 服务器贡献者
  • Claude Code 社区

系统等级:A(95/100)- 具备全面自动化的企业级设置