[DOCS] Repository name and README title don't distinguish Claude Code CLI from broader Claude Code branding (suggest renaming to claude-code-cli)
Summary
While following a tutorial on Claude Code, I was directed to install "Claude Code" in two different contexts:
- A desktop app with a graphical chat interface
- A CLI tool for the terminal
When searching the anthropics GitHub organization for a "claude-code-cli" repository, I only found claude-code. After reading the README, I confirmed this repository is in fact the CLI installation source — the README explicitly describes it as living in the terminal — yet both the repository name and the README title simply say "Claude Code," with no indication that this is the CLI-specific repo.
Documentation Type
Unclear/confusing documentation
Documentation Location
https://github.com/anthropics/claude-code (README.md)
Section/Topic
README title / repository name
Current Documentation
Repository name: claude-code
README heading and intro:
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows -- all through natural language commands. Use it in your terminal, IDE, or tag @claude on GitHub.
What's Wrong or Missing?
"Claude Code" is used as an umbrella term across multiple surfaces: a CLI/terminal tool, IDE extensions, and a desktop app with a GUI chat interface. However, neither the repository name nor the README title distinguishes this repo as the CLI-specific one — despite the README's own description confirming it lives in the terminal and is installed via CLI/npm.
For someone following a tutorial that references installing "Claude Code" (in a GUI/desktop context) and then separately references installing the "Claude Code CLI" (pointing to this same repo), it becomes unclear whether:
- This repository is the canonical source for all Claude Code surfaces, or
- This repository is CLI-specific, and the GUI/desktop app lives elsewhere
There's no disambiguation in either the repo name or the README addressing this.
Suggested Improvement
- Repository name: Rename
claude-codetoclaude-code-clito precisely reflect its scope. - README title: Update the top-level heading from "Claude Code" to "Claude Code CLI" to match.
If a rename isn't desirable (e.g. due to existing links, stars, forks, SEO), an acceptable lighter-weight alternative would be adding a short disambiguation note directly under the README title, e.g.:
This repository contains the source and installation instructions for the Claude Code CLI. For the Claude Code desktop app (GUI), see [link].
Impact
Medium - Causes confusion or extra work
Additional Context
Encountered this while following a Claude Code tutorial that separately referenced:
- Installing the Claude Code desktop app (GUI chat interface)
- Installing the Claude Code CLI, linking to this repository
Searching the anthropics GitHub org for "claude-code-cli" returns no dedicated repo — only claude-code, whose name and README title don't disambiguate CLI vs. broader "Claude Code" branding. This mismatch caused momentary confusion about whether GUI and CLI share this repo or whether a separate one exists.
I understand a rename has real costs (existing stars/forks/links, downstream references), so I'm opening this as a proposal for discussion rather than a PR. Happy to submit a PR myself — for the README title/disambiguation note if that's the preferred lighter-weight fix, or to help coordinate the rename if maintainers are open to it.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