# Claude Code

Canonical: https://cqbase.net/zh/entry/claude-code
Chinese: https://cqbase.net/zh/entry/claude-code
English: https://cqbase.net/en/entry/claude-code

> Anthropic 的终端编码代理，能在仓库里读代码、改文件和跑命令。

Claude Code 是 Anthropic 的终端编码工具，仓库在 anthropics/claude-code，文档在 code.claude.com。它不是一个只回答问题的聊天窗口：它在你的项目目录里工作，可以读代码、编辑和执行常规命令。仓库没有检出 SPDX 许可证。

第一次使用时选一个可以丢弃的分支，看它在改文件之前会不会说明计划。把允许的命令范围写小，尤其是会推远程或动生产配置的命令。

## 解决什么问题

Claude Code 是 Anthropic 的编码代理，跑在你的终端里（也有桌面应用、VS Code / JetBrains 扩展，以及网页端）。它能读当前仓库、改文件、执行命令，并用自然语言处理日常开发任务，例如查代码结构、改一小段逻辑，或处理 Git 操作。官方把它定位成「先看项目、再动手」的代理，而不是只在聊天里给建议。本文只写入门：安装、登录和付费、`CLAUDE.md`、技能与插件、以及 MCP。功能清单见官方文档。

## 适合谁

适合能在终端打开项目、并希望代理直接在仓库里干活的人。你需要 Claude Pro、Max、Ultra、Team、Enterprise，或 Claude Console（按量预付）；也可由组织通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 接入。官方定价页写明：Free 不包含 Claude Code。

