Using AI at work

Install and Run Claude Code for the First Time: Ask Questions Before Changing Code

Check the Claude Code installation command and account requirements for your operating system, then start a first session in a fictional practice folder. Instead of generating code immediately, this article focuses on asking only three questions in plan mode to inspect the folder and CSV, then exiting safely.

Show contents

Who this is forWindows, macOS, Linux, and WSL users installing Claude Code for the first time who want to practice reading and asking questions before allowing file changes

What you need
  • Be able to open a terminal or PowerShell
  • Have a supported account or payment method available for Claude Code
  • Use the fictional expenses.csv instead of real personal information
  • Native Windows users should check the recommendation to install Git for Windows

01Check the account and practice scope before installing

Claude Code should not be explained on the assumption that it is free to use. The official documentation used for this article lists Claude Pro, Max, Team, and Enterprise subscriptions, prepaid API credits in Claude Console, or supported cloud providers as account paths. Before installation, check the official documentation and your actual account screen to determine which path applies to you. This article does not invent prices or specific version numbers.

Preparation itemWhat to checkChoice in this article
AccountApplicable path among supported Claude subscriptions, Console, or cloud providersDo not assume it is free
Practice folderKeep it separate from real work foldersUse vibe-expenses
DataFictional file without personal informationUse expenses.csv
PermissionsStart with reading and planning rather than editingplan mode recommended

On native Windows, installing Git for Windows is recommended. If Git for Windows is not installed, Claude Code can use PowerShell as its shell tool. Git itself is covered in article 6, so this article focuses only on the installation environment and the first session.

02Use the official installation command for your operating system

The recommended native installation command differs by operating system. Before copying the commands below, check which shell and operating system you are using. The official documentation states that native installations use automatic background updates, while Homebrew and WinGet installations do not update automatically.

Prompt
# macOS · Linux · WSL
curl -fsSL https://claude.ai/install.sh | bash
Prompt
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Prompt
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew:
brew install --cask claude-code

WinGet:
winget install Anthropic.ClaudeCode

Use the installation commands exactly as verified in the official documentation rather than mixing in arbitrarily modified installation scripts from the internet. Before running them, check the official documentation again to see whether the latest requirements or supported environments for each installation method have changed.

03Check the version without treating a specific number as the expected value

After installation, open a new terminal and run `claude --version`. According to the official documentation, it prints a version number and '(Claude Code)'. Because the version number can change over time, this article does not specify a particular number as the expected value.

Prompt
claude --version

If you see a message saying the command cannot be found, check the installation steps and the troubleshooting guidance in the official documentation again rather than guessing a path. This article did not actually run Claude Code, so it does not claim to reproduce any specific error or success screen.

04Create a separate practice folder instead of using a real project

It is safer not to do the first run directly inside a research folder or work repository. Create an empty practice folder instead. Here, use only a folder named vibe-expenses and the fictional expenses.csv. After creating the folder, save the CSV content defined in the previous article.

Prompt
mkdir vibe-expenses
cd vibe-expenses
Prompt
date,category,amount
2026-09-01,food,12000
2026-09-03,transport,1450
2026-09-03,food,8500
2026-09-10,supplies,3200
2026-09-15,transport,1450
2026-10-02,food,9800

Save the file as UTF-8. Do not create summarize.py at this stage. The goal of the first session is not to 'make AI code immediately,' but to have it read and explain the current folder so you can decide what should change.

05Start in plan mode and sign in for the first time

You can start Claude Code in a project folder with `claude`, and the first launch proceeds through browser sign-in. However, beginners are better served by starting in plan mode rather than immediately allowing edits. plan is a permission mode for read-oriented analysis and plan review, and it can be started from the command line as follows.

Prompt
claude --permission-mode plan

A browser sign-in flow may appear on the first run. If you need to switch accounts, you can use `/login` within the session. Because the default permission mode can vary by account and environment, this article does not claim that 'Manual is always the default.' According to the official documentation checked on 2026-09-22, the default starting mode for the interactive terminal is auto on Pro, Max, and Team plans, and Manual on other plans.

Editorial example
[Editorial example · not an actual response]
On the first run, browser sign-in or permission-related guidance may appear. The exact wording and sequence can vary by installation date and account, so check the current screen against the official documentation.

06Ask three read-only questions before changing files

Once the session starts, do not immediately ask it to 'make the program.' First check how accurately it understands the current folder. Claude Code can read the files it needs and may ask for approval before modifying files or running commands. In this exercise, do not request any edits; ask questions only.

Prompt
Tell me which files are in this folder. Do not modify any files.

Explain the column names in expenses.csv and what each column appears to mean. Do not modify any files.

If you were going to build a tool that calculates monthly amount totals from this CSV, list three things that should be confirmed before implementation. Do not create code yet.

At minimum, verify that the response did not misread the current filename or CSV columns. If AI mentions a nonexistent file or proposes an unwanted edit or installation, ask why first. The exact wording of a real Claude Code response varies by model and time, so this article does not invent a model answer and present it as actual output.

QuestionWhat the person should verifyIf there is a problem
What is in the folder?Does it recognize expenses.csv as an actual file?If it mentions a nonexistent file, ask again for evidence from the file list
What are the CSV columns?Does it read date, category, amount correctly?If it guesses column names, compare them with the original file
What should be checked before implementation?Does it confirm input, output, and constraints first?If it tries to edit immediately, ask for a plan only

07Exit and move on to the next article

After you achieve the goal of the first session, exit without creating code. You can use `/exit` in the session, or press Ctrl+D twice. `/help` shows the command list, and commands such as `/clear`, `/resume`, `/compact`, and `/rewind` also exist, but this article only identifies their names and does not expand the exercise further.

Prompt
/exit
  • Completed the installation check with claude --version.
  • Used the vibe-expenses practice folder rather than a real work folder.
  • expenses.csv contains only fictional data.
  • Asked three questions in plan mode without modifying files.
  • Deferred actual code generation to the next article.

The next article uses the requirements and practice folder from the previous steps to create summarize.py for real. At that point, the request will include the input example, expected output, and the constraint to use only the standard library, and the generated Python code will be run separately to verify the result.

What to check yourself

Written using the Claude Code official documentation (checked 2026-09-22) · Claude Code not actually run · No Python code to execute

  • Confirmed that the native installation commands for macOS, Linux, WSL, Windows PowerShell, and Windows CMD match the official documentation
  • Compared the alternative Homebrew and WinGet installation commands and their automatic-update behavior with the official documentation
  • Confirmed that the notation for claude --version, claude --permission-mode plan, /login, and /exit matches the official documentation
  • Confirmed that the article does not assert free availability and presents only supported account paths
  • Confirmed that the editorial example corresponding to a Claude Code screen or response starts with '[Editorial example · not an actual response]'
  • Confirmed that no Python executable code is included, so the article does not incorrectly claim Python result verification
Verification limits

Claude Code was not installed or run while writing this article. The installation commands and feature descriptions follow the Claude Code official documentation checked on 2026-09-22; at the time of an actual installation, recheck the official documentation for current supported environments, account requirements, and screen wording.