Claude Code 零基础入门：从安装到第一个项目

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装 Node.js 20 LTS
nvm install 20
nvm use 20

# 验证安装
node --version   # 应输出 v20.x.x
npm --version    # 应输出 10.x.x

winget install OpenJS.NodeJS.LTS

# 全局安装（推荐）
npm install -g @anthropic-ai/claude-code

# 验证安装成功
claude --version
# 输出类似: 2.1.56 (Claude Code)

# 方案1：使用 nvm 安装的 Node.js（推荐，无需 sudo）
npm install -g @anthropic-ai/claude-code

# 方案2：修改 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

claude auth
# 会打开浏览器，引导你登录 Anthropic 账号

# 设置环境变量（写入 ~/.bashrc 或 ~/.zshrc）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 或者使用 Claude 的 setup-token 命令
claude setup-token

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-token",
    "ANTHROPIC_BASE_URL": "https://your-proxy.example.com/api/anthropic"
  }
}

# 进入一个空目录作为练习
mkdir ~/my-first-project && cd ~/my-first-project

# 启动 Claude Code
claude

╭──────────────────────────────────────────────╮
│  Claude Code 2.1.56                          │
│                                              │
│  Working directory: ~/my-first-project       │
│  Model: claude-sonnet-4-6                    │
╰──────────────────────────────────────────────╯
>

# 指定模型（opus 最强，sonnet 平衡，haiku 快速）
claude --model opus

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

# 恢复指定会话
claude --resume

# 非交互模式（适合脚本和管道）
claude -p "解释当前目录的项目结构"

# 限制最大花费（配合 -p 使用）
claude -p "修复测试" --max-budget-usd 1.0

# 创建 git worktree 隔离工作
claude --worktree my-feature

# 在项目根目录创建
cat > CLAUDE.md << 'EOF'
# 项目说明

这是一个学习项目，用于练习 Claude Code 的基本操作。

## 技术栈
- 语言：Python 3.12
- 框架：Flask
- 前端：HTML + Tailwind CSS

## 编码规范
- 使用中文注释
- 函数和变量名使用英文
- 遵循 PEP 8 风格

## 工作流规则
- 修改代码后自动运行测试
- 不要自动 git commit，需手动确认
- 不要创建 .md 文档文件，除非明确要求
EOF

# 全局偏好

## 语言
- 默认使用中文回复
- 代码注释可用英文

## 通用规则
- 不要自动 commit
- 始终先读取文件再编辑
- 优先编辑现有文件而非创建新文件
- 不要提交敏感文件（.env、credentials）

# 启动时指定权限模式
claude --permission-mode plan

# 非交互模式跳过权限（仅限受控环境）
claude -p "运行测试" --dangerously-skip-permissions

# 只允许读取和编辑，禁止执行命令
claude --allowedTools "Read,Edit"

# 禁止 Git 操作
claude --disallowedTools "Bash(git:*)"

> 创建一个 Flask 应用的骨架

> 给 app.py 添加一个 /api/hello 的路由

> 运行 python app.py 看看能不能启动

> 帮我写一个简单的测试文件

# 快速代码审查
claude -p "审查 src/main.py 的代码质量，指出潜在问题"

# 生成提交信息
claude -p "根据当前 git diff 生成一个规范的 commit message"

# 批量重命名
claude -p "把所有 .js 文件中的 getUserName 改为 fetchUserName"

# 搭配管道使用
cat error.log | claude -p "分析这段错误日志的根因"

# 创建项目目录
mkdir ~/todo-app && cd ~/todo-app

# 初始化 Git（推荐，Claude Code 能更好地管理变更）
git init

# 创建 CLAUDE.md
cat > CLAUDE.md << 'EOF'
# 待办事项应用

## 技术栈
- 后端：Python Flask
- 前端：HTML + Tailwind CSS（CDN）
- 数据存储：SQLite

## 要求
- 使用中文界面
- 简洁现代的 UI 设计
- 支持增删改查操作
- 代码遵循 PEP 8
EOF

# 启动 Claude Code
claude

> 根据项目要求，创建一个完整的 Flask 待办事项应用。
> 要求：
> 1. app.py 作为主程序
> 2. 使用 SQLite 存储
> 3. HTML 模板放在 templates/ 目录
> 4. 使用 Tailwind CSS CDN
> 5. 支持添加、完成、删除待办事项
> 6. 界面要美观，中文显示

> 运行应用，看看有没有报错

> 打开浏览器看看效果。给首页添加一个"清空已完成"的按钮

todo-app/
├── CLAUDE.md              # 项目指令
├── app.py                 # Flask 主程序
├── requirements.txt       # Python 依赖
├── templates/
│   └── index.html         # 主页面模板
├── static/                # 静态资源（可选）
└── .gitignore             # Git 忽略规则

> 给这个应用写单元测试，使用 pytest

> 运行所有测试，确保通过

> 把这个应用部署到本地，使用 gunicorn 作为生产服务器

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx",
    "API_TIMEOUT_MS": "300000"
  },
  "permissions": {
    "allow": [
      "Bash(python:*)",
      "Bash(npm:*)",
      "Bash(git status:*)",
      "Read",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf:*)"
    ]
  },
  "theme": "dark",
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true,
    "context7@claude-plugins-official": true
  }
}

# 添加一个 HTTP 类型的 MCP 服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 添加一个 stdio 类型的本地服务器
claude mcp add my-tools -- npx my-mcp-server

# 查看已配置的服务器
claude mcp list

# 移除服务器
claude mcp remove sentry

{
  "mcpServers": {
    "my-api": {
      "type": "http",
      "url": "https://my-api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${API_TOKEN}"
      }
    }
  }
}

# Claude Code 内置诊断工具
claude doctor

# 检查版本和更新
claude --version
claude update