工作流
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 | bashWindows PowerShell:
irm https://claude.ai/install.ps1 | iexWindows 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。本次没有在本机实际跑,因此不编造它读到的文件或写出的代码。
- 在你自己的仓库目录运行
claude,并完成登录。 - 先发送:
what does this project do?按官方说明,它会按需读取项目文件并给出摘要,你不必事先手工贴代码。 - 若只是想确认它能改文件,可用官方的小任务:
add a hello world function to the main file。它应找出合适的文件并给出改动;若询问是否允许,需要你确认。可用Shift+Tab切换权限模式。 - 重要改动请自己看 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 上下文库使用。若命令或价格有变,以官网为准。