[DOCS] Docs: Add "Getting Started" Quickstart to README
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:
- See all available commands:
Get a full list of what you can do.claude --help
- Log in to your account:
This will open a browser window to authenticate your CLI.claude login
- 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.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