/start-0-7.en

description: "Lesson command"
chapter: "courses/aiagent/lesson02-setup/ch01-environment"
duration: "~15 min"
prerequisites: ["Node.js 18 or higher installed", "Familiar with terminal operations"]
level: "beginner"
tags: ["setup", "claude-code", "cli"]
nonInteractiveMode: incompatible

Lesson 0-7: Claude Code Setup

Check Setup Progress

**Auto-run by AI:** Run `uv run python tools/setup_progress.py show` to display the current setup progress.

---

What You'll Do

| Item | Details | |------|---------| | Goal | Install Claude Code, complete authentication and project initialization. Understand how to use slash commands and skills | | Duration | ~15 min | | Prerequisites | Node.js 18 or higher installed; familiar with terminal operations | | Course Page | Refer to [Course Materials Top](https://ai-agent.camp/en/course/module-0) in parallel |

> **Hint**: If the AI stops responding midway, type "please continue" or "it stopped" to resume.

---

What Is Claude Code?

Claude Code is Anthropic's official CLI tool. You can call Claude directly from the terminal to edit code, manipulate files, and execute commands using natural language.

Differences from Cursor:

• **Cursor**: Use AI within a GUI editor (chat and inline editing)
• **Claude Code**: Use AI from the terminal (CLI-based, suited for automation)

You can take this curriculum's lessons with either tool.

---

Step 1: Installation

Install Claude Code globally via npm.

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

After installation, verify the version:

claude --version

**AskQuestion settings:**

{
  "title": "Step 1: Installation",
  "questions": [{
    "id": "install_status",
    "prompt": "What is your Claude Code installation status?",
    "options": [
      {"id": "not_installed", "label": "Install now (run the command above)"},
      {"id": "already_installed", "label": "Already installed"},
      {"id": "error", "label": "Got an error during installation"}
    ]
  }]
}

(not_installed -> Run `npm install -g @anthropic-ai/claude-code` and verify the result) (already_installed -> Go to Step 2) (error -> Check if Node.js is 18+ with `node --version`. Guide to clear npm cache with `npm cache clean --force`)

---

Step 2: Authentication (OAuth Login)

Claude Code automatically starts the authentication flow on first launch. Running the following command will open your browser:

claude

Log in to your Anthropic account in the browser and complete the authentication.

> **Note**: A Claude Pro / Max / Team / Enterprise plan is required. The free plan is not supported. > > **To authenticate with an API key**: Run `source ./.env` first (if `ANTHROPIC_API_KEY` is set in `.env`), then launch `claude`. > > **To re-authenticate within a session**: Type `/login` in the Claude Code chat.

**AskQuestion settings:**

{
  "title": "Step 2: Authentication",
  "questions": [{
    "id": "auth_status",
    "prompt": "What is your authentication status?",
    "options": [
      {"id": "run_auth", "label": "Start authentication (run claude)"},
      {"id": "already_authed", "label": "Already authenticated"},
      {"id": "api_key", "label": "I want to authenticate with an API key"},
      {"id": "error", "label": "Got an error during authentication"}
    ]
  }]
}

(run_auth -> Run `claude`. The browser opens on first launch and the authentication flow begins) (already_authed -> Go to Step 3) (api_key -> Guide to set `ANTHROPIC_API_KEY=sk-ant-...` in `.env`, run `source ./.env`, then launch `claude`) (error -> Check status with `claude auth status` and guide troubleshooting. Within a session, re-authenticate with `/login`)

---

Step 3: Project Initialization

Launch `claude` at the root of the ai-agent-camp repository:

cd /path/to/ai-agent-camp
claude

On first launch, Claude Code automatically:

1. Reads `CLAUDE.md` to understand project settings 2. Recognizes commands under `.claude/commands/` 3. Recognizes skills under `skills/`

---

Step 4: How to Use Slash Commands

In Claude Code, you can invoke lessons and utilities with **`/command-name`**.

How to Start a Lesson

/start-0-1    -> Environment Setup Verification
/start-0-7    -> This lesson (Claude Code Setup)
/start-1-1    -> Banner Generation Intro

Utility Commands

/check-setup  -> Comprehensive environment check
/overview     -> Project overview

> **Tip**: In Cursor, you run commands from Cmd+Shift+P -> Command Palette, but in Claude Code you simply type `/command-name` directly in the chat.

**AskQuestion settings:**

{
  "title": "Step 4: Command Verification",
  "questions": [{
    "id": "command_check",
    "prompt": "Let's try a slash command",
    "options": [
      {"id": "try_check", "label": "Try /check-setup"},
      {"id": "understood", "label": "Understood, move on"},
      {"id": "more_info", "label": "I want to learn more"}
    ]
  }]
}

(try_check -> Run the contents of `/check-setup`) (understood -> Go to Step 5) (more_info -> Display the file list under `.claude/commands/lesson/` and describe each command)

---

Step 5: Understanding the Skill System

Claude Code **skills** are specialized modules for executing specific tasks. They are stored under `skills/`.

Differences Between Skills and Slash Commands

| Feature | Mechanism | Examples | |---------|-----------|---------| | **Slash commands** (`/command`) | Execute files in `.claude/commands/` | `/start-0-1`, `/check-setup` | | **Skills** | Auto-selected by natural language trigger phrases | "Create a banner" -> banner-creator |

> **Important**: Skills cannot be invoked with slash commands like `/skill-name`. Slash commands are exclusively for files in `.claude/commands/`.

How to Invoke Skills

Skills are **automatically selected when you request a task in natural language**, based on trigger phrases defined in each skill's `SKILL.md`:

"Create a banner"