1

# 确保 npm 全局安装路径在 PATH 中 echo $PATH | grep npm # 如果没有，添加到你的 shell 配置文件中 export PATH="$PATH:$(npm config get prefix)/bin"

1

# 确保 'code' 命令可用 code --version # 如果不可用，在 VS Code 中按 Cmd+Shift+P (Mac) 或 Ctrl+Shift+P (Windows/Linux) # 搜索 "Shell Command: Install 'code' command in PATH"

1

# 如果使用公司代理，配置 npm 代理 npm config set proxy http://proxy.company.com:8080 npm config set https-proxy http://proxy.company.com:8080

1

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

1

# 检查安装是否成功 claude --version # 应显示当前版本号，例如：1.0.66 或更新版本 # 快速功能测试 claude --help # 显示帮助信息确认安装正确

1

# 查看当前版本 npm list -g @anthropic-ai/claude-code # 查看可用版本 npm view @anthropic-ai/claude-code versions --json # 安装特定版本 npm install -g @anthropic-ai/claude-code@1.0.66 # 更新到最新版本 npm update -g @anthropic-ai/claude-code

1

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

1

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

1

# 验证安装 claude --version # 如果命令不可用，检查 PATH 设置 echo $PATH | grep claude # 手动添加到 PATH（如果需要） export PATH="$PATH:$HOME/.claude/bin"

1

# 注意：Claude Code 目前不是开源项目 # 本地开发安装目前仅通过官方渠道提供 # 如需定制开发，请联系 Anthropic 企业支持 # 替代方案：使用官方 SDK 进行集成开发 npm install @anthropic-ai/sdk # 验证 SDK 安装 node -e "console.log(require('@anthropic-ai/sdk'))"

1

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

1

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

1

npm install @anthropic-ai/sdk

1

# 从 npm 迁移到原生二进制 npm uninstall -g @anthropic-ai/claude-code curl -fsSL https://claude.ai/install.sh | sh # 确认迁移成功 which claude claude --version

1

# API Key 安全存储 chmod 600 ~/.bashrc # 限制配置文件权限 # 避免在代码中硬编码 API Key # 使用环境变量或安全的密钥管理系统

1

# 优化使用的技巧 # 1. 在 CLI 中使用上下文管理 claude -c # 继续上次对话，节省上下文重建 # 2. 合理使用模型切换 # Pro 用户只能使用 Sonnet 4 # Max 用户可以使用 Sonnet 4 或 Opus 4（通过 /model 命令切换） # 3. 批量处理任务 # 将相关任务合并处理，减少消息数量

1

# 安装 WSL2 wsl --install # 安装 Ubuntu（或你喜欢的发行版） wsl --install -d Ubuntu # 进入 WSL2 环境 wsl

1

# 更新包管理器 sudo apt update && sudo apt upgrade -y # 安装 Node.js 18+ curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # 安装 Claude Code npm install -g @anthropic-ai/claude-code # 配置 Git（如果还没有） git config --global user.name "Your Name" git config --global user.email "your.email@example.com"

1

# ~/.bashrc 或 ~/.zshrc 中添加 export PATH="$PATH:$(npm config get prefix)/bin" # 设置默认编辑器 export EDITOR="code --wait" # 如果使用 VS Code # 代理配置（如果需要） export HTTP_PROXY="http://your-proxy:port" export HTTPS_PROXY="http://your-proxy:port"

1

# 检查执行策略 Get-ExecutionPolicy # 如果太严格，调整执行策略 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 安装 Node.js（通过 Chocolatey 推荐） Set-ExecutionPolicy Bypass -Scope Process -Force [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072 iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) choco install nodejs # 安装 Claude Code npm install -g @anthropic-ai/claude-code

1

# 编辑 PowerShell 配置文件 notepad $PROFILE # 添加以下内容 # Claude Code 别名和函数 function cc { claude $args } function ccd { claude --continue } function ccr { claude --resume } # 设置代理（如果需要） $env:HTTP_PROXY = "http://your-proxy:port" $env:HTTPS_PROXY = "http://your-proxy:port"

1

# 确保 Git Bash 中 Node.js 可用 node --version npm --version # 如果不可用，修改 PATH export PATH="/c/Program Files/nodejs:$PATH" # 安装 Claude Code npm install -g @anthropic-ai/claude-code

1

# ~/.bashrc 文件中添加 export PATH="$PATH:/c/Users/$USERNAME/AppData/Roaming/npm" # 中文支持 export LANG=zh_CN.UTF-8 # 别名设置 alias cc='claude' alias ccd='claude --continue' alias ccr='claude --resume'

1

# 确保 Xcode Command Line Tools 已安装 xcode-select --install # 使用 Homebrew 管理包（如果还没有安装） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 安装 Node.js brew install node # 安装 Claude Code npm install -g @anthropic-ai/claude-code

1

# 安装 Oh My Zsh（可选，提升体验） sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" # 编辑 ~/.zshrc vim ~/.zshrc # 添加以下配置 export PATH="$PATH:$(npm config get prefix)/bin" # Claude Code 别名 alias cc='claude' alias ccd='claude --continue' alias ccr='claude --resume' # 命令补全（如果使用 Oh My Zsh） plugins=(git npm node vscode) # 自动补全配置 autoload -U compinit compinit

1

# 安装 iTerm2 brew install --cask iterm2 # 配置快捷键启动 Claude Code # iTerm2 -> Preferences -> Profiles -> Keys -> Key Mappings # 添加快捷键 Cmd+Shift+C -> Send Text: claude

1

# 如果遇到权限问题，检查并修复 npm 权限 sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} # 或者使用 n 管理 Node.js 版本（避免权限问题） sudo npm install -g n sudo n stable

1

# 更新包列表 sudo apt update # 安装 Node.js 18+ （官方仓库） curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # 或者使用 snap（更简单） sudo snap install node --classic # 安装 Claude Code npm install -g @anthropic-ai/claude-code # 安装其他有用的工具 sudo apt install -y git curl wget build-essential

1

# Fedora sudo dnf install nodejs npm # CentOS/RHEL (需要 EPEL) sudo yum install -y epel-release sudo yum install -y nodejs npm # 或者使用 NodeSource 仓库 curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash - sudo yum install -y nodejs # 安装 Claude Code npm install -g @anthropic-ai/claude-code

1

# 使用 pacman sudo pacman -S nodejs npm # 安装 Claude Code npm install -g @anthropic-ai/claude-code # 如果遇到权限问题，创建 npm 全局目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc

1

# 编辑 ~/.bashrc 或 ~/.bash_profile vim ~/.bashrc # 添加以下内容 export PATH="$PATH:$(npm config get prefix)/bin" # Claude Code 别名 alias cc='claude' alias ccd='claude --continue' alias ccr='claude --resume' # 自动补全（bash） if [ -f /etc/bash_completion ]; then . /etc/bash_completion fi # 重新加载配置 source ~/.bashrc

1

# 安装必要的终端工具 sudo apt install -y tmux screen # 配置 tmux 会话 tmux new-session -d -s claude-code tmux send-keys -t claude-code 'claude' C-m # 或者使用 screen screen -S claude-code -d -m claude # systemd 服务配置（可选） sudo tee /etc/systemd/system/claude-code.service < EOF [Unit] Description=Claude Code Service After=network.target [Service] Type=simple User=your-username WorkingDirectory=/home/your-username Environment=NODE_ENV=production # 注意：Claude Code 不支持 daemon 模式，以下仅为示例 # 实际部署中应使用 tmux 或 screen 来保持会话 ExecStart=/usr/bin/tmux new-session -d -s claude-code /usr/local/bin/claude Restart=always [Install] WantedBy=multi-user.target EOF sudo systemctl enable claude-code sudo systemctl start claude-code

1

# 增加 Node.js 内存限制 export NODE_OPTIONS="--max-old-space-size=4096" # 优化 npm 配置 npm config set registry https://registry.npmjs.org/ npm config set fetch-retries 5 npm config set fetch-retry-mintimeout 20000 npm config set fetch-retry-maxtimeout 120000

1

# 设置严格的配置文件权限 chmod 600 ~/.bashrc ~/.zshrc ~/.npmrc # 使用环境变量存储敏感信息 echo 'export ANTHROPIC_API_KEY="your-key-here"' > ~/.bash_profile chmod 600 ~/.bash_profile

1

# 在 VS Code 中打开集成终端（Ctrl+` 或 Cmd+`） # 确保终端位于项目根目录 claude # 首次运行时，Claude Code 会自动检测 VS Code 环境 # 并提示安装官方扩展，点击确认即可

1

# 方法1：通过 VS Code 扩展市场 # 打开 VS Code -> Extensions -> 搜索 "Claude Code" # 或直接访问：https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code # 方法2：通过命令行安装 code --install-extension anthropic.claude-code

1

// settings.json 中的推荐配置 { "claude-code.enableDiffView": true, "claude-code.autoShareSelection": true, "claude-code.autoShareDiagnostics": true, "claude-code.shortcutKeys": { "launch": "cmd+escape", "fileReference": "cmd+alt+k" }, "terminal.integrated.defaultProfile.osx": "bash", "terminal.integrated.defaultProfile.windows": "PowerShell" }

1

# 1. 确保 IDE 命令行工具已安装 # IntelliJ IDEA: idea # PyCharm: pycharm # WebStorm: webstorm # 等等... # 2. 从项目根目录的终端启动 Claude Code claude # 3. Claude Code 会自动检测并安装 JetBrains 插件

1

# 在 IDE 中： # File -> Settings -> Plugins -> Marketplace # 搜索 "Claude Code" 并安装 # 或通过 IDE 命令行工具： idea installPlugins com.anthropic.claude-code

1

// .idea/claude-code.xml 配置文件 application component name="ClaudeCodeSettings" option name="enableAutoContext" value="true" / option name="enableDiffIntegration" value="true" / option name="shareProjectStructure" value="true" / option name="launchShortcut" value="ctrl alt C" / /component /application

1

# 确保 cursor 命令可用 cursor --version # 从 Cursor 集成终端启动 claude # Claude Code 会自动检测 Cursor 环境

1

# 确保 windsurf 命令已安装 windsurf --version # 启动 Claude Code claude # 按提示完成集成配置

1

# VSCodium 是 VS Code 的开源版本 # 集成方式与 VS Code 完全相同 codium --install-extension anthropic.claude-code

1

# macOS - 通过 Karabiner-Elements 或系统快捷键 # Windows - 通过 AutoHotkey 或系统快捷键 # Linux - 通过桌面环境的快捷键设置 # 推荐快捷键组合： # Cmd/Ctrl + Shift + C - 启动 Claude Code # Cmd/Ctrl + Shift + R - 恢复上次会话

1

mkdir .claude touch .claude/CLAUDE.md # CLAUDE.md 内容示例： echo "# 项目 Claude Code 配置 ## 项目简介 这是一个 [项目类型] 项目，使用 [技术栈]。 ## 开发规范 - 代码风格：遵循 [ESLint/Prettier] 配置 - 测试要求：单元测试覆盖率 >80% - 提交规范：使用 Conventional Commits ## Claude Code 使用指导 - 优先使用 Claude Sonnet 4 进行日常开发 - 复杂问题可使用 `/model opus` 切换到 Opus 4 模型 - 重要修改前请先运行测试套件" > .claude/CLAUDE.md

1

