Skip to content

Instantly share code, notes, and snippets.

@BrennerSpear
Last active April 14, 2026 23:32
Show Gist options
  • Select an option

  • Save BrennerSpear/cf2fed01a19c65bddca76e6a7dd6dc10 to your computer and use it in GitHub Desktop.

Select an option

Save BrennerSpear/cf2fed01a19c65bddca76e6a7dd6dc10 to your computer and use it in GitHub Desktop.
Claude Code in Warp: beginner-friendly setup guide

Claude Code in Warp: a beginner-friendly setup guide

This is the fastest clean setup I know for someone who has never really used the terminal before.

The goal is simple:

  1. Install Warp (a nicer terminal)
  2. Install Claude Code
  3. Make sure your terminal can find the claude command
  4. Add a short cc shortcut
  5. Open Claude Code in a real project folder and log in

Step 1: Download Warp

Go here:

Download it, install it, and open it.

Important note: you do not need to sign up for Warp to use it

Warp officially made login optional. If Warp asks you to sign up or log in, you can skip that and keep going.

References:


Step 2: Install Claude Code

Go here if you want the official docs:

The official one-line install command for macOS, Linux, and WSL is:

curl -fsSL https://claude.ai/install.sh | bash

What this does

This downloads Claude Code from Anthropic and installs it.

If your computer asks to install developer tools, say yes

On macOS especially, you may get prompted to install Command Line Tools / developer tools.

If that happens, accept it.

That is normal. Your machine is just installing the basic system tools needed for developer software to work properly.


Step 3: Make sure claude is in your PATH

Claude Code’s native install uses ~/.local/bin/claude on macOS/Linux/WSL. Your shell needs to know to look there.

Paste this into Warp:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

Then paste this:

source ~/.zshrc

Then check it:

which claude

If everything worked, which claude should print a path, usually:

/Users/your-name/.local/bin/claude

What PATH means

PATH is just the list of folders your terminal searches when you type a command.

So when you type claude, your shell checks those folders to find the Claude Code program.

Why you need source ~/.zshrc

Your ~/.zshrc file is your shell startup config.

When you add a new line to it, your current Warp tab does not automatically reload that file.

Running:

source ~/.zshrc

tells your current shell:

“Reload my config right now.”

Without source, the change usually only takes effect in a new terminal tab or after reopening Warp.


Step 4: Add a short cc shortcut

If you do not want to type the full Claude command every time, add an alias.

Paste this into Warp:

echo 'alias cc="claude --dangerously-skip-permissions"' >> ~/.zshrc

Then reload your shell again:

source ~/.zshrc

You can confirm the alias exists with:

type -a cc

or:

alias cc

What this does

Now typing:

cc

will run:

claude --dangerously-skip-permissions

Important warning

That flag is real. It means Claude can take actions without asking you for every single approval.

That is great for flow, but it also means:

  • use it in a project folder you actually mean to work in
  • do not use it casually around secrets, production systems, or random directories
  • if you want the safer official alternative later, Anthropic now also has auto mode

Step 5: Start Claude Code and log in

First, move into a real workspace directory.

I like keeping projects in a dedicated folder.

A common beginner-friendly version is:

mkdir -p ~/projects
cd ~/projects

If you already have a stronger opinion and want a global folder, you can use /projects, but ~/projects is easier on most personal machines because it does not usually require admin setup.

Now create a project folder. Example:

mkdir -p ~/projects/clay
cd ~/projects/clay

Then start Claude Code:

cc

If you did not make the alias, just run:

claude

First login

The first time Claude Code opens, it will ask you to log in.

If you have a Team or Enterprise account through work, make sure you log in with that account rather than a random personal one.

Why this matters:

  • your access may depend on your company account
  • billing / entitlements may be tied to that account
  • your company workspace may already have the right permissions and setup

Claude Code officially supports login with:

  • Claude Pro / Max / Team / Enterprise
  • Claude Console
  • some supported cloud-provider setups

Step 6: What folder should you work in?

Claude Code works best when you open it inside a specific project folder.

That gives it a clean workspace and keeps your work organized.

A simple structure looks like this:

~/projects/
  clay/
  side-project/
  personal-site/

If you work at a company like Clay, you can just have a project folder called clay and do a lot of your work there.

The important idea is: give Claude a real workspace, not your whole computer.


The shortest possible version

If you just want the exact commands:

curl -fsSL https://claude.ai/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
echo 'alias cc="claude --dangerously-skip-permissions"' >> ~/.zshrc
source ~/.zshrc
mkdir -p ~/projects/clay
cd ~/projects/clay
cc

Tiny mental model for beginners

You only really need to understand four things:

  • Warp = the app where you type terminal commands
  • Claude Code = the AI coding tool you install into the terminal
  • PATH = where your shell looks for commands like claude
  • source ~/.zshrc = “reload my terminal config right now”

If you understand those four things, the setup stops feeling mysterious.


Official references

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment