# Claude Code for beginners: your first hour > Claude Code for beginners: it needs a paid Claude plan or a Console account, installs with one command, and is safest if you commit to git first. Source: https://shuriken.sh/guides/claude-code-for-beginners Claude Code for beginners: it needs a paid Claude plan or a Console account, installs with one command, and is safest if you commit to git first. By Shuriken Updated 27 October 2026 6 min read **Contents** Claude Code for beginners comes down to four steps in the first hour: install the claude command, sign in with a paid Claude plan, give it one small task in a project folder, and learn five slash commands. From then on, Claude Code reads your files, runs commands and makes changes from plain-English requests, as far as its permission mode allows. We assume you have a code project and have opened a terminal before. If the terminal is new to you, [Anthropic's quickstart](https://code.claude.com/docs/en/quickstart) links a terminal guide first. ## What beginners need before starting # - A paid Claude plan or a Console account. As of 22 October 2026, [Anthropic's pricing page](https://claude.com/pricing) includes Claude Code in Pro ($20 a month, or $17 a month billed yearly) and Max (from $100 a month). The free plan doesn't include it. A Claude Console account works too, billed at API rates. - A project folder: any code you're working on, ideally one that's already in git (more on that below). - About ten minutes for setup. The rest of the hour is using it. ## Step 1: Install Claude Code # Open a terminal and run the command for your system, from Anthropic's quickstart: | System | Command | | --- | --- | | macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash | | Windows PowerShell | irm https://claude.ai/install.ps1 | iex | | macOS with Homebrew | brew install --cask claude-code | | Windows with WinGet | winget install Anthropic.ClaudeCode | Then open a new terminal window and run claude --version. What you might see: - A version number followed by (Claude Code): it worked. - claude not found: the install folder isn't on your PATH yet. [claude: command not found](https://shuriken.sh/guides/claude-command-not-found) has the fix for each system. - 'irm' is not recognized as an internal or external command: you pasted the PowerShell line into CMD. The curl and irm installs update themselves in the background. Homebrew and WinGet installs don't, so run brew upgrade claude-code or winget upgrade Anthropic.ClaudeCode now and then. On native Windows, Anthropic also recommends Git for Windows, so Claude Code can use its Bash tool. On Linux you can install from Anthropic's apt, dnf or apk repository instead ([install Claude Code on Linux](https://shuriken.sh/guides/install-claude-code-on-linux)), and a Chromebook runs the same command once ChromeOS's Linux environment is on ([Claude Code on a Chromebook](https://shuriken.sh/guides/claude-code-on-a-chromebook)). ## Step 2: Sign in # Go to your project folder and start Claude Code: bash cd /path/to/your/project claude On first use it opens your browser. Pick your Claude account and approve; that computer stays signed in. The prompt appears, with the version, the current model and the working directory above it. To switch accounts later, type /login inside Claude Code. If ANTHROPIC_API_KEY is set in your shell, Claude Code asks whether to use the key, and if you approve, it skips the browser login and bills the key. Anthropic's help page says this results in "API usage charges rather than using your subscription's included usage". If you meant to use your plan, decline and run unset ANTHROPIC_API_KEY. Sign-in loops are covered in [Claude Code keeps asking me to log in](https://shuriken.sh/guides/claude-code-keeps-asking-to-log-in). ## Step 3: Your first task # Ask a question before you ask for a change: text what does this project do? Claude reads the files it needs and explains. Then try a small, safe change: text add a short "How to run it" section to the README, based on package.json The status bar shows the permission mode, and the mode decides what happens next ([permission modes](https://code.claude.com/docs/en/permission-modes)): - Auto mode, where a new session usually starts on recent versions: Claude makes the change without asking, and a second model, a classifier, reviews risky actions in the background. - Manual mode: Claude shows the change and asks first. Read it, then choose Yes. claude --permission-mode manual starts a session in Manual. - Shift+Tab cycles through the modes at any time. Anthropic's quickstart gives two tips for the prompt itself. Name the problem: not "fix the bug" but "fix the login bug where users see a blank screen after entering wrong credentials". And break a big ask into steps, because a numbered list of three steps works better than one paragraph that asks for everything. Shuriken moves a running chat to another of your own accounts when one reaches its limit, on every device. [Download](https://shuriken.sh/download) ## The five commands that matter # Claude Code has dozens of slash commands, and a beginner needs five of them most days. The quoted descriptions are Anthropic's own, from the [commands reference](https://code.claude.com/docs/en/commands): | Command | What it does | When to use it | | --- | --- | --- | | /init | "Initialize project with a CLAUDE.md guide" | Once per project. It writes a file of notes Claude reads at the start of every session | | /clear | "Start a new conversation with empty context" | Between unrelated tasks | | /compact | "Free up context by summarizing the conversation so far" | When a long task gets slow or forgetful | | /rewind | "Rewind the conversation and/or code to a previous point" | When Claude went the wrong way | | /usage | "Show session cost, plan usage limits, and activity stats" | To see how much of your limit is left | Four more keys and flags: - Esc stops Claude mid-action, and Esc twice opens the same menu as /rewind. - /help lists every other command. - claude -c picks up the last conversation in this folder. - claude -r lets you choose an earlier one from a list. ## How the limits work # Claude Code shares your plan's limits with the Claude app. Anthropic's pricing page says so in one line, "Your activity across Claude on web, desktop, mobile, and Claude Code all draws from the same pool", and sets out the clock in another: "Every plan has usage limits that reset on a rolling five-hour session window, and paid plans add weekly limits on top." - A long coding session can use up your five-hour window, and chatting in the Claude app in the same window draws on the same pool. - At the limit you wait for the reset, move to a higher plan, or, on a paid plan, turn on usage credits to keep working at API rates (the pricing page's own list). - Claude Code uses more than chat, because it reads files and runs commands, and each file it reads is context. The [5-hour limit explained](https://shuriken.sh/guides/claude-5-hour-limit-explained) covers the window in detail, and [how to check Claude Code usage](https://shuriken.sh/guides/check-claude-code-usage) shows where to read what's left. ## How not to break things # Claude Code changes real files on your computer. Three habits keep that safe. - Commit to git before you start. Then any change is one git diff to read and one git restore to undo. You can even ask Claude to "commit my changes with a descriptive message". If the project isn't in git yet, run git init and make a first commit before anything else. - Don't treat rewind as a backup. Checkpoints are handy, but Anthropic warns they "only track changes made through Claude's file editing tools. Changes made through Bash commands or external processes are not captured. This isn't a replacement for git." - Read before you approve. New sessions often start in auto mode, which doesn't ask. Early on, switch to Manual mode (the status bar reads ⏸ manual mode on), which stops and asks before most file edits and shell commands. Approve actions one by one until you've seen how Claude works on your project, and allow more once you trust it. Later, add a check Claude can run: "Run the tests and paste the output" turns "looks done" into "is done". We do this with a failing test first, written up in [test-driven development with Claude Code](https://shuriken.sh/blog/tdd-with-claude-code). ## If you'd rather have windows than a terminal # Not everyone takes to the terminal. Anthropic itself offers a desktop app and a VS Code extension, and [Claude Code desktop app alternatives](https://shuriken.sh/compare/claude-code-desktop) compares the desktop app with the others. Shuriken is one of those alternatives. It runs Claude Code on your own computer, with your own Claude account, in an app with windows. Each task is a chat, its changes sit in a Changes panel, and each new chat works on its own git branch, so trying something doesn't touch your main copy. On a new computer, Shuriken installs the tools that are missing. It also runs Codex, Gemini CLI and other agents the same way, should you want them later. The ideas you learn here, from prompts to limits, carry over either way. If windows suit you better, [download Shuriken](https://shuriken.sh/download). Try the free tool: [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude) Share [X](https://x.com/intent/post?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-for-beginners&text=Claude%20Code%20for%20beginners%3A%20your%20first%20hour)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-for-beginners)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-for-beginners&t=Claude%20Code%20for%20beginners%3A%20your%20first%20hour)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-for-beginners&title=Claude%20Code%20for%20beginners%3A%20your%20first%20hour)[E-mail](mailto:?subject=Claude%20Code%20for%20beginners%3A%20your%20first%20hour&body=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-for-beginners) ## Sources - [Quickstart (Claude Code docs)](https://code.claude.com/docs/en/quickstart) (accessed 22 October 2026) - [Commands reference (Claude Code docs)](https://code.claude.com/docs/en/commands) (accessed 22 October 2026) - [Best practices for Claude Code: checkpoints and course-correcting](https://code.claude.com/docs/en/best-practices) (accessed 22 October 2026) - [Permission modes (Claude Code docs)](https://code.claude.com/docs/en/permission-modes) (accessed 22 October 2026) - [Claude plans and pricing](https://claude.com/pricing) (accessed 22 October 2026) - [Use Claude Code with your Pro or Max plan (Claude Help Center)](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan) (accessed 22 October 2026) ## Frequently asked questions **Is Claude Code free?** No. As of 22 October 2026, Anthropic's pricing page lists Claude Code on Pro, Max, Team and Enterprise, not on the free plan. You can also use it with a Claude Console account and pay API rates. **Do I need to know how to code to use Claude Code?** It helps. Claude Code writes and runs code for you, but you review its changes, read its diffs and decide when it's done. Beginners do fine on small projects, especially with git as a safety net. **Does Claude Code use the same limits as the Claude app?** Yes, on Pro and Max. Anthropic's help page says the limits are shared across Claude and Claude Code, so a long coding session leaves less for chat in the same window. **Can Claude Code delete my files?** Depending on the permission mode, it asks you first or a safety check reviews risky actions, and checkpoints let you rewind its file edits. Checkpoints don't track changes made by shell commands, so commit to git before you start. **Is there a Claude Code app with windows instead of a terminal?** Yes. Anthropic offers a desktop app and a VS Code extension, and third-party apps such as Shuriken run Claude Code in a window too. Source switching One account runs dry. The next one takes over. Add the Claude, Codex and Gemini accounts you own. At your switch point, your chats move to another of them and keep going. [Download](https://shuriken.sh/download) [Other platforms](https://shuriken.sh/download#main) ## Keep reading - [Claude Pro vs Max for Claude Code: Guide 27 Oct 2026 5 min read Pro suits a few Claude Code sessions a week; Max suits daily heavy use and parallel agents. Prices, limits, the signs you've outgrown Pro, and upgrading.](https://shuriken.sh/guides/claude-pro-vs-max-for-claude-code) - [How to switch Claude accounts without logging out: Guide 27 Oct 2026 7 min read Three ways to use several Claude accounts in Claude Code without /logout and /login: one config per account, a switcher CLI, or a harness.](https://shuriken.sh/guides/switch-claude-accounts-without-logging-out) - [Claude usage limit reached? What to do next: Guide 27 Oct 2026 6 min read There's no early reset for Claude's 5-hour or weekly limit. Wait, pay for usage credits, switch to an API key, or carry on with another account you own.](https://shuriken.sh/guides/claude-limit-reached-what-to-do) - [Claude's weekly limit, explained: Guide 27 Oct 2026 6 min read Paid Claude plans have a weekly limit on top of the 5-hour window. When it resets, how model limits fit in, and why parallel agents reach it in two days.](https://shuriken.sh/guides/claude-weekly-limit-explained) - [Claude Code 429 error: what it means and how to fix it: Guide 27 Oct 2026 5 min read A Claude Code 429 rate limit error means you hit an allowance, not an outage: your plan's window, your API tier or a spend cap. Which one, and what to do.](https://shuriken.sh/guides/claude-code-429-rate-limit-error) - [Codex usage limits explained (2026): Guide 27 Oct 2026 5 min read How Codex limits work on ChatGPT Plus and Pro: the 5-hour and weekly windows, the 2026 changes, checking yours with /status, and using several accounts.](https://shuriken.sh/guides/codex-usage-limits) - [Anthropic API rate limit tiers: how to move up: Guide 27 Oct 2026 5 min read Anthropic API rate limit tiers set a monthly spend cap and per-minute limits. The tiers in October 2026, how to move up, and what Claude Code hits first.](https://shuriken.sh/guides/anthropic-api-rate-limit-tiers) - [Claude Code 529 overloaded: why it happens, what to do: Guide 27 Oct 2026 5 min read A 529 overloaded error means Anthropic's API is at capacity, not that your quota ran out. Why Claude Code shows it, what helps and what doesn't.](https://shuriken.sh/guides/claude-code-529-overloaded) ## Free tools - [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude) - [Codex limit reset tracker](https://shuriken.sh/tools/limit-resets/codex)