[DOCS] Docs: Add "Getting Started" Quickstart to README

Resolved 💬 4 comments Opened Sep 16, 2025 by nsalvacao Closed Jan 5, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://github.com/anthropics/claude-code/blob/main/README.md

Section/Topic

Getting Started

Current Documentation

_No response_

What's Wrong or Missing?

After a successful pip install claude-code, the current README.md does not provide immediate guidance on the essential next steps a user should take.

Users are left without knowing how to:

  • Authenticate (claude login)
  • See available commands (claude --help)
  • Start their first session

This creates a significant point of friction during the onboarding of new users, who may feel lost after the installation.

Suggested Improvement

Add a "Getting Started" section to the README.md immediately after the Installation section. This section should provide a concise, step-by-step guide for a user's first run:

---

Getting Started

After installing the package, here’s how to start your first session:

  1. See all available commands:

Get a full list of what you can do.
claude --help

  1. Log in to your account:

This will open a browser window to authenticate your CLI.
claude login

  1. Start a new session:

You're all set! Start a new interactive session by running:
claude

---

Impact

Medium - Makes feature difficult to understand

Additional Context

I'm happy to create a Pull Request with these changes. I can ensure the new section is well-formatted and, if the maintainers find it helpful, I can expand it with more detailed examples to make the onboarding process as smooth as possible for new users.

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