anthropics/claude-code · 上手攻略

是什么

claude-code 是 Anthropic 官方出品的 agentic coding tool——一个常驻终端、读懂整个代码库的编程助手。它不是单纯的代码补全(LSP/IDE inline),而是一个能自主完成多文件修改、跑命令、做 git workflow 的 agent:

  • 多面入口:Terminal(CLI)、VS Code / Cursor 插件、JetBrains 插件、独立 Desktop App、网页 claude.ai/code、iOS/Android 移动端。
  • 以 MCP 为工具总线:Claude Code 内置 MCP 客户端,可以挂任意 MCP server(Google Drive、Jira、Slack、自研工具)。
  • 可定制三层:CLAUDE.md(项目级长记忆)、Skills(可复用工作流)、Hooks(工具调用前后强制动作)。
  • 可扩展:仓库 plugins/ 目录提供 12 个官方插件(代码评审、提交、特性开发、安全提示、Agent SDK 开发等),社区有 Plugin Marketplace。

一句话定位:Anthropic 的 "终端 agent 编程助手"——和 OpenAI 的 Codex CLI、Google 的 Gemini CLI、Cursor 的 Composer 同一赛道。

解决什么问题

  • 多文件跨层修改:写测试、改 API、实现 feature,跨十几个文件还能保持一致风格——单文件补全做不到。
  • 重复劳动自动化:写测试、修 lint、解 merge conflict、升依赖、写 release notes——这些"每天都要做一次"的事。
  • 代码理解:陌生 codebase 接手时,让 Claude 先读、再讲解、再改。
  • CI / 批处理:claude -p 走非交互模式,可被 shell / CI / cron 调用,适配流水线。
  • 多 agent 并行:background agents / sub-agents 可以让多个 Claude 会话同时干不同子任务。

快速安装

README 顶部明确提示:npm install -g @anthropic-ai/claude-code 已 deprecated。三种官方推荐方式:Native Install(脚本)、Homebrew Cask、WinGet。

最小可跑命令

# macOS / Linux / WSL(推荐)
curl -fsSL https://claude.ai/install.sh | bash

# macOS / Linux(备选,Homebrew)
brew install --cask claude-code

# 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

# Windows(备选,WinGet)
winget install Anthropic.ClaudeCode

# 验证:进任意项目目录,启动
cd your-project
claude

首次运行会引导登录 Claude 账号(订阅或 Console API key)。预先设置 ANTHROPIC_API_KEY 环境变量即可跳过登录提示。

Homebrew 两套 cask 的区别:

  • claude-code → stable 通道,落后约一周,会跳过大版本回归
  • claude-code@latest → latest 通道,新版本立刻推送

Native Install 自动后台更新;Homebrew / WinGet 不自动更新,需要手动 brew upgrade 或 winget upgrade。

硬件 / 依赖:零本地模型——纯网络客户端,所有推理走 Anthropic API。无 GPU 要求。需要 Node.js 18+(只是为了 deprecated 安装路径;推荐路径不需要)。

核心用法

1) 终端交互式

cd your-project
claude                              # 进入交互式 REPL
claude "write tests for the auth module, run them, and fix any failures"
claude "commit my changes with a descriptive message"

2) 非交互式 / 批处理(claude -p)

# 分析最近的日志
tail -200 app.log | claude -p "Slack me if you see any anomalies"

# CI 里自动翻译新文案
claude -p "translate new strings into French and raise a PR for review"

# 扫变更文件做安全 review
git diff main --name-only | claude -p "review these changed files for security issues"

适合塞进 GitHub Actions / GitLab CI,做自动化 PR review / issue triage。

3) 项目记忆 CLAUDE.md

在项目根放 CLAUDE.md,Claude 每次新会话开头会读它。写代码风格、架构决策、review checklist;Claude 还会自动学习(auto memory)build 命令、调试经验,跨会话保留。

4) Skills(/skills)

skills 是 Anthropic 体系里的"可复用工作流包",在 Claude Code 里以 /skill-name 或自然语言提及触发。详见 anthropics/skills 仓库攻略。

5) Hooks

事件触发钩子(PreToolUse / PostToolUse / SessionStart / Stop 等),可强制跑格式化、安全扫描、自定义校验。

6) MCP 集成

挂任意 MCP server,Claude 即可调用外部工具。/mcp 命令管理 server;CLI 配置见 MCP quickstart。

7) 多 agent

  • Sub-agents:主 agent spawn 子 agent,各干一段,主 agent 汇总。
  • Background agents:同时跑多个独立 session,在"agent view"窗口观察。
  • Agent SDK:把 Claude Code 的工具 + 编排能力封装进自研产品(完全控制 orchestration、权限、工具白名单)。

8) 官方插件(本仓 plugins/)

12 个示例:

Plugin 干啥
feature-dev 7 阶段特性开发工作流(/feature-dev)
code-review 多 agent 并行 PR 评审,confidence 过滤假阳性
commit-commands /commit /commit-push-pr /clean_gone
pr-review-toolkit 6 个专业评审 agent(comments/tests/errors/types/code/simplify)
security-guidance PreToolUse hook,扫 9 类安全 pattern
frontend-design 自动避坑"通用 AI 美学"
plugin-dev 7 个专家 skill + AI 辅助创建 plugin
agent-sdk-dev Agent SDK 开发套件
hookify /hookify 系列:对话里写规则,自动生成 hook
ralph-wiggum 自治循环 hook,迭代直到完成
learning-output-style 交互学习模式,关键决策点让你写 5-10 行
claude-opus-4-5-migration Sonnet 4.x / Opus 4.1 → Opus 4.5 自动迁移

安装:/plugin marketplace add anthropics/skills 或 clone 本仓库后用 /plugin install <path>。

典型适用场景

  • 日常开发加速:写测试、改 bug、解冲突、升依赖——提一句"做掉它"。
  • 大 codebase 接手:让 Claude 先 explore + 解释,再做改动。
  • 自动化 PR / Issue 流水线:claude -p + CI,定时拉 issue → 分析 → 出草稿 PR。
  • 多 agent 团队协作:把复杂任务拆给 sub-agent 并行,主 agent 收尾。
  • 文档生成 / 翻译 / 安全审计:套 Skills 或 Plugin Marketplace 的一行命令。
  • 嵌入自研产品:Agent SDK 把 Claude Code 的能力做成 API / 后台服务。

坑与注意

  1. NPM 安装方式已 deprecated:README 顶部明确警告,新装请走 Native / Homebrew / WinGet。别再 npm i -g @anthropic-ai/claude-code。
  2. 需付费 Claude 订阅或 Anthropic Console key:Desktop App / 部分表面要 Pro / Max / Team / Enterprise 订阅;CLI + ANTHROPIC_API_KEY 可走按量付费。第三方 provider(Azure Bedrock / Vertex 等)需单独配置。
  3. 数据使用与隐私:README 提示"Claude Code collects feedback, including usage data, associated conversation data, and user feedback via /bug"。涉及敏感代码 / 客户数据前,先读 https://code.claude.com/docs/en/data-usage 与 Anthropic 商业条款。企业合规场景务必审 review policy。
  4. Git for Windows 推荐安装:Windows 原生环境若没装 Git for Windows,Claude Code 退而用 PowerShell 作为 shell tool——某些 Bash 习惯的 hook 行为会变。建议 WSL。
  5. /plugin marketplace add 是 Claude Code 内命令:不是 npm 子命令——第一次接触的人容易以为是包管理器。
  6. Hook 触发是事件级的,不是模型级的:Hook 在工具调用前后机械触发,跟模型决策无关。把它当成"git hook"来想,不是"prompt"。
  7. Sub-agent 与并发开销:开 background agent 越多,token 与上下文消耗按 agent 数放大;生产 CI 里要注意 rate limit 和成本。
  8. 基准数字缺失:Anthropic 没有公开"用 Claude Code 比手写快 X% / 准确率高 Y%"的对照 benchmark,只有 SWE-bench Verified 上的 80%+ 公开成绩——本文不杜撰。

与同类对比

工具 形态 优势面 License
Claude Code 终端 agentic CLI + 多面 IDE 长上下文/项目记忆/MCP/插件市场 Anthropic 商业条款
OpenAI Codex CLI 终端 agentic CLI GPT-5/Codex 模型,生态广 Apache 2.0
Google Gemini CLI 终端 agentic CLI 免费额度大,Gemini 模型 Apache 2.0
Cursor Composer IDE 内 agentic 桌面 IDE 体验最深 商业
GitHub Copilot Workspace 云端 agentic 仓库内协作 商业
Aider / Cline / Continue 开源 IDE/CLI 可本地化、可换模型 多为 MIT

差异化:Claude Code 在 MCP 生态绑定 + 多面入口(Terminal/IDE/Desktop/Web/移动) + Skills/Hooks/Plugin 三层定制 + Anthropic 模型长上下文与工具调用能力 上是最完整的;若你已在用 Anthropic 模型,且需要"agentic 而非补全"的体验,Claude Code 是首选之一。若是开源 / 自托管偏好,Aider/Cline/Continue 是合理替代。

一句话推荐结论

"Anthropic 出品的终端 agentic 编程助手,五面入口 + MCP + 三层定制"——Anthropic 模型用户强烈推荐;开源/本地化需求则看 Aider/Cline。

源链接 / 引用