Anthropic 的 [Supported Regions Policy](https://www.anthropic.com/legal/supported-regions)（自 2026-11-12 起生效）写明，Claude Code 等产品只在列出的国家和地区提供。名单中有台湾，没有中国大陆、香港和澳门。未列出即不支持，也包括人在不支持地区使用，以及在不支持地区注册、总部或受其控制的实体使用。政策如有调整，以官网为准。本文不讨论如何绕过该政策。

## 怎么装

核验日期为 2026-11-15（Asia/Shanghai），命令来自官方安装与快速入门文档。官方推荐原生安装（会在后台自动更新）。macOS、Linux 或 WSL：

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

Windows PowerShell：

```powershell
irm https://claude.ai/install.ps1 | iex
```

Windows CMD：

```batch
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

也可用 Homebrew（`brew install --cask claude-code`）或 WinGet（`winget install Anthropic.ClaudeCode`），这两条路径不会自动更新。README 写明 npm 全局安装 `@anthropic-ai/claude-code` 已弃用。装完请新开终端，运行 `claude --version`，应打印版本号。若找不到命令，多半是安装目录还没进 PATH，见官方排障页。

在项目目录启动：

```bash
cd /path/to/your/project
claude
```

第一次启动会打开浏览器登录。可用 claude.ai 的订阅账号，或 Console 账号。若已设置 `ANTHROPIC_API_KEY` 并在询问时确认使用，会跳过登录提示。之后凭据会保存在本机，不必每次登录。要换账号，可在会话里执行 `/login` 或 `/logout`。

付费以 [claude.com/pricing](https://claude.com/pricing) 为准（不含税，如有变动以官网为准）。2026-11-15 该页写明：Pro 月付 20 美元，年付折算约 17 美元/月（先付 200 美元）；Max 100 美元；Ultra 200 美元。也可用 Console 预付额度。会话里可用 `/usage` 查看用量。本文不另估账单。

### CLAUDE.md、技能、插件与 MCP

`CLAUDE.md` 是你会反复交代的约定，每次会话开始时加载。个人偏好放 `~/.claude/CLAUDE.md`；要共享则把 `./CLAUDE.md` 或 `./.claude/CLAUDE.md` 提交进仓库；仅本机说明用 `./CLAUDE.local.md`，并加入 `.gitignore`。只在特定任务才需要的步骤，更适合写成技能。

技能是带 `SKILL.md` 的文件夹。个人技能放 `~/.claude/skills/<名称>/SKILL.md`，项目技能放 `.claude/skills/`。Claude 可按描述自动选用，也可以用 `/技能名` 直接调用。

插件把技能、钩子、子代理和 MCP 打成可安装包。可在会话里用 `/plugin` 浏览市场。官方插件在 [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official)。

MCP 用来接入仓库之外的工具。在终端（不是在会话里）添加一个远程示例：

```bash
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
```

然后用 `claude mcp list` 查看是否显示已连接。用户级配置可加 `--scope user`。会话里可用 `/mcp` 检查或完成需要浏览器的登录。

## 一个实际例子

下面的提示词来自官方 Quickstart。本次没有在本机实际跑，因此不编造它读到的文件或写出的代码。

1. 在你自己的仓库目录运行 `claude`，并完成登录。
2. 先发送：`what does this project do?` 按官方说明，它会按需读取项目文件并给出摘要，你不必事先手工贴代码。
3. 若只是想确认它能改文件，可用官方的小任务：`add a hello world function to the main file`。它应找出合适的文件并给出改动；若询问是否允许，需要你确认。可用 `Shift+Tab` 切换权限模式。
4. 重要改动请自己看 diff，再用你平时的测试和 Git 流程处理，不要把一次回答当成已经合并的结果。

## 常见坑

- 安装后提示找不到 `claude`：官方排障页把原因指向 PATH。装完要新开终端，必要时把安装目录加入 PATH。[issue #471](https://github.com/anthropics/claude-code/issues/471) 也报告过终端崩溃后再开出现 `command not found`。若你用的是已弃用的 npm 安装，[issue #3172](https://github.com/anthropics/claude-code/issues/3172) 还提到在 macOS + Homebrew 下符号链接出错。
- 安装脚本失败：若出现 `syntax error near unexpected token '<'`、CMD 里的 `< was unexpected`，或 `403`，官方说明常常是脚本返回了 HTML 或下载被拒绝。请对照 [Troubleshoot installation](https://code.claude.com/docs/en/troubleshoot-install)。另外不要在 PowerShell 里跑 CMD 命令，反之亦然。
- 登录或 403：先确认账号属于支持 Claude Code 的套餐，并且所在地区与主体符合官方支持地区政策。浏览器没有自动打开时，可按提示复制登录 URL。[issue #8007](https://github.com/anthropics/claude-code/issues/8007) 曾报告 OAuth 返回 403，该 issue 已关闭，请以当前排障页为准。
- 配置好像没生效：`CLAUDE.md`、MCP 和技能多在会话开始时读取。改完后先退出再开一次；可用 `/mcp`、`claude doctor` 或官方的 Debug 文档排查。

## FAQ

### 免费版能用 Claude Code 吗？

不能。官方快速入门和定价页都写明，Free 不包含 Claude Code。需要 Pro、Max、Ultra、Team、Enterprise，或 Console，或组织提供的云厂商接入。

### 在中国大陆能用吗？

官方支持地区名单（2026-11-12 起生效）未列出中国大陆、香港和澳门，并写明未列出的地区不在支持范围。是否允许使用以 Anthropic 当前政策为准，不要依赖非正式途径。

### CLAUDE.md 和技能有什么差别？

`CLAUDE.md` 会在每次会话开始时作为长期说明加载，适合构建命令、目录约定和「始终要遵守」的规则。技能是按需加载的流程说明，适合你反复粘贴的步骤。官方建议：`CLAUDE.md` 里某一段已经长成一套手续时，就改写成技能。

### 一定要用插件才能接 MCP 吗？

不必。插件只是打包方式。你可以直接用 `claude mcp add` 添加服务器，再用 `claude mcp list` 或 `/mcp` 检查。

### 还可以用 npm 安装吗？

官方 README 写明 npm 安装已弃用，请改用原生安装、Homebrew 或 WinGet。若你仍看到旧教程里的 `npm install -g @anthropic-ai/claude-code`，不要再把它当成推荐做法。

## 来源与许可

仓库 [anthropics/claude-code](https://github.com/anthropics/claude-code) 主要是问题追踪和说明，安装与行为以 [code.claude.com/docs](https://code.claude.com/docs/en/overview) 为准。本文依据 2026-11-15 查阅的 Quickstart、Setup、Authentication、Memory、MCP、排障、定价页和支持地区政策，用自己的话写成，供 CQBase 上下文库使用。若命令或价格有变，以官网为准。

## 收录信息

- 作者: anthropics
- 许可证: 未知
- 来源: https://github.com/anthropics/claude-code
- 收录: 2026-11-15
- GitHub 星标: 155730（采集 2026-11-15）

