Claude Code Guide
Just installed Claude Code? 30-minute crash course: CLAUDE.md → daily commands → full auto → create repo & open PR.
A 30-minute crash course for someone who just installed Claude Code. From "I don't know what to type" to "fully automated coding + Claude creates my GitHub repo and opens the PR." Ordered chronologically — read top to bottom and you're up to speed.
~/.claude/CLAUDE.md ── once, applies to every projectClaude reads this on every project startup. Tell it who you are, what languages you write, your code style preferences. Never repeat yourself again. Template:
My name is Alex. I write mostly TypeScript and Python. Code style: small modules, clear names, avoid unnecessary abstraction. Don't add libraries I didn't ask for. Don't add comments unless the logic is genuinely unclear. Reply style: get straight to the answer, no lengthy preamble. If you're unsure about something, ask first.Write once → applies to every future project
./CLAUDE.md ── project-specific contextThe global one says "who I am." The project one says "what this project looks like": tech stack, directory conventions, build commands, things to avoid. Claude reads both when it starts up inside the project.
Every new project root: touch CLAUDE.md/init ── don't want to write it yourself? One command auto-generates itOpen Claude in a project root and type /init. It scans the codebase and generates a CLAUDE.md (detected stack, directory layout, key commands). Read through and just add your personal preferences on top.
/help ── any time you forget what's availableLists every slash command in this session — built-ins, plugin-provided, and project-local. Just installed something and forgot the trigger name? Run /help first.
With the input box focused, press once for Auto-accept edits (file changes auto-approved, Bash still asks). Press twice for Bypass permissions (full auto, asks nothing). Daily driver: stay on Auto-accept — fast and safe.
Daily: Shift+Tab once → Auto-accept mode/context ── see how much context you've usedShows total tokens used, what's eating them (MCP tools / skills / messages / system), and free space remaining. When Free space drops below 30%, time to /compact or /clear.
/compact vs /clear ── condense or wipe/compact: summarize the conversation so far, keep the gist, continue the same task./clear: zero out, only CLAUDE.md remains.
Rule: same task continuing → compact. Switching to a new task → clear.
/aside ── side question without polluting the main taskYou're deep in something complex and need to ask a quick unrelated question (syntax check, doc lookup)? Use /aside. Claude answers, then automatically returns to the main task — no context pollution. 100× cleaner than opening a new window or running /clear.
Claude going the wrong way? Hit Esc to stop immediately. Want to fix your last prompt instead of resending? Double-tap Esc and edit it inline. No copy-paste, no restart.
Going wrong → Esc · Edit last → Esc EscPress Shift+Tab once. File Edit/Write auto-approves; Bash commands (especially destructive ones) still ask. Use it: TDD, refactoring, writing new features — visible, controllable changes. Don't use it: when editing .env, settings.json, or other sensitive config.
Default on, switch off before sensitive filesPress Shift+Tab a second time and nothing asks for confirmation — including rm -rf, git push --force, deleting emails, changing system settings. Only use when: ① working tree is committed, ② you trust the current task, ③ you're not on a production system or important account. Switch back the moment you're done.
/model ── switch models, save up to 3× costThree tiers:
Opus 4.8 (latest flagship, May 2026): main coding + complex architecture, agentic coding 64%→69%, ~4× less likely than 4.7 to leave bugs unmentioned.
Sonnet: balanced, cheaper for daily work.
Haiku: 90% capability / ~3× cheaper — use it for batch refactors, doc edits, JSON cleanup, anything mechanical.
Switch mid-session anytime with /model; arrow keys also adjust the effort level. No restart needed.
/fast · /effort · dynamic workflows/fast on: Fast Mode — 2.5× faster output, same quality, 3× cheaper on Opus 4.8. Keep it on for everyday iteration/debugging./effort: tune reasoning depth across six levels low/medium/high/xhigh/max/ultracode. Mechanical → /effort low, hard problems → /effort xhigh.
Dynamic Workflow: the biggest new capability in Opus 4.8 — covered in full in the next step ↓.
/workflows ── let Claude run dozens to hundreds of agents at onceWhat it solves: Normally every intermediate step Claude takes piles into the conversation context, and a few dozen steps blow out your window. A dynamic workflow has Claude write an orchestration script that runs a large batch of subagents in the background — the plan and intermediate results live in script variables, so your context holds only the final answer. This is how Opus 4.8 pushes "fully automated" to its limit.
How it differs from plain subagents: with plain subagents Claude decides turn by turn who to spawn and every result lands in context, so scale stays small. A workflow moves the loop, branching, and results into the script — an order of magnitude more agents (dozens to hundreds) — and is resumable within the same session (completed agents return cached results). The script can also have agents adversarially review each other's findings before reporting, giving a more trustworthy result than a single pass.
Three ways to trigger:
① Put the word workflow in a prompt — e.g. "run a workflow to audit every endpoint under src/routes/ for missing auth" — and Claude writes a script on the spot.
② /effort ultracode — once on, Claude plans a workflow for every substantive task (a single request may split into understand → change → verify). It burns more tokens; drop back with /effort high for routine work.
③ Bundled — currently one: /deep-research <question> (multi-angle search + cross-check + cited report).
/workflows is the progress board: it does not start anything — it lets you watch the background runs. Arrow keys to select, Enter to drill into a phase/agent and see what it's doing; p pause/resume, x stop, r restart an agent, s save the run's script as your own /command for reuse.
Hard limits (official): up to 16 agents concurrently, 1,000 total per run (runaway guard); no mid-run input (split into multiple workflows if you need sign-off between stages); requires Claude Code v2.1.154+, and Pro users must enable it in /config first; resume only works within the same session — exit and it restarts fresh.
The key idea: drop a skill into ~/.claude/skills/<name>/SKILL.md (personal level, every project) and you never import it or remind Claude. Claude invokes it automatically when your words match the trigger terms in its description. Adding/editing/removing a skill takes effect in the current session — no restart. Forgot what's installed? Ask "what skills are available?" or run /skills.
Worked example ── the official GSAP animation skills (7.5k★): one line installs all 8 modules (core API / timeline / ScrollTrigger / plugins / React·Vue·Svelte / performance):
npx skills add https://github.com/greensock/gsap-skills
After install, zero config — just talk to Claude and it taps the right module:
· "add an entrance animation to this hero" → uses gsap-core
· "build a ScrollTrigger parallax" → uses gsap-scrolltrigger
· "write a timeline sequence in React" → uses gsap-react + gsap-timeline
Bonus: after Webflow's acquisition, formerly-paid plugins like SplitText and MorphSVG are now free, and the gsap-plugins module shows you how to use them.
Configure hooks in ~/.claude/settings.json. After every Edit/Write, Claude auto-runs the command you specify (Prettier, vitest, tsc). Configure once, every project benefits forever. Example:
{
"hooks": {
"PostToolUse": [{
"matcher": "Write|Edit",
"hooks": [{
"type": "command",
"command": "npx prettier --write $CLAUDE_FILE_PATHS"
}]
}]
}
}
Configure once → benefit forever
@filename · /add-dir ── feed Claude extra content@src/api/user.ts: precisely @-mention a file in your message; Claude reads it in full immediately./add-dir ../shared-libs: add a directory outside the current project to the accessible scope (by default Claude only sees the current dir).
Tell Claude: "Launch 3 sub-agents in parallel: one analyzes the auth module's security, one reviews cache performance, one type-checks the utility functions." Claude uses the Task tool to dispatch all three simultaneously — same wall-clock time, 3× the output. Always run independent work in parallel.
Independent work → always say "in parallel"Prereqs: install GitHub CLI brew install gh, then gh auth login (browser handshake, once). Then tell Claude:
"Initialize this directory as a git repo, create a same-named public GitHub repo, write a sensible README and .gitignore, then push the first commit."
Claude runs the whole sequence: git init → write README/.gitignore → first commit → gh repo create → push. Done in 90 seconds.
The standard collaboration loop. Have Claude run each step:
/review — Claude grades it from an engineer's lensEvery command in one table.
| Command / Shortcut | What it does | When to use |
|---|---|---|
~/.claude/CLAUDE.md | Global instruction file | Write once after first install |
./CLAUDE.md | Project instruction file | One per new project root |
/init | Auto-generate project CLAUDE.md | New project, save typing |
/help | List all available commands | Forgot a command name |
| Shift+Tab | Cycle permission mode (3 states) | Daily driver: Auto-accept |
/context | Show context usage | Decide when to compact |
/compact | Condense conversation | Same task continuing |
/clear | Wipe conversation history | Switching to a new task |
/aside [q] | Side question, no pollution | Quick syntax/doc lookup |
| Esc | Interrupt Claude | It's going the wrong way |
| Esc Esc | Edit previous message | Tweak the prompt, don't resend |
/model | Switch model | Mechanical work → haiku |
@path | Reference a specific file | Make Claude read one file precisely |
/add-dir | Expand accessible directory | Need code outside the project |
/review | Self-review code | Last gate before commit |
gh repo create | Create a GitHub repo | First push of a new project |
/fast | Fast Mode (2.5× speed, cheaper) | Everyday iteration/debugging |
/effort | Reasoning depth (low→ultracode) | Mechanical low · hard xhigh |
workflow (keyword) | Trigger a dynamic workflow (background agents) | Full-repo sweep / migration / cross-checked research |
/workflows | Board: watch/pause/stop/save workflows | Track a running workflow |
/batch | Large change split into parallel worktrees + PRs | Big migration / full-repo refactor |
/deep-research | Multi-source search + cross-check + cited report | When you need trustworthy research |
Vexilo is the missing index for Claude Code — 31 agents, 125 commands, 123 skills and more, organized by scenario. Browse free; unlock search, filters and one-click CLAUDE.md export with a one-time $19 licence.