# .gitignore 中添加个人配置 echo ".claude/local_config.json" >> .gitignore # 团队共享配置文件 cat > .claude/team_config.json < EOF { "preferredModel": "claude-sonnet-4", "autoRunTests": true, "codeStyle": "prettier", "maxContextLength": 100000 } EOF # 版本控制配置文件 git add .claude/CLAUDE.md .claude/team_config.json git commit -m "feat: add Claude Code team configuration"

1

# 启动 Claude Code 并在交互模式中配置性能设置 claude # 在交互会话中可以调整模型选择、上下文长度等设置 # 配置会自动保存到本地配置文件中

1

# 检查 VS Code CLI 是否可用 code --version # 如果不可用，安装 code 命令 # VS Code - Command Palette -> "Shell Command: Install 'code' command in PATH" # 手动安装扩展 code --install-extension anthropic.claude-code # 重启 VS Code 并重新启动 Claude Code

1

# 检查 IDE 命令行工具 idea --version # 或对应的 IDE 命令 # 确保从项目根目录启动 cd /path/to/your/project claude # 完全重启 IDE（重要！） # File -> Exit，然后重新打开项目

1

# macOS/Linux 权限修复 sudo chown -R $(whoami) ~/.claude chmod -R 755 ~/.claude # Windows 权限修复（管理员 PowerShell） icacls "%USERPROFILE%\.claude" /grant:r "%USERNAME%:(OI)(CI)F" /T

1

# 常见错误信息 npm ERR! code EACCES npm ERR! syscall mkdir npm ERR! path /usr/local/lib/node_modules/@anthropic-ai npm ERR! errno -13

1

# 方法1：修复 npm 权限（推荐） sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} # 方法2：使用 npm 的用户目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc # 方法3：使用 npx（临时解决） npx @anthropic-ai/claude-code --version

1

# 错误信息示例 Error: Claude Code requires Node.js 18.0.0 or higher Current version: v16.14.0

1

# 使用 n 管理 Node.js 版本（推荐） sudo npm install -g n sudo n stable # 安装最新稳定版 sudo n 18 # 或安装特定版本 # 使用 nvm（Node Version Manager） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 18 nvm use 18 nvm alias default 18 # 验证版本 node --version # 应显示 v18.x.x 或更高

1

# 常见错误 npm ERR! network request failed npm ERR! network This is a problem related to network connectivity

1

# 检查网络连接 curl -I https://registry.npmjs.org/ # 配置代理（如果需要） npm config set proxy http://proxy.company.com:8080 npm config set https-proxy http://proxy.company.com:8080 # 使用不同的 registry npm config set registry https://registry.npmmirror.com/ # 增加超时时间 npm config set fetch-retry-mintimeout 20000 npm config set fetch-retry-maxtimeout 120000 # 清除 npm 缓存 npm cache clean --force # 重新尝试安装 npm install -g @anthropic-ai/claude-code

1

# 错误信息 Error: Invalid API key provided Authentication failed with status: 401

1

# 1. 验证 API Key 格式 echo $ANTHROPIC_API_KEY # 应该以 sk-ant-api03- 开头 # 2. 检查 API Key 状态 curl -H "Authorization: Bearer $ANTHROPIC_API_KEY" \ -H "Content-Type: application/json" \ https://api.anthropic.com/v1/models # 3. 重新设置环境变量 unset ANTHROPIC_API_KEY export ANTHROPIC_API_KEY="sk-ant-api03-your-new-key-here" # 4. 永久保存 echo 'export ANTHROPIC_API_KEY="sk-ant-api03-your-new-key-here"' >> ~/.bashrc source ~/.bashrc

1

# 错误信息 Error: Subscription not found or expired Please check your Claude.ai subscription status

1

# 1. 检查订阅状态 # 访问 https://claude.ai/settings/billing # 2. 重新认证 claude --reauth # 3. 清除认证缓存 rm -rf ~/.claude/auth_cache claude # 重新启动认证流程 # 4. 检查账户是否正确 # 确保使用的是有 Pro/Team 订阅的账户

1

# AWS Bedrock 错误 Error: Access denied to bedrock:InvokeModel

1

# 1. 检查 AWS 凭证 aws sts get-caller-identity # 2. 验证 IAM 权限 aws iam simulate-principal-policy \ --policy-source-arn arn:aws:iam::ACCOUNT:user/USERNAME \ --action-names bedrock:InvokeModel \ --resource-arns "*" # 3. 重新配置 Claude Code 环境变量 export CLAUDE_CODE_USE_BEDROCK=1 export AWS_REGION=us-west-2 # 重新设置区域 # 4. 测试连接 aws bedrock list-foundation-models --region us-west-2

1

# 症状：Claude Code 响应时间超过 30 秒

1

# 1. 检查网络延迟 ping api.anthropic.com curl -w "@curl-format.txt" -o /dev/null -s https://api.anthropic.com/v1/models # 2. 优化 Node.js 内存 export NODE_OPTIONS="--max-old-space-size=4096" # 3. 清理上下文缓存 claude /compact # 在 Claude Code 会话中执行 # 4. 监控资源使用 top -p $(pgrep -f claude) # Linux Activity Monitor # macOS # 5. 重新启动会话 claude /clear

1

# 症状：Claude Code 进程占用超过 2GB 内存

1

# 1. 限制 Node.js 堆内存 export NODE_OPTIONS="--max-old-space-size=2048" # 2. 定期重启长时间运行的会话 # 每工作 2-3 小时重启一次 Claude Code # 3. 使用会话管理 claude --continue # 继续上次会话而不是创建新会话 claude /resume # 选择恢复特定会话 # 4. 清理临时文件 rm -rf ~/.claude/temp/* rm -rf ~/.claude/cache/*

1

# 错误：终端编码问题 Error: Invalid character encoding in terminal output

