[{"data":1,"prerenderedAt":56},["ShallowReactive",2],{"blog-claude-code-beginners-guide":3,"blog-related-claude-code-beginners-guide":39},{"slug":4,"title":5,"description":6,"category":7,"categoryId":8,"keyword":9,"date":10,"minutes":11,"body":12,"html":13,"headings":14},"claude-code-beginners-guide","Claude Code for beginners: install, first session, habits","Install Claude Code, run your first session and learn the habits that matter: specific prompts, plan before edit, CLAUDE.md, small commits, a clean context.","Getting started","getting-started","claude code for beginners","2026-11-17",5,"Claude Code is an AI coding agent that runs in your terminal, reads your project, edits files and runs commands, asking you first by default. You install it with one command, sign in with a Claude account, and start it inside a project folder. This guide covers the install, a first session, and the handful of habits that separate a good first week from a frustrating one.\n\n## How do you install Claude Code?\n\nYou need a terminal, a project folder and a Claude account (a Pro or Max plan, a Team or Enterprise seat, or a Console account). The recommended install on macOS, Linux and WSL is the native installer:\n\n```sh\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n```\n\nOn macOS you can also use Homebrew (`brew install --cask claude-code`), and on Windows there is a PowerShell installer and WinGet. The native installer updates itself in the background; the Homebrew and WinGet installs do not, so upgrade them yourself from time to time.\n\nOpen a new terminal window afterwards and check it worked:\n\n```sh\nclaude --version\n```\n\nIf your shell says `claude` is not found, the install directory is not on your PATH yet. The official troubleshooting page covers the fix for each shell.\n\n## How do you start your first session?\n\nGo to a project and run `claude`:\n\n```sh\ncd ~\u002Fprojects\u002Fmy-app\nclaude\n```\n\nOn first use it opens your browser to sign in. Later, `\u002Flogin` inside a session switches accounts. Claude Code stores the credentials, so you sign in once.\n\nStart with questions, not edits. It reads files as it needs them; you do not have to paste code in.\n\n```text\nwhat does this project do?\nwhere is the main entry point?\nhow is authentication handled?\n```\n\nThis costs nothing in risk and shows you how it reasons about your code. If its answers are wrong, you have just learned what to put in your [CLAUDE.md](\u002Fblog\u002Fclaude-md-guide).\n\nThen make one small change: \"add a hello world function to the main file\". Claude Code shows the proposed edit and asks before writing. Approve it, look at the diff, run your tests. That loop (ask, review, approve, verify) is the whole product.\n\n## Which commands and shortcuts do you need first?\n\nYou can ignore most of the surface at the start. These are enough:\n\n| You type | What it does |\n| --- | --- |\n| `claude` | Start a session in the current folder |\n| `claude \"fix the build error\"` | Start with a first prompt |\n| `claude -p \"explain this function\"` | Answer once and exit (for scripts) |\n| `claude -c` | Continue the latest session in this folder |\n| `claude -r` | Pick an older session to resume |\n| `\u002Fhelp` | List commands |\n| `\u002Fclear` | Start a fresh conversation with empty context |\n| `\u002Fresume` | Reopen a previous conversation |\n| `Shift+Tab` | Cycle the permission mode of the session |\n\nTyping `\u002F` alone lists every command and skill available to you. More on that in the [slash commands guide](\u002Fblog\u002Fclaude-code-slash-commands).\n\n## Why does Claude Code ask before it acts?\n\nBy default it can read your files freely but asks before editing a file or running a command. That is the permission mode called `default`. Press `Shift+Tab` and the mode changes: accept edits without asking, plan mode (read only, proposes a plan), and so on. The status bar shows which one is on.\n\nFor your first week, stay in the default mode and read what you approve. Once you trust the pattern, move to accept-edits for the work you review at the end anyway. The full list is in [permission modes explained](\u002Fblog\u002Fclaude-code-permission-modes).\n\n## What habits matter in the first week?\n\n**Be specific.** \"Fix the bug\" gives it room to guess. \"Fix the login bug where users see a blank screen after entering wrong credentials\" gives it a target and a way to know it is done.\n\n**Plan before anything non-trivial.** For a change that touches several files, switch to plan mode first. Claude reads, proposes a plan, and changes nothing until you approve. It is much cheaper to correct a plan than a diff. See [plan mode](\u002Fblog\u002Fclaude-code-plan-mode).\n\n**Give it a way to check itself.** Tell it which command runs the tests or the linter (\"run `npm test` and fix failures\"). An agent that can verify its own work needs fewer rounds with you.\n\n**Write down what you keep repeating.** The second time you correct the same mistake, put the rule in a `CLAUDE.md` file at the project root. Run `\u002Finit` and Claude drafts one from your codebase; then cut it down to what it would not guess by itself.\n\n**Commit small and often.** Ask for a commit after each working step (\"commit my changes with a descriptive message\"). Small commits are your undo button, along with `\u002Frewind`, which can roll back the conversation and the file edits to an earlier point.\n\n**Keep the context clean.** A long session fills the context window and quality drops. Use `\u002Fclear` between unrelated tasks and `\u002Fresume` to come back to an old one. When a session gets long but you still need it, `\u002Fcompact` summarizes it.\n\n## What should you not do at the start?\n\n- Do not turn on the mode that skips every permission check. It exists for isolated containers and VMs, and it removes the safety net while you are still learning what the tool does.\n- Do not paste a ten-paragraph spec. Describe the goal, name the files that matter, say how to verify.\n- Do not let one session do three unrelated things. Open a new one.\n- Do not accept diffs you have not read. It is fast to approve and slow to find the bug later.\n\n## Where does it get more powerful?\n\nOnce the basics feel natural, the extension points are where Claude Code starts to feel tailored:\n\n- [CLAUDE.md](\u002Fblog\u002Fclaude-md-guide) for standing instructions about your project.\n- [Skills](\u002Fblog\u002Fclaude-code-skills) for repeatable procedures it loads when relevant.\n- Hooks, MCP servers and subagents for automation, external tools and delegated work.\n- Headless mode (`claude -p`) to run it from scripts and CI.\n\nAdd them one at a time, when a real annoyance asks for it.\n\n## In Relais\n\nRelais is a Mac app (Linux coming) that sits on top of Claude Code once you are comfortable in the terminal. It runs the Claude Code login already on your computer, with no API key, so usage counts toward your Claude plan like it does in a terminal. Its sessions are real Claude Code sessions stored in `~\u002F.claude\u002Fprojects`, so `claude --resume` opens them too. It adds a chat UI with inline approvals and diffs, a project \"group\" that holds several folders, and one-click undo. See [features](\u002Ffeatures) and the [FAQ](\u002Ffaq).","\u003Cp>Claude Code is an AI coding agent that runs in your terminal, reads your project, edits files and runs commands, asking you first by default. You install it with one command, sign in with a Claude account, and start it inside a project folder. This guide covers the install, a first session, and the handful of habits that separate a good first week from a frustrating one.\u003C\u002Fp>\n\u003Ch2 id=\"how-do-you-install-claude-code\">\u003Ca class=\"anchor\" href=\"#how-do-you-install-claude-code\" aria-label=\"Link to this section\">#\u003C\u002Fa>How do you install Claude Code?\u003C\u002Fh2>\n\u003Cp>You need a terminal, a project folder and a Claude account (a Pro or Max plan, a Team or Enterprise seat, or a Console account). The recommended install on macOS, Linux and WSL is the native installer:\u003C\u002Fp>\n\u003Cpre class=\"code\" data-lang=\"sh\">\u003Ccode>curl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>On macOS you can also use Homebrew (\u003Ccode>brew install --cask claude-code\u003C\u002Fcode>), and on Windows there is a PowerShell installer and WinGet. The native installer updates itself in the background; the Homebrew and WinGet installs do not, so upgrade them yourself from time to time.\u003C\u002Fp>\n\u003Cp>Open a new terminal window afterwards and check it worked:\u003C\u002Fp>\n\u003Cpre class=\"code\" data-lang=\"sh\">\u003Ccode>claude --version\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>If your shell says \u003Ccode>claude\u003C\u002Fcode> is not found, the install directory is not on your PATH yet. The official troubleshooting page covers the fix for each shell.\u003C\u002Fp>\n\u003Ch2 id=\"how-do-you-start-your-first-session\">\u003Ca class=\"anchor\" href=\"#how-do-you-start-your-first-session\" aria-label=\"Link to this section\">#\u003C\u002Fa>How do you start your first session?\u003C\u002Fh2>\n\u003Cp>Go to a project and run \u003Ccode>claude\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"code\" data-lang=\"sh\">\u003Ccode>cd ~\u002Fprojects\u002Fmy-app\nclaude\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>On first use it opens your browser to sign in. Later, \u003Ccode>\u002Flogin\u003C\u002Fcode> inside a session switches accounts. Claude Code stores the credentials, so you sign in once.\u003C\u002Fp>\n\u003Cp>Start with questions, not edits. It reads files as it needs them; you do not have to paste code in.\u003C\u002Fp>\n\u003Cpre class=\"code\" data-lang=\"text\">\u003Ccode>what does this project do?\nwhere is the main entry point?\nhow is authentication handled?\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>This costs nothing in risk and shows you how it reasons about your code. If its answers are wrong, you have just learned what to put in your \u003Ca href=\"\u002Fblog\u002Fclaude-md-guide\">CLAUDE.md\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>Then make one small change: &quot;add a hello world function to the main file&quot;. Claude Code shows the proposed edit and asks before writing. Approve it, look at the diff, run your tests. That loop (ask, review, approve, verify) is the whole product.\u003C\u002Fp>\n\u003Ch2 id=\"which-commands-and-shortcuts-do-you-need-first\">\u003Ca class=\"anchor\" href=\"#which-commands-and-shortcuts-do-you-need-first\" aria-label=\"Link to this section\">#\u003C\u002Fa>Which commands and shortcuts do you need first?\u003C\u002Fh2>\n\u003Cp>You can ignore most of the surface at the start. These are enough:\u003C\u002Fp>\n\u003Cdiv class=\"table-wrap\">\u003Ctable>\u003Cthead>\u003Ctr>\u003Cth>You type\u003C\u002Fth>\u003Cth>What it does\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd>\u003Ccode>claude\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Start a session in the current folder\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>claude &quot;fix the build error&quot;\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Start with a first prompt\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>claude -p &quot;explain this function&quot;\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Answer once and exit (for scripts)\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>claude -c\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Continue the latest session in this folder\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>claude -r\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Pick an older session to resume\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>\u002Fhelp\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>List commands\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>\u002Fclear\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Start a fresh conversation with empty context\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>\u002Fresume\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Reopen a previous conversation\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd>\u003Ccode>Shift+Tab\u003C\u002Fcode>\u003C\u002Ftd>\u003Ctd>Cycle the permission mode of the session\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>Typing \u003Ccode>\u002F\u003C\u002Fcode> alone lists every command and skill available to you. More on that in the \u003Ca href=\"\u002Fblog\u002Fclaude-code-slash-commands\">slash commands guide\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"why-does-claude-code-ask-before-it-acts\">\u003Ca class=\"anchor\" href=\"#why-does-claude-code-ask-before-it-acts\" aria-label=\"Link to this section\">#\u003C\u002Fa>Why does Claude Code ask before it acts?\u003C\u002Fh2>\n\u003Cp>By default it can read your files freely but asks before editing a file or running a command. That is the permission mode called \u003Ccode>default\u003C\u002Fcode>. Press \u003Ccode>Shift+Tab\u003C\u002Fcode> and the mode changes: accept edits without asking, plan mode (read only, proposes a plan), and so on. The status bar shows which one is on.\u003C\u002Fp>\n\u003Cp>For your first week, stay in the default mode and read what you approve. Once you trust the pattern, move to accept-edits for the work you review at the end anyway. The full list is in \u003Ca href=\"\u002Fblog\u002Fclaude-code-permission-modes\">permission modes explained\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"what-habits-matter-in-the-first-week\">\u003Ca class=\"anchor\" href=\"#what-habits-matter-in-the-first-week\" aria-label=\"Link to this section\">#\u003C\u002Fa>What habits matter in the first week?\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Be specific.\u003C\u002Fstrong> &quot;Fix the bug&quot; gives it room to guess. &quot;Fix the login bug where users see a blank screen after entering wrong credentials&quot; gives it a target and a way to know it is done.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Plan before anything non-trivial.\u003C\u002Fstrong> For a change that touches several files, switch to plan mode first. Claude reads, proposes a plan, and changes nothing until you approve. It is much cheaper to correct a plan than a diff. See \u003Ca href=\"\u002Fblog\u002Fclaude-code-plan-mode\">plan mode\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Give it a way to check itself.\u003C\u002Fstrong> Tell it which command runs the tests or the linter (&quot;run \u003Ccode>npm test\u003C\u002Fcode> and fix failures&quot;). An agent that can verify its own work needs fewer rounds with you.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Write down what you keep repeating.\u003C\u002Fstrong> The second time you correct the same mistake, put the rule in a \u003Ccode>CLAUDE.md\u003C\u002Fcode> file at the project root. Run \u003Ccode>\u002Finit\u003C\u002Fcode> and Claude drafts one from your codebase; then cut it down to what it would not guess by itself.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Commit small and often.\u003C\u002Fstrong> Ask for a commit after each working step (&quot;commit my changes with a descriptive message&quot;). Small commits are your undo button, along with \u003Ccode>\u002Frewind\u003C\u002Fcode>, which can roll back the conversation and the file edits to an earlier point.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Keep the context clean.\u003C\u002Fstrong> A long session fills the context window and quality drops. Use \u003Ccode>\u002Fclear\u003C\u002Fcode> between unrelated tasks and \u003Ccode>\u002Fresume\u003C\u002Fcode> to come back to an old one. When a session gets long but you still need it, \u003Ccode>\u002Fcompact\u003C\u002Fcode> summarizes it.\u003C\u002Fp>\n\u003Ch2 id=\"what-should-you-not-do-at-the-start\">\u003Ca class=\"anchor\" href=\"#what-should-you-not-do-at-the-start\" aria-label=\"Link to this section\">#\u003C\u002Fa>What should you not do at the start?\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Do not turn on the mode that skips every permission check. It exists for isolated containers and VMs, and it removes the safety net while you are still learning what the tool does.\u003C\u002Fli>\n\u003Cli>Do not paste a ten-paragraph spec. Describe the goal, name the files that matter, say how to verify.\u003C\u002Fli>\n\u003Cli>Do not let one session do three unrelated things. Open a new one.\u003C\u002Fli>\n\u003Cli>Do not accept diffs you have not read. It is fast to approve and slow to find the bug later.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"where-does-it-get-more-powerful\">\u003Ca class=\"anchor\" href=\"#where-does-it-get-more-powerful\" aria-label=\"Link to this section\">#\u003C\u002Fa>Where does it get more powerful?\u003C\u002Fh2>\n\u003Cp>Once the basics feel natural, the extension points are where Claude Code starts to feel tailored:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fblog\u002Fclaude-md-guide\">CLAUDE.md\u003C\u002Fa> for standing instructions about your project.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fblog\u002Fclaude-code-skills\">Skills\u003C\u002Fa> for repeatable procedures it loads when relevant.\u003C\u002Fli>\n\u003Cli>Hooks, MCP servers and subagents for automation, external tools and delegated work.\u003C\u002Fli>\n\u003Cli>Headless mode (\u003Ccode>claude -p\u003C\u002Fcode>) to run it from scripts and CI.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Add them one at a time, when a real annoyance asks for it.\u003C\u002Fp>\n\u003Ch2 id=\"in-relais\">\u003Ca class=\"anchor\" href=\"#in-relais\" aria-label=\"Link to this section\">#\u003C\u002Fa>In Relais\u003C\u002Fh2>\n\u003Cp>Relais is a Mac app (Linux coming) that sits on top of Claude Code once you are comfortable in the terminal. It runs the Claude Code login already on your computer, with no API key, so usage counts toward your Claude plan like it does in a terminal. Its sessions are real Claude Code sessions stored in \u003Ccode>~\u002F.claude\u002Fprojects\u003C\u002Fcode>, so \u003Ccode>claude --resume\u003C\u002Fcode> opens them too. It adds a chat UI with inline approvals and diffs, a project &quot;group&quot; that holds several folders, and one-click undo. See \u003Ca href=\"\u002Ffeatures\">features\u003C\u002Fa> and the \u003Ca href=\"\u002Ffaq\">FAQ\u003C\u002Fa>.\u003C\u002Fp>\n",[15,18,21,24,27,30,33,36],{"id":16,"text":17},"how-do-you-install-claude-code","How do you install Claude Code?",{"id":19,"text":20},"how-do-you-start-your-first-session","How do you start your first session?",{"id":22,"text":23},"which-commands-and-shortcuts-do-you-need-first","Which commands and shortcuts do you need first?",{"id":25,"text":26},"why-does-claude-code-ask-before-it-acts","Why does Claude Code ask before it acts?",{"id":28,"text":29},"what-habits-matter-in-the-first-week","What habits matter in the first week?",{"id":31,"text":32},"what-should-you-not-do-at-the-start","What should you not do at the start?",{"id":34,"text":35},"where-does-it-get-more-powerful","Where does it get more powerful?",{"id":37,"text":38},"in-relais","In Relais",[40,46,51],{"slug":41,"title":42,"description":43,"category":7,"categoryId":8,"keyword":44,"date":10,"minutes":45},"claude-code-hooks","Claude Code hooks: run a script on every tool call","Claude Code hooks run your own script before or after a tool call. Learn the config format, exit codes and three working examples you can paste today.","claude code hooks",6,{"slug":47,"title":48,"description":49,"category":7,"categoryId":8,"keyword":50,"date":10,"minutes":11},"claude-code-permission-modes","Claude Code permission modes explained (and when to use each)","Default, acceptEdits, plan, auto, dontAsk and bypassPermissions: what each Claude Code permission mode allows, how to switch, and which one fits which job.","claude code permission modes",{"slug":52,"title":53,"description":54,"category":7,"categoryId":8,"keyword":55,"date":10,"minutes":11},"claude-code-skills","Claude Code skills: what they are and how to write one","A Claude Code skill is a folder with a SKILL.md that Claude loads when relevant or you call with a slash. See the format, frontmatter fields and an example.","claude code skills",1794931098787]