cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

工作流

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(自 2026-11-12 起生效)写明,Claude Code 等产品只在列出的国家和地区提供。名单中有台湾,没有中国大陆、香港和澳门。未列出即不支持,也包括人在不支持地区使用,以及在不支持地区注册、总部或受其控制的实体使用。政策如有调整,以官网为准。本文不讨论如何绕过该政策。

怎么装

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

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

Windows PowerShell:

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

Windows CMD:

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,见官方排障页。

在项目目录启动:

cd /path/to/your/project
claude

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

付费以 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。

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

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 也报告过终端崩溃后再开出现 command not found。若你用的是已弃用的 npm 安装,issue #3172 还提到在 macOS + Homebrew 下符号链接出错。
  • 安装脚本失败:若出现 syntax error near unexpected token '<'、CMD 里的 < was unexpected,或 403,官方说明常常是脚本返回了 HTML 或下载被拒绝。请对照 Troubleshoot installation。另外不要在 PowerShell 里跑 CMD 命令,反之亦然。
  • 登录或 403:先确认账号属于支持 Claude Code 的套餐,并且所在地区与主体符合官方支持地区政策。浏览器没有自动打开时,可按提示复制登录 URL。issue #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 主要是问题追踪和说明,安装与行为以 code.claude.com/docs 为准。本文依据 2026-11-15 查阅的 Quickstart、Setup、Authentication、Memory、MCP、排障、定价页和支持地区政策,用自己的话写成,供 CQBase 上下文库使用。若命令或价格有变,以官网为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。