1

# 1. 设置正确的编码 export LANG=en_US.UTF-8 export LC_ALL=en_US.UTF-8 # 2. 终端配置（macOS） # iTerm2: Preferences -> Profiles -> Terminal -> Character Encoding -> UTF-8 # 3. Windows 控制台配置 chcp 65001 # 设置为 UTF-8 编码 # 4. Linux 系统编码 sudo locale-gen en_US.UTF-8 sudo update-locale LANG=en_US.UTF-8

1

#!/bin/bash # claude-code-diagnostic.sh echo "=== Claude Code 诊断报告 ===" echo "时间: $(date)" echo "" echo "=== 系统信息 ===" uname -a echo "" echo "=== Node.js 环境 ===" node --version npm --version npm config get prefix echo "" echo "=== Claude Code 状态 ===" which claude claude --version 2>&1 || echo "Claude Code 未安装或不可用" echo "" echo "=== 环境变量 ===" echo "ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:+已设置}" echo "PATH 中的 npm: $(echo $PATH | grep -o '[^:]*npm[^:]*')" echo "" echo "=== 网络连接测试 ===" curl -I -s --connect-timeout 5 https://api.anthropic.com/ || echo "无法连接到 Anthropic API" curl -I -s --connect-timeout 5 https://registry.npmjs.org/ || echo "无法连接到 npm registry" echo "" echo "=== 磁盘空间 ===" df -h $HOME echo "" echo "=== 进程信息 ===" ps aux | grep -i claude | grep -v grep echo ""

1

#!/bin/bash # network-diagnostic.sh echo "=== 网络诊断 ===" echo "DNS 解析测试:" nslookup api.anthropic.com nslookup claude.ai echo "" echo "连接测试:" timeout 10 bash -c "/dev/tcp/api.anthropic.com/443" && echo "HTTPS 连接正常" || echo "HTTPS 连接失败" echo "" echo "代理设置:" echo "HTTP_PROXY: $HTTP_PROXY" echo "HTTPS_PROXY: $HTTPS_PROXY" echo "NO_PROXY: $NO_PROXY" echo "" echo "防火墙状态 (Linux):" sudo ufw status 2/dev/null || echo "UFW 未安装或不可用"

1

# 运行诊断脚本并提供以下信息： 1. 操作系统和版本 2. Node.js 和 npm 版本 3. Claude Code 版本 4. 错误的完整日志 5. 重现步骤 6. 期望的行为 7. 系统诊断报告（使用上述脚本）

1

# 测试不同端点的延迟 curl -w "@curl-format.txt" -o /dev/null -s https://api.anthropic.com/v1/models curl -w "@curl-format.txt" -o /dev/null -s https://api.anthropic.eu/v1/models # 配置自定义端点（如果适用） export ANTHROPIC_API_URL="https://api.anthropic.eu"

1

# 在 ~/.claude/config.json 中配置 { "network": { "maxConcurrency": 3, "requestTimeout": 30000, "retryAttempts": 3, "keepAlive": true, "connectionPoolSize": 10 } }

1

# 优化 Node.js 垃圾回收 export NODE_OPTIONS="--max-old-space-size=4096 --gc-interval=100" # Claude Code 内置智能缓存，无需额外配置 # 缓存会自动管理上下文和响应以提升性能

1

# Claude Code 自动管理会话状态 # 使用 claude -c 继续上次会话 claude -c # 使用 claude -r 恢复特定会话 claude -r

1

# 1. 使用 .claude 目录组织项目信息 mkdir -p .claude/{docs,prompts,configs} # 2. 创建项目知识库 cat > .claude/docs/architecture.md < EOF # 项目架构说明 ## 核心模块 - auth: 用户认证模块 - api: REST API 接口 - database: 数据访问层 - utils: 工具函数 ## 技术栈 - Backend: Node.js + Express + PostgreSQL - Frontend: React + TypeScript + Tailwind CSS EOF # 3. 定义常用提示词 cat  .claude/prompts/code-review.md < EOF 请对以下代码进行审查，关注： 1. 代码质量和风格一致性 2. 潜在的安全问题 3. 性能优化建议 4. 测试覆盖度 EOF

1

# 查看可用的子代理 claude /agents # 创建专门的代码审查代理 claude> /agents create code-reviewer # 配置： # - 专长：代码质量、安全性、性能 # - 工具权限：读取文件、运行 lint 工具 # - 触发条件：包含 "review" 或 "audit" 关键词 # 创建测试专家代理 claude> /agents create test-expert # 配置： # - 专长：单元测试、集成测试、E2E 测试 # - 工具权限：运行测试套件、生成测试报告 # - 触发条件：包含 "test" 或 "spec" 关键词 # 使用子代理 claude> use code-reviewer to audit the authentication module claude> have test-expert generate comprehensive tests for the API endpoints

1

# 创建自定义命令目录 mkdir -p .claude/commands # 创建部署检查命令 cat > .claude/commands/deploy-check.md < EOF 执行部署前检查： 1. 运行完整测试套件 2. 检查安全漏洞扫描 3. 验证环境变量配置 4. 确认数据库迁移脚本 5. 生成部署摘要报告 如果所有检查通过，生成部署 PR 模板。 EOF # 创建性能分析命令 cat  .claude/commands/perf-analysis.md < EOF 对项目进行性能分析： 1. 分析关键路径的时间复杂度 2. 识别潜在的内存泄漏点 3. 检查数据库查询优化机会 4. 生成性能基准测试建议 5. 提供具体的优化方案 参数 $ARGUMENTS 指定要分析的模块或功能。 EOF # 使用自定义命令 claude /deploy-check claude> /perf-analysis user-service

1

