Claude Code 安装配置完全指南

# 检查 Node.js 版本
node --version
# 需要 v18.0.0 或更高

# 检查 npm 版本
npm --version
# 需要 v9.0.0 或更高

# 如果没有安装 Node.js，推荐使用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version
# 预期输出：claude-code v1.x.x

# 查看帮助信息
claude --help

# 启动 Claude Code
claude

# 首次启动会提示你进行认证：
# 1. 选择认证方式：
#    - API Key（输入你的 Anthropic API 密钥）
#    - OAuth（通过浏览器登录 Anthropic 账号）
# 2. 推荐使用 API Key 方式，输入密钥后按回车
# 3. 认证成功后会显示欢迎信息

# 方法1：设置环境变量（推荐）
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

# 方法2：写入 shell 配置文件
echo 'export HTTPS_PROXY="http://127.0.0.1:7890"' >> ~/.bashrc
echo 'export HTTP_PROXY="http://127.0.0.1:7890"' >> ~/.bashrc
source ~/.bashrc

# 方法3：使用 Claude Code 内置代理配置
claude config set proxy http://127.0.0.1:7890

{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 8192,
    "temperature": 0.7,
    "theme": "dark",
    "editor": "vscode",
    "auto_approve": [],
    "permissions": {
        "allow": [
            "Read", "Write",
            "Bash(git *)", "Bash(python *)",
            "Bash(npm *)", "Bash(pip *)",
            "Bash(ls *)", "Bash(cat *)",
            "Bash(find *)", "Bash(grep *)"
        ],
        "deny": [
            "Bash(rm -rf *)",
            "Bash(sudo *)"
        ]
    },
    "context": {
        "max_files": 100,
        "ignore_patterns": [
            "node_modules", ".git", "__pycache__",
            "*.pyc", "dist", "build", ".venv", "venv"
        ]
    },
    "cost_limit": {
        "daily_usd": 10.0,
        "alert_threshold": 8.0
    }
}

# 创建项目配置目录
mkdir -p .claude

# 创建 CLAUDE.md 项目说明文件
cat > .claude/CLAUDE.md << 'EOF'
# 项目说明

## 项目概述
这是一个基于 FastAPI 的后端 API 项目，使用 PostgreSQL 数据库。

## 技术栈
- Python 3.11
- FastAPI 0.104+
- SQLAlchemy 2.0
- PostgreSQL 15
- Redis 7（缓存）
- Celery（异步任务）

## 代码规范
- 使用 Black 格式化代码，行宽 100
- 使用 isort 排序 import
- 使用 mypy 进行类型检查
- 所有函数必须有类型注解和 docstring
- 测试使用 pytest，覆盖率要求 80% 以上

## 项目结构
src/
  api/          # API 路由
  models/       # 数据模型
  services/     # 业务逻辑
  utils/        # 工具函数
tests/          # 测试文件

## 注意事项
- 数据库迁移使用 Alembic
- API 响应格式遵循 { "code": 0, "data": {}, "message": "ok" }
- 所有 API 需要认证（除 /auth/login 和 /auth/register）
EOF

# 查看当前权限配置
claude config get permissions

# 添加允许的命令模式
claude permission add "Bash(docker *)"
claude permission add "Bash(make *)"

# 添加拒绝的命令模式
claude permission deny "Bash(curl *)"

# 重置权限
claude permission reset

# 启动交互模式（在项目目录中）
cd ~/my-project
claude

# 在交互模式中，你可以直接输入自然语言指令：
# > 帮我分析这个项目的整体架构
# > 在 src/api/ 下添加一个用户管理接口
# > 修复 tests/test_user.py 中失败的测试
# > 优化 src/services/order.py 的性能
# > 解释 src/models/database.py 中的数据模型关系

# 直接执行单条指令
claude -p "分析当前项目的依赖关系并输出报告"

# 指定输出格式
claude -p "列出所有 TODO 和 FIXME 注释" --output json

# 非交互模式（适合脚本和 CI/CD）
claude -p "检查代码中的安全漏洞" --non-interactive

# 将文件内容传给 Claude Code 分析
cat src/main.py | claude -p "审查这段代码并给出优化建议"

# 将 Git diff 传给 Claude Code
git diff | claude -p "总结这次代码变更的内容"

# 将测试结果传给 Claude Code 分析
pytest --tb=short 2>&1 | claude -p "分析测试失败的原因并给出修复方案"

# 继续上一次的对话
claude --continue

# 查看历史会话列表
claude sessions list

# 恢复指定会话
claude sessions resume <session-id>

# 导出会话记录
claude sessions export <session-id> --format markdown

# 创建项目目录
mkdir -p ~/my-fastapi-app && cd ~/my-fastapi-app

# 启动 Claude Code
claude

# 输入以下指令：
# > 创建一个 FastAPI 项目，要求：
#   1. 使用 SQLAlchemy 2.0 + PostgreSQL
#   2. 包含用户注册、登录、JWT 认证
#   3. 包含 CRUD 示例接口
#   4. 使用 Alembic 做数据库迁移
#   5. 包含 Docker Compose 配置
#   6. 包含 pytest 测试框架
#   7. 项目结构清晰，代码有类型注解和文档字符串

# 审查整个项目
claude -p "对当前项目进行全面的代码审查，关注：
1. 安全漏洞（SQL注入、XSS、认证问题）
2. 性能问题（N+1查询、内存泄漏）
3. 代码质量（重复代码、命名规范）
4. 错误处理（异常捕获、日志记录）
请给出具体的改进建议和代码示例。"

# 审查指定文件
claude -p "审查 src/api/auth.py 的安全性"

# 重新设置 API 密钥
claude auth login

# 或通过环境变量设置
export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"

# 验证密钥是否有效
claude auth status

# 切换到更快的模型
claude config set model claude-sonnet-4-20250514

# 清理缓存
claude cache clear

# 查看当前配置
claude config list

# 设置每日费用上限
claude config set cost_limit.daily_usd 5.0

# 设置费用预警阈值
claude config set cost_limit.alert_threshold 4.0

# 查看当前费用使用情况
claude usage

# 在 PowerShell 中安装 WSL2
wsl --install

# 进入 WSL
wsl

# 在 WSL 中安装 Node.js 和 Claude Code
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g @anthropic-ai/claude-code
claude

# 安装 Claude Code VS Code 扩展
code --install-extension anthropic.claude-code

# 安装后使用 Ctrl+Shift+P 打开命令面板
# 输入 "Claude Code: Open" 即可在 VS Code 终端中启动