Claude Code零基础入门：安装配置与首个项目

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

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

# 安装 Node.js LTS 版本
nvm install --lts

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

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

claude --version

npm ERR! Error: EACCES, permission denied

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 查看 npm 全局安装路径
npm config get prefix

# 将其加入 PATH（假设输出为 /home/yourname/.npm-global）
echo 'export PATH="/home/yourname/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Error: Claude Code requires Node.js 18 or later

nvm install 20
nvm use 20
nvm alias default 20

claude

# 设置 API Key 环境变量
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxx"

# 然后启动
claude

echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

╭──────────────────────────────────────────────╮
│  Welcome to Claude Code!                     │
│                                              │
│  Model: claude-sonnet-4-6                    │
│  Account: [email protected]                     │
╰──────────────────────────────────────────────╯
>

# 指定模型
claude --model claude-opus-4-6

# 单次执行模式
claude -p "解释这个项目的架构"

# 从标准输入读取
echo "hello world" | claude -p "翻译为中文"

# 恢复上次会话
claude --resume

# 指定工作目录
claude --cwd /path/to/project

# 输出为 JSON 格式（适合脚本集成）
claude -p "list all TODO comments" --output-format json

# 非交互模式（适合 CI/CD）
claude -p "run tests" --allowedTools "Bash(npm test)"

# 项目说明
这是一个使用 React + TypeScript 的前端项目。

# 技术栈
- React 18 + TypeScript
- Vite 构建工具
- TailwindCSS 样式
- Vitest 测试框架

# 代码规范
- 使用函数式组件和 Hooks
- 变量使用 camelCase，组件使用 PascalCase
- 优先使用命名导出而非默认导出
- 提交信息遵循 Conventional Commits 规范

# 项目结构
- src/components/ - 通用组件
- src/pages/ - 页面组件
- src/hooks/ - 自定义 Hooks
- src/utils/ - 工具函数
- src/api/ - API 请求相关

# 注意事项
- 不要修改 src/generated/ 下的文件（自动生成的）
- 运行测试命令: npm test
- 运行构建命令: npm run build

# 全局偏好
- 回复使用中文
- 代码注释使用英文
- 默认使用 TypeScript
- 优先使用原生 API 而非第三方库
- commit message 不要自动加版本号

{
  "permissions": {
    "allow": [
      "Bash(npm test*)",
      "Bash(npm run lint*)",
      "Bash(git status*)",
      "Bash(git diff*)",
      "Bash(git log*)",
      "Read",
      "Glob",
      "Grep"
    ],
    "deny": [
      "Bash(rm -rf*)",
      "Bash(curl*|*)",
      "Bash(wget*)"
    ]
  },
  "model": "claude-sonnet-4-6",
  "theme": "dark"
}

# 创建项目目录
mkdir todo-cli && cd todo-cli

# 初始化 Git 仓库
git init

# 启动 Claude Code
claude

> 帮我创建一个 Python 命令行待办事项工具。要求：
> 1. 使用 argparse 处理命令行参数
> 2. 支持添加、删除、列表、完成标记操作
> 3. 数据存储在 JSON 文件中
> 4. 代码结构清晰，有类型注解

> 展示你创建的文件的内容

# todo.py
import argparse
import json
from pathlib import Path
from datetime import datetime
from typing import Optional

DATA_FILE = Path.home() / ".todo_data.json"

def load_todos() -> list[dict]:
    """Load todos from JSON file."""
    if DATA_FILE.exists():
        return json.loads(DATA_FILE.read_text())
    return []

def save_todos(todos: list[dict]) -> None:
    """Save todos to JSON file."""
    DATA_FILE.write_text(json.dumps(todos, indent=2, ensure_ascii=False))

def add_todo(title: str, priority: str = "normal") -> None:
    """Add a new todo item."""
    todos = load_todos()
    todos.append({
        "id": len(todos) + 1,
        "title": title,
        "priority": priority,
        "done": False,
        "created_at": datetime.now().isoformat()
    })
    save_todos(todos)
    print(f"✅ Added: {title}")

def list_todos(show_all: bool = False) -> None:
    """List all todo items."""
    todos = load_todos()
    if not todos:
        print("No todos found.")
        return
    for todo in todos:
        status = "✓" if todo["done"] else "○"
        print(f"  {status} [{todo['id']}] {todo['title']} ({todo['priority']})")

# ... 更多函数

> 给我添加单元测试，使用 pytest 框架

> 帮我添加一个 --sort 参数，可以按优先级排序

> 运行测试，确保全部通过

> 帮我提交代码到 Git

> /plan

> /compact

> /compact 请保留所有关于数据库schema的讨论

# 恢复最近的会话
claude --resume

# 继续特定会话（Claude 会列出最近的会话供选择）
claude --continue

> 把所有的 console.log 替换成自定义的 logger，并创建 logger 模块

# 代码审查
claude -p "review the changes in my git diff and suggest improvements" < <(git diff)

# 自动生成 commit message
claude -p "generate a conventional commit message" < <(git diff --staged)

# 批量文件处理
for file in src/*.ts; do
  claude -p "add type annotations to this TypeScript file" < "$file" > "${file%.ts}.typed.ts"
done

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(git *)",
      "Bash(npm test*)",
      "Bash(npm run lint*)",
      "Bash(npm run build*)",
      "Bash(ls *)",
      "Bash(cat *)",
      "Bash(pytest*)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(chmod 777*)"
    ]
  }
}

> /permissions

flowchart LR
    A[终端启动 Claude Code] --> B[认证/选择模型]
    B --> C[读取 CLAUDE.md<br/>加载项目上下文]
    C --> D{任务复杂度}
    D -->|简单任务| E[直接对话执行]
    D -->|复杂任务| F[/plan 模式<br/>制定计划]
    F --> G[审核计划]
    G --> H[切换 Act 模式<br/>逐步执行]
    E --> I[Claude 操作文件<br/>运行命令]
    H --> I
    I --> J{结果满意？}
    J -->|是| K[Git 提交]
    J -->|否| L[继续迭代<br/>补充指令]
    L --> I
    K --> M[推送远程<br/>或创建 PR]
    style F fill:#f59e0b,color:#fff
    style H fill:#10b981,color:#fff
    style K fill:#3b82f6,color:#fff