# 项目 Claude Code 配置模板 mkdir -p .claude/{agents,commands,docs,templates} # 主配置文件 cat > .claude/CLAUDE.md < EOF # ${PROJECT_NAME} - Claude Code 配置 ## 项目概述 [项目的简要描述] ## 技术栈 - 编程语言：[主要语言] - 框架：[使用的框架] - 数据库：[数据库类型] - 部署：[部署方式] ## 开发规范 ### 代码风格 - 遵循 [ESLint/Prettier/其他] 配置 - 命名约定：[说明命名规范] - 注释要求：[注释规范] ### 测试要求 - 单元测试覆盖率：80% - 集成测试：关键业务流程 - E2E 测试：用户核心路径 ### Git 工作流 - 分支策略：[Git Flow/GitHub Flow] - 提交规范：[Conventional Commits] - PR 要求：[审查要求] ## Claude Code 使用指南 ### 推荐模型 - 日常开发：Claude Sonnet 4 - 复杂问题：Claude Opus 4 - 快速任务：Claude Haiku 3.5 ### 常用工作流 1. 新功能开发：分析需求 -> 设计方案 -> 编码实现 -> 测试验证 2. Bug 修复：重现问题 -> 根因分析 -> 修复实现 -> 回归测试 3. 代码审查：静态分析 -> 逻辑审查 -> 安全检查 -> 性能评估 ### 团队约定 - 重要修改前必须运行测试套件 - 使用 /review 命令进行代码审查 - 复杂重构使用 /plan 模式 EOF # 创建 gitignore 规则 cat >> .gitignore < EOF # Claude Code 个人配置 .claude/local_* .claude/cache/ .claude/sessions/ EOF

1

# 1. 敏感信息管理 # 永远不要在代码中硬编码 API 密钥 # 使用环境变量或密钥管理服务 # 2. 设置文件权限 chmod 600 ~/.bashrc ~/.zshrc ~/.claude/config.json chmod 700 ~/.claude/ # 3. 配置访问权限 claude /permissions # 设置： # - 文件系统访问：仅当前项目目录 # - 网络访问：仅必要的 API 端点 # - 执行权限：限制危险命令 # 4. 创建权限配置模板 cat  .claude/permissions.json < EOF { "fileSystem": { "allowedPaths": ["./", "../shared-utils/"], "deniedPaths": ["/etc", "/usr", "~/.ssh"], "allowedExtensions": [".js", ".ts", ".py", ".md", ".json"], "maxFileSize": "10MB" }, "network": { "allowedDomains": ["api.anthropic.com", "registry.npmjs.org"], "denyList": ["suspicious-domain.com"] }, "execution": { "allowedCommands": ["npm", "git", "node", "python"], "deniedCommands": ["rm -rf", "sudo", "chmod 777"] } } EOF

1

# 创建团队配置脚本 cat  setup-claude-code-team.sh < '#!/bin/bash EOF echo "🚀 设置团队 Claude Code 环境..." # 检查前置条件 if ! command -v node & /dev/null; then echo "❌ Node.js 未安装，请先安装 Node.js 18+" exit 1 fi if ! command -v claude &> /dev/null; then echo "📦 安装 Claude Code..." npm install -g @anthropic-ai/claude-code fi # 创建项目配置 if [ ! -d ".claude" ]; then echo "📁 创建 Claude Code 项目配置..." mkdir -p .claude/{agents,commands,docs,templates} # 复制团队配置模板 cp ./team-configs/CLAUDE.md .claude/ cp ./team-configs/permissions.json .claude/ cp -r ./team-configs/commands/* .claude/commands/ fi # 验证安装 echo "✅ 验证安装..." claude --version echo "🎉 Claude Code 团队环境设置完成！" echo "请运行 'claude' 开始使用，首次使用需要完成认证。" EOF chmod +x setup-claude-code-team.sh

1

# 使用情况统计脚本 cat > claude-usage-stats.sh < 'EOF' #!/bin/bash # 分析 Claude Code 使用情况 echo "=== Claude Code 使用统计 ===" echo "统计周期：最近 30 天" echo "" # 会话统计 sessions_dir="$HOME/.claude/sessions" if [ -d "$sessions_dir" ]; then total_sessions=$(find "$sessions_dir" -name "*.json" -mtime -30 | wc -l) echo "总会话数：$total_sessions" # 平均会话时长（如果有时间戳） echo "活跃天数：$(find "$sessions_dir" -name "*.json" -mtime -30 -exec stat -c %Y {} \; | \ xargs -I {} date -d @{} +%Y-%m-%d | sort -u | wc -l)" fi # 项目统计 echo "" echo "=== 项目使用情况 ===" find . -name ".claude" -type d | head -10 | while read dir; do project_name=$(dirname "$dir" | sed 's|.*/||') session_count=$(find "$dir" -name "*.json" 2/dev/null | wc -l) echo "$project_name: $session_count 次会话" done # 常用命令统计（如果有日志） if [ -f "$HOME/.claude/usage.log" ]; then echo "" echo "=== 最常用命令 ===" grep -o "/[a-zA-Z-]*" "$HOME/.claude/usage.log" | sort | uniq -c | sort -nr | head -5 fi EOF chmod +x claude-usage-stats.sh

1

#!/bin/bash # personal-setup.sh - 个人开发者配置脚本 echo "🔧 个人开发者 Claude Code 配置" # 安装 Claude Code npm install -g @anthropic-ai/claude-code # 创建个人配置目录 mkdir -p ~/.claude/{commands,templates,scripts} # 个人常用命令 cat > ~/.claude/commands/quick-review.md < EOF 快速代码审查当前更改： 1. 分析 git diff 中的修改 2. 检查代码风格和基本逻辑 3. 提出改进建议 4. 检查是否需要添加测试 EOF cat  ~/.claude/commands/debug-help.md < EOF 协助调试问题： 1. 分析错误信息或异常行为 2. 检查相关代码逻辑 3. 提供调试步骤建议 4. 生成测试用例验证修复 问题描述：$ARGUMENTS EOF cat  ~/.claude/commands/commit-msg.md < EOF 根据当前 git diff 生成提交信息： 1. 分析代码变更内容 2. 按照 Conventional Commits 规范 3. 生成简洁明确的提交信息 4. 如果是重要更改，添加详细说明 EOF # 个人配置文件 cat  ~/.claude/personal-config.json < EOF { "preferences": { "defaultModel": "claude-sonnet-4", "autoSave": true, "compactThreshold": 80, "enableShortcuts": true }, "shortcuts": { "r": "/quick-review", "d": "/debug-help", "c": "/commit-msg" }, "workflow": { "autoRunTests": false, "confirmDestructive": true, "saveContext": true } } EOF echo "✅ 个人配置完成！" echo "💡 使用技巧：" echo " - 输入 'claude r' 快速代码审查" echo " - 输入 'claude d <问题描述' 获得调试帮助" echo " - 输入 'claude c' 生成提交信息"

1

# 智能使用不同模型 # 创建模型选择助手 cat > ~/.claude/commands/model-advisor.md < EOF 根据任务复杂度建议最适合的模型： 简单任务（Haiku 推荐）： - 代码风格检查 - 简单重构 - 文档生成 - 单元测试编写 中等任务（Sonnet 推荐）： - 功能开发 - Bug 修复 - 代码审查 - 架构设计 复杂任务（Opus 推荐）： - 复杂算法实现 - 系统重构 - 性能优化 - 疑难问题调试 当前任务：$ARGUMENTS EOF # 使用量监控脚本 cat  ~/.claude/scripts/usage-monitor.sh < 'EOF' #!/bin/bash # 检查 Pro 订阅使用情况 echo "📊 Claude Code 使用监控" echo "日期：$(date)" echo "" # 模拟使用量检查（需要根据实际 API 调整） echo "本月预估使用量：" echo "- Sonnet 调用：约 500 次" echo "- Opus 调用：约 50 次" echo "- 预估成本：$17 (Pro 订阅年付)" echo "" echo "💡 优化建议：" echo "- 简单任务优先使用 Sonnet" echo "- 复杂问题再使用 Opus" echo "- 定期清理会话历史" EOF chmod +x ~/.claude/scripts/usage-monitor.sh

1

# 为个人项目创建标准模板 cat  ~/.claude/templates/personal-project.md < EOF # 个人项目 Claude Code 配置 ## 项目信息 项目名称：\${PROJECT_NAME} 开发语言：\${LANGUAGE} 项目类型：\${TYPE} ## 开发原则 - 代码优先，文档其次 - 测试驱动开发（TDD） - 持续集成/部署 - 保持简单和清晰 ## Claude Code 使用策略 ### 日常开发 1. 使用 Sonnet 进行常规编码 2. 遇到复杂问题时使用 `/model opus` 切换到 Opus 3. 定期使用 /review 检查代码质量 ### 代码管理 - 使用 /commit-msg 生成规范的提交信息 - 重要功能完成后使用 /quick-review - 部署前运行完整测试套件 ## 自定义命令 - \`r\`: 快速代码审查 - \`d\`: 调试助手 - \`c\`: 生成提交信息 EOF # 项目初始化脚本 cat  ~/.claude/scripts/init-personal-project.sh < 'EOF' #!/bin/bash if [ -z "$1" ]; then echo "用法: $0 <项目名称" exit 1 fi PROJECT_NAME="$1" mkdir -p "$PROJECT_NAME/.claude" # 复制个人模板 sed "s/\${PROJECT_NAME}/$PROJECT_NAME/g" ~/.claude/templates/personal-project.md > "$PROJECT_NAME/.claude/CLAUDE.md" # 创建基本结构 mkdir -p "$PROJECT_NAME"/{src,tests,docs} echo "✅ 个人项目 '$PROJECT_NAME' 初始化完成" echo "📁 项目目录已创建，Claude Code 配置已设置" EOF chmod +x ~/.claude/scripts/init-personal-project.sh

1

