Master Claude Code: From Installation to Advanced AI‑Powered Programming Assistant
This comprehensive guide walks you through setting up Claude Code, explains its tool‑use architecture, shows how to configure the environment, manage project context, use plan and think modes, control dialogue flow, create custom commands, and extend functionality with MCP servers such as Playwright.
Claude Code Overview
Claude Code is an AI‑powered programming assistant that combines Claude large‑language‑model reasoning with tool‑use capabilities. It is part of the Claude Certified Architect (CCA) program.
Installation
Supported platforms:
macOS (Homebrew): brew install --cask claude-code macOS / Linux / WSL: curl -fsSL https://claude.ai/install.sh | bash Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAfter installation run claude and follow the authentication prompt.
Cloud integrations
AWS Bedrock – see https://code.claude.com/docs/en/amazon-bedrock
Google Cloud Vertex – see https://code.claude.com/docs/en/google-vertex-ai
Project setup
Install Node.js.
Download and unzip uigen.zip from the article resources.
Run npm run setup to install dependencies and create a local SQLite database.
Optional: place an Anthropic API key in .env at the project root to enable full Claude functionality. Without a key the project generates static example code.
Context management
Running /init in a new project creates CLAUDE.md, which summarises the project purpose, architecture, key commands and coding patterns. This file is included in every Claude request as a persistent system prompt.
File locations
CLAUDE.md– generated by /init, committed to source control. CLAUDE.local.md – personal, not shared. ~/.claude/CLAUDE.md – global settings applied to all projects.
Custom instructions
Add directives directly to CLAUDE.md. Example:
# Limit comments to complex code only.File references
Use @ followed by a path (e.g., @auth) to include a file’s content in a request. The same syntax works inside CLAUDE.md for reusable references.
How does the authentication system work? @authModifying code
Paste a screenshot (Ctrl+V / Cmd+V) and ask Claude to make UI changes. Claude generates the required code changes, which can be applied with npm run dev. For complex changes enable Plan Mode (double‑Shift+Tab) to let Claude explore the codebase, produce a detailed plan and await approval before execution.
Think modes
Think– basic reasoning. Think more – extended reasoning. Think a lot – comprehensive reasoning. Think longer – longer time budget. Ultrathink – maximum token allocation.
Specify the mode in the prompt, e.g., “Use ultrathink to explore the best implementation.”
Dialogue control
Press Escape to interrupt an off‑track response. Commands to manage context: /compact – summarises the conversation while preserving key knowledge. /clear – wipes the dialogue history for a fresh start.
Custom commands
Create a .claude/commands folder and add markdown files named after the desired command (e.g., audit.md creates /audit). Use $ARGUMENTS placeholders for parameters.
Run `npm audit` to check for vulnerabilities, then `npm audit fix`, and finally run tests to ensure nothing broke. Write comprehensive tests for $ARGUMENTS using Vitest and React Testing Library.Extending with MCP servers
Install a Model Context Protocol (MCP) server to give Claude new capabilities. Example – Playwright MCP for browser automation:
claude mcp add playwright npx @playwright/mcp@latestThis registers a server named playwright and provides the command to start it locally.
Using Playwright MCP
Ask Claude to navigate to localhost:3000, generate a component, review its visual style, and then update the prompt file ( @src/lib/prompts/generation.tsx) for better future outputs.
Navigate to `localhost:3000`, generate a basic component, review its style, then improve the generation prompt accordingly.Permission management
Edit .claude/settings.local.json and add the server to the allow array:
{
"permissions": {
"allow": ["mcp__playwright"],
"deny": []
}
}The double underscore links the permission to the playwright MCP.
Other MCP use cases
MCP servers exist for database interaction, API testing, filesystem operations, cloud service integration, and development‑tool automation, turning Claude into a full‑stack development partner.
Summary
By installing Claude Code, configuring the environment, managing context with CLAUDE.md, using plan/think modes, controlling dialogue flow, creating custom commands, and extending functionality with MCP servers, developers can integrate a secure, customizable AI programming assistant into modern development workflows.
Su San Talks Tech
Su San, former staff at several leading tech companies, is a top creator on Juejin and a premium creator on CSDN, and runs the free coding practice site www.susan.net.cn.
How this landed with the community
Was this worth your time?
0 Comments
Thoughtful readers leave field notes, pushback, and hard-won operational detail here.
