[DOCS] Repository name and README title don't distinguish Claude Code CLI from broader Claude Code branding (suggest renaming to claude-code-cli)

Status Fixed / completed
Maintainer reply None cached
Activity 1 comment · opened Aug 6, 2026 · closed Aug 16, 2026

Summary

While following a tutorial on Claude Code, I was directed to install "Claude Code" in two different contexts:

  1. A desktop app with a graphical chat interface
  2. 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

  1. Repository name: Rename claude-code to claude-code-cli to precisely reflect its scope.
  2. 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:

  1. Installing the Claude Code desktop app (GUI chat interface)
  2. 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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