# team-setup.sh - 团队配置脚本 #!/bin/bash TEAM_NAME="${1:-myteam}" PROJECT_NAME="${2:-$(basename $(pwd))}" echo "🏢 设置 $TEAM_NAME 团队 Claude Code 环境" # 创建团队配置结构 mkdir -p .claude/{team,personal,shared} mkdir -p .claude/team/{commands,agents,policies} mkdir -p .claude/shared/{templates,docs,standards} # 团队主配置 cat > .claude/CLAUDE.md < EOF # $PROJECT_NAME - 团队 Claude Code 配置 ## 团队信息 团队名称：$TEAM_NAME 成员数量：[待填写] 项目阶段：[开发/测试/生产] ## 技术栈 - 后端：[技术栈] - 前端：[技术栈] - 数据库：[数据库] - 部署：[部署方式] ## 团队约定 ### 代码规范 - 风格：统一使用 Prettier + ESLint - 命名：驼峰命名法，有意义的变量名 - 注释：关键逻辑必须注释 ### Git 工作流 - 分支：feature/xxx, fix/xxx, release/xxx - 提交：使用 Conventional Commits - 合并：必须经过代码审查 ### Claude Code 使用规范 1. **重要修改前必须使用 /review 命令** 2. **复杂功能使用 /plan 模式先规划** 3. **数据库相关操作必须二次确认** 4. **生产环境配置禁止使用 Claude Code 直接修改** ## 团队命令 - \`team-review\`: 团队代码审查标准 - \`deploy-check\`: 部署前检查清单 - \`onboard\`: 新成员上手指南 EOF # 团队共享命令 cat  .claude/team/commands/team-review.md < EOF 按照团队标准进行代码审查： ## 审查清单 1. **代码质量** - 是否遵循团队编码规范 - 变量命名是否清晰有意义 - 是否有充分的错误处理 2. **安全性检查** - 是否有SQL注入风险 - 是否正确处理用户输入 - 是否泄露敏感信息 3. **性能考虑** - 是否有明显的性能问题 - 数据库查询是否优化 - 是否有内存泄漏风险 4. **测试覆盖** - 是否需要添加单元测试 - 是否需要集成测试 - 边界条件是否考虑 ## 输出格式 ✅ 通过项目 / ❌ 需要修改 / ⚠️ 需要注意 请对当前代码变更进行详细审查。 EOF cat  .claude/team/commands/deploy-check.md < EOF 执行部署前的团队检查流程： ## 部署检查清单 1. **代码质量** - [ ] 所有测试通过 - [ ] 代码审查完成 - [ ] 无明显性能问题 2. **配置检查** - [ ] 环境变量正确设置 - [ ] 数据库迁移准备就绪 - [ ] 第三方服务配置验证 3. **安全验证** - [ ] 敏感信息已移除 - [ ] API 端点权限检查 - [ ] 日志记录适当 4. **回滚准备** - [ ] 回滚方案确认 - [ ] 数据备份完成 - [ ] 监控告警设置 请检查当前项目状态并生成部署报告。 EOF # 团队权限配置 cat  .claude/team/policies/permissions.json < EOF { "teamPolicies": { "destructiveOperations": "require-confirmation", "databaseOperations": "require-review", "productionAccess": "disabled", "fileModifications": "project-only" }, "memberRoles": { "senior": { "canModifyConfigs": true, "canUseOpus": true, "canOverrideChecks": true }, "junior": { "canModifyConfigs": false, "canUseOpus": false, "canOverrideChecks": false } }, "auditRequirements": { "logAllSessions": true, "retainLogs": "30days", "sensitiveOperations": "require-approval" } } EOF echo "✅ 团队配置完成！" echo "" echo "📋 下一步：" echo "1. 团队成员运行 'npm install -g @anthropic-ai/claude-code'" echo "2. 配置各自的认证（Claude.ai Pro/Team 订阅）" echo "3. 阅读 .claude/CLAUDE.md 了解团队约定" echo "4. 测试团队命令：claude /team-review"

1

# 创建协作工作流模板 cat  .claude/shared/docs/collaboration-workflow.md < EOF # 团队协作工作流 ## 功能开发流程 1. **需求分析阶段** - 使用 Claude Code 分析需求文档 - 生成技术方案和时间评估 - 团队讨论确认技术路线 2. **开发阶段** - 创建 feature 分支 - 使用 /plan 模式规划实现步骤 - 定期使用 /team-review 检查代码质量 3. **测试阶段** - 运行 /deploy-check 确保质量 - 编写必要的测试用例 - 执行集成测试 4. **代码审查阶段** - 使用 /team-review 进行标准化审查 - 团队成员人工审查 - 修复反馈问题 5. **部署阶段** - 最终 /deploy-check 确认 - 部署到测试环境验证 - 部署到生产环境 ## 应急响应流程 1. **问题上报** - 使用 Claude Code 分析错误日志 - 快速定位问题范围 - 通知相关团队成员 2. **问题修复** - 创建 hotfix 分支 - 使用 Claude Code 协助快速修复 - 绕过常规流程直接部署 3. **事后总结** - 分析问题根因 - 更新团队知识库 - 改进开发流程 EOF

1

