Skip to content

Instantly share code, notes, and snippets.

@johnnymo87
Last active January 4, 2026 13:33
Show Gist options
  • Select an option

  • Save johnnymo87/192e93341cc7c750d5e698997414299c to your computer and use it in GitHub Desktop.

Select an option

Save johnnymo87/192e93341cc7c750d5e698997414299c to your computer and use it in GitHub Desktop.
Tips for using Claude Code effectively

Tips for Using Claude Code Effectively

Getting Started & Configuration

Use the Best Model

Use Claude Opus 4.5 - it's the most capable model. If your company is paying for it, take advantage of it.

Run with --dangerously-skip-permissions

Nobody has time to approve every single action. If you trust your setup, run with --dangerously-skip-permissions. It's fine.

Keep CLAUDE.md Small and Focused

A small, well-placed CLAUDE.md file makes a big difference. Put project-specific instructions where they'll be found - at the repo root or in .claude/.

Slash Commands vs Skills

Both let you create reusable workflows. The difference:

  • Slash commands (/command-name): Explicit, user-invoked macros. Predictable - runs exactly when you call it. Store in .claude/commands/.
  • Skills: Capability packages Claude loads automatically when your request matches the skill's description. Good for "always apply when relevant" team standards, but discovery can be unreliable.

Rule of thumb: Use slash commands for deterministic workflows you want explicit control over. Use skills when you want Claude to opportunistically apply knowledge/checklists without you remembering to invoke them.

Core Workflow Principles

Context Window Hygiene

Be conscious of context window cleanliness. If past context is helpful for your next task, it's fine to pivot within the same session. Otherwise, start a new session for unrelated work.

Claude Code's CLI Philosophy

Claude Code excels at CLI-heavy workflows. If something has a CLI, give it to Claude Code.

MCP servers can be finicky, but CLI tools have decades of maturity. Prefer:

  • GitHub: Use gh instead of a GitHub MCP server
  • Git: Direct git commands
  • Kubernetes: kubectl
  • Azure: az CLI
  • Clipboard: pbpaste/pbcopy (macOS), Get-Clipboard/Set-Clipboard (PowerShell on Windows)
  • VPN: Whatever CLI your VPN provides for enable/disable and network switching

Session & Context Management

Session Navigation

  • Double-tap Escape: Pull up conversation history with the option to rewind. You can optionally remove code written in the rewound section.
  • /resume: Browse past conversations in the same working directory. Great for "I had to restart my computer" scenarios or continuing previous work.

Use Git Worktrees

Work on multiple unrelated tasks simultaneously. No need to wait for one Claude Code session to finish one task before starting the next. I basically use git worktree instead of git branch: one worktree per task. One Claude Code instance per task. (Note: I don't do any of that fancy "let's do all the steps of the plan in parallel via worktrees and then merge them at the end" stuff.)

Advanced: Forking Conversations with Worktrees

Want to continue your current conversation AND go back to an earlier point to try something different? Use this workflow:

  1. Leave your current session running in terminal tab 1
  2. Open a new terminal tab (tab 2) in a different worktree
  3. Run /resume and select your current conversation (now you have two copies at the same point)
  4. Rewind one of them (now you have two divergent copies exploring different approaches)

Each tab operates in its own worktree, so the contexts remain truly independent.

Debugging & Development Techniques

Screenshot Debugging

Claude can view screenshots - very useful for debugging UI issues. You can either:

  • Tell Claude to read an image file on your machine
  • Paste directly into the conversation (Ctrl+V on macOS, likely the same on Windows, possibly Alt+V)

Research with External Tools

For cutting-edge information, don't rely solely on Claude's training data. I have a /so-question command that formats the problem as a self-contained Stack Overflow question, then I paste this into ChatGPT with web search enabled (it sometimes does 100+ searches). This back-and-forth between implementation and research helps when Claude's knowledge might be outdated.

Ecosystem & Extensions

Plugins and Tools I Use

  • superpowers: A Claude Code plugin with useful skills. I particularly use:
    • Brainstorming
    • TDD (Test-Driven Development)
  • beads: A more robust TODO/issue tracker than Claude Code's built-in TodoWrite
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment