Skip to content
Pardeep Kaushik.

AI Coding & Tools

Claude Code Setup and Workflow: Terminal-First AI Agent Guide

Master Anthropic's revolutionary terminal coding agent. Learn how to install Claude Code, configure API keys, execute repository refactors, and automate git workflows.

  • Claude Code
  • Tutorial
  • Anthropic
  • Terminal
  • AI Agent

What Makes Claude Code Different?

Claude Code is Anthropic's official terminal-based agentic coding tool. Unlike traditional editor extensions that only suggest code inside an open tab, Claude Code is an autonomous software engineering agent that runs in your terminal, inspects your project directory, writes files, runs build scripts, and manages git commits.

This tutorial walks through the complete setup, core commands, and best practices for integrating Claude Code into your development workflow.

For architectural comparisons, see Claude Code vs Cursor and our guide on Claude Code usage limits and pricing.

Step 1: Installation & Authentication

Prerequisites

  • Node.js version 18 or higher installed on your system.
  • An Anthropic Console account with API credits or a supported Claude Pro/Team plan.

Installation Command

Install Claude Code globally via npm:

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

Launching and Authenticating

Navigate to your project root and start the CLI:

cd /path/to/my-project
claude

On first launch, Claude Code opens your browser to authenticate with your Anthropic account.

Step 2: Core Commands You Must Know

Once inside the interactive shell, several built-in commands streamline your session:

CommandAction
/helpDisplays available commands and configuration shortcuts
/compactSummarizes previous turns to free up context window tokens
/clearClears session history and resets context
/costShows estimated token consumption and session expenses
/prAutomatically generates a GitHub pull request with summary notes

Step 3: Real-World Developer Workflows

1. Codebase Exploration & Architectural Q&A

When onboarding to an unfamiliar codebase, ask Claude Code to explain system architecture:

> Explain how our authentication middleware verifies JWT tokens and where user sessions are stored.

Claude Code uses internal tools (GlobTool, GrepTool, FileReadTool) to find the auth files and provide a clear, cited explanation.

2. Autonomous Bug Fixing with Test Verification

Claude Code's greatest strength is closing the loop between editing code and verifying tests:

> Run npm test. Find the failing test in tests/cart.test.ts, update the discount calculation in lib/pricing.ts, and re-run tests until they all pass.

Claude Code runs the test command, analyzes the stack trace, edits lib/pricing.ts, and re-runs npm test until all assertions pass.

Step 4: Token Management Best Practices

Because Claude Code operates over high-context models like Claude 3.7 Sonnet, long sessions can consume substantial tokens:

  1. Use /compact Frequently: After completing a major feature, run /compact to purge verbose diffs from model memory.
  2. Keep .gitignore Updated: Ensure node_modules, build outputs (.next, dist), and large log files are ignored so Claude doesn't waste tokens scanning them.
  3. Be Specific in Prompts: Mention the exact directory or component rather than issuing generic prompts across the entire project.

Conclusion

Claude Code represents a major leap forward for developers who love the terminal. By pairing natural language intelligence with direct shell execution, it turns repetitive refactoring and testing into frictionless commands.

Building scalable applications requires solid full-stack engineering. Learn more about our full-stack development capabilities or explore our client reviews.

Frequently asked questions

How do I install Claude Code?

Claude Code is installed globally via npm by running: npm install -g @anthropic-ai/claude-code. You will then authenticate with your Anthropic Console API key or Claude subscription account.

Does Claude Code run locally on my computer?

The CLI interface runs locally on your machine and has access to your local filesystem and terminal commands. However, the reasoning and code generation models are hosted on Anthropic's secure cloud infrastructure.

How can I prevent Claude Code from making unwanted changes?

Claude Code asks for user confirmation before executing potentially destructive terminal commands or editing files, unless you explicitly enable autonomous flags.

What is Compact Mode in Claude Code?

Running the /compact command summarizes past conversation turns, clearing out bloated token context while preserving key architectural insights, keeping token usage efficient.

About the author

Author

Pardeep Kaushik

Full Stack, WordPress & Shopify Developer

Pardeep Kaushik is a freelance Full Stack, WordPress and Shopify developer with 5+ years of experience building business websites, ecommerce stores and custom web applications. His work includes WordPress, WooCommerce, Elementor, Shopify, Liquid, React, Next.js, Node.js, AI integrations, APIs and production deployment.