#!/bin/bash # enterprise-deployment.sh COMPANY_NAME="${1:-enterprise}" ENVIRONMENT="${2:-production}" echo "🏢 企业级 Claude Code 部署 - $COMPANY_NAME" # 创建企业级目录结构 mkdir -p claude-code-enterprise/{ configs/{prod,staging,dev}, policies/{security,compliance,usage}, monitoring/{logs,metrics,alerts}, deployment/{scripts,templates,docs} } cd claude-code-enterprise # 企业级配置模板 cat  configs/enterprise-config.yaml < EOF apiVersion: v1 kind: ClaudeCodeConfig metadata: name: $COMPANY_NAME-claude-code environment: $ENVIRONMENT spec: authentication: provider: aws-bedrock # or vertex-ai region: us-west-2 iamRole: arn:aws:iam::ACCOUNT:role/ClaudeCodeRole security: dataResidency: us-west-2 encryptionAtRest: true encryptionInTransit: true auditLogging: enabled compliance: gdprCompliant: true soc2Compliant: true dataRetention: 90days networking: vpcId: vpc-xxxxxxxx subnetIds: - subnet-xxxxxxxx - subnet-yyyyyyyy securityGroups: - sg-xxxxxxxx monitoring: cloudWatchLogs: enabled customMetrics: enabled alerting: enabled usage: costCenter: "engineering" department: "product-development" maxMonthlyCost: 10000 userManagement: authentication: sso authorization: rbac sessionTimeout: 8hours EOF # 安全策略配置 cat  policies/security/data-governance.json < EOF { "dataClassification": { "public": { "restrictions": "none", "allowedOperations": ["read", "write", "execute"] }, "internal": { "restrictions": "employee-only", "allowedOperations": ["read", "write"], "approvalRequired": false }, "confidential": { "restrictions": "need-to-know", "allowedOperations": ["read"], "approvalRequired": true }, "restricted": { "restrictions": "executives-only", "allowedOperations": [], "approvalRequired": true, "auditRequired": true } }, "accessControl": { "defaultDeny": true, "requiresApproval": ["database-modifications", "production-access"], "prohibitedOperations": ["data-export", "credential-access"] }, "auditRequirements": { "logAllInteractions": true, "retentionPeriod": "7years", "realTimeMonitoring": true, "complianceReporting": "monthly" } } EOF # 用户角色和权限 cat  policies/security/rbac.json < EOF { "roles": { "developer": { "permissions": [ "code:read", "code:write", "test:run", "build:trigger" ], "restrictions": [ "no-production-access", "no-data-export", "require-review-for-critical" ], "maxSessionDuration": "8h", "allowedModels": ["claude-3-5-sonnet"] }, "senior-developer": { "permissions": [ "code:read", "code:write", "code:review", "deploy:staging", "config:modify" ], "allowedModels": ["claude-3-5-sonnet", "claude-3-opus"], "maxSessionDuration": "12h" }, "architect": { "permissions": [ "system:design", "security:review", "performance:analyze", "deploy:production" ], "allowedModels": ["all"], "maxSessionDuration": "24h" }, "security-officer": { "permissions": [ "audit:view", "policy:modify", "access:revoke", "compliance:report" ], "specialAccess": ["audit-logs", "user-sessions"] } } } EOF # 监控和告警配置 cat  monitoring/cloudwatch-config.json < EOF { "logGroups": [ { "name": "/aws/claude-code/audit", "retentionDays": 2555, "kmsKeyId": "arn:aws:kms:us-west-2:ACCOUNT:key/KEY-ID" }, { "name": "/aws/claude-code/usage", "retentionDays": 90 }, { "name": "/aws/claude-code/errors", "retentionDays": 365 } ], "metrics": [ { "name": "TokenUsage", "namespace": "ClaudeCode/Usage", "dimensions": ["Department", "Team", "User"] }, { "name": "ErrorRate", "namespace": "ClaudeCode/Performance", "threshold": 0.05 }, { "name": "CostPerMonth", "namespace": "ClaudeCode/Billing", "threshold": 10000 } ], "alerts": [ { "name": "HighErrorRate", "metric": "ErrorRate", "threshold": 0.1, "action": "sns:arn:aws:sns:us-west-2:ACCOUNT:claude-code-alerts" }, { "name": "CostAlert", "metric": "CostPerMonth", "threshold": 8000, "action": "sns:arn:aws:sns:us-west-2:ACCOUNT:billing-alerts" } ] } EOF # 部署脚本 cat  deployment/scripts/deploy.sh < 'EOF' #!/bin/bash ENVIRONMENT=${1:-staging} REGION=${2:-us-west-2} echo "🚀 部署 Claude Code 企业版到 $ENVIRONMENT 环境" # 1. 验证权限 aws sts get-caller-identity # 2. 创建/更新 IAM 角色 aws iam create-role \ --role-name ClaudeCodeExecutionRole \ --assume-role-policy-document file://policies/trust-policy.json # 3. 部署 VPC 和网络资源 aws cloudformation deploy \ --template-file templates/network-stack.yaml \ --stack-name claude-code-network-$ENVIRONMENT \ --parameter-overrides Environment=$ENVIRONMENT # 4. 部署安全组 aws cloudformation deploy \ --template-file templates/security-stack.yaml \ --stack-name claude-code-security-$ENVIRONMENT # 5. 部署监控资源 aws cloudformation deploy \ --template-file templates/monitoring-stack.yaml \ --stack-name claude-code-monitoring-$ENVIRONMENT # 6. 配置用户访问 python3 scripts/setup-users.py --environment $ENVIRONMENT echo "✅ 企业级部署完成" echo "📊 监控仪表板: https://console.aws.amazon.com/cloudwatch/home?region=$REGION" echo "🔒 安全审计: https://console.aws.amazon.com/cloudtrail/" EOF chmod +x deployment/scripts/deploy.sh # 成本监控脚本 cat  monitoring/scripts/cost-analysis.py < 'EOF' #!/usr/bin/env python3 import boto3 import json from datetime import datetime, timedelta def analyze_claude_code_costs(): """分析 Claude Code 使用成本""" # 连接到 AWS Cost Explorer ce = boto3.client('ce') # 获取最近30天的成本 end_date = datetime.now().strftime('%Y-%m-%d') start_date = (datetime.now() - timedelta(days=30)).strftime('%Y-%m-%d') response = ce.get_cost_and_usage( TimePeriod={ 'Start': start_date, 'End': end_date }, Granularity='DAILY', Metrics=['BlendedCost'], GroupBy=[ { 'Type': 'DIMENSION', 'Key': 'SERVICE' } ], Filter={ 'Dimensions': { 'Key': 'SERVICE', 'Values': ['Amazon Bedrock'] } } ) # 分析结果 total_cost = 0 daily_costs = [] for result in response['ResultsByTime']: date = result['TimePeriod']['Start'] cost = float(result['Groups'][0]['Metrics']['BlendedCost']['Amount']) daily_costs.append({'date': date, 'cost': cost}) total_cost += cost # 生成报告 report = { 'period': f'{start_date} to {end_date}', 'total_cost': round(total_cost, 2), 'average_daily_cost': round(total_cost / 30, 2), 'projected_monthly_cost': round(total_cost / 30 * 30, 2), 'daily_breakdown': daily_costs } print(json.dumps(report, indent=2)) # 成本告警 if total_cost  8000: print("⚠️ 警告：月度成本预计超过预算") elif total_cost > 6000: print("📊 注意：成本接近预算限制") else: print("✅ 成本在预算范围内") if __name__ == '__main__': analyze_claude_code_costs() EOF chmod +x monitoring/scripts/cost-analysis.py echo "🎉 企业级 Claude Code 配置完成！" echo "" echo "📁 配置文件位置：$(pwd)" echo "🚀 运行部署：./deployment/scripts/deploy.sh staging" echo "📊 成本分析：python3 monitoring/scripts/cost-analysis.py" echo "📖 完整文档：deployment/docs/enterprise-guide.md"