🟠 Claude Code 安装与使用完整指南

Claude Code 是 Anthropic 官方推出的命令行 AI 编码工具，基于 Claude Sonnet 4.5 / Opus 4 等旗舰模型。与 ChatGPT 网页版不同，Claude Code 直接在终端运行——它能读取你当前目录的代码、编辑文件、运行命令、调用 Git，是把 AI Agent 真正"嵌入"开发工作流的产品。本指南覆盖三平台安装、登录认证、核心用法、Sub-agents、MCP 集成与生产级实践。

零、桌面版：Claude Desktop App

Claude 提供原生桌面应用（macOS / Windows），与 CLI 共享同一个账号体系，但有 GUI 优势——文件拖拽、图片识别、长会话管理、Artifacts 实时渲染。适合非终端用户、需要看视觉输出的场景。

0.1 下载与安装

# macOS Homebrew
brew install --cask claude

# 或官网下载 DMG
# https://claude.ai/download → 双击拖到 Applications

0.2 桌面版核心能力（vs CLI）

0.3 适用场景建议

• 用 CLI：写代码、改文件、跑测试、提交 PR
• 用 Desktop：看图、读 PDF、长对话管理、视觉化输出（图表/网页/UI 草图）
• 同时用：账号数据互通，Desktop 准备 prompt 草稿 → CLI 执行

0.4 Pro / Team / Enterprise 价格

💡 Desktop 独有杀手锏：Artifacts。让 Claude 写代码不只是给文字，而是实时渲染的 HTML/SVG/图表——你看到的是一个可交互的 demo，能立刻调整 prompt 让它改样式。这是 CLI 完全没有的能力。

一、安装：三平台完整步骤

1.1 macOS — 两种安装方式

方式 A：Homebrew（推荐）

brew install --cask claude-code
# 验证
claude --version
# → 2.1.126 (Claude Code)

方式 B：原生安装脚本

curl -fsSL https://claude.ai/install.sh | sh
# 默认安装到 ~/.local/bin/claude
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

1.2 Windows — PowerShell 一步到位

# 需先安装 Node.js 18+（https://nodejs.org）
npm install -g @anthropic-ai/claude-code
# 验证
claude --version
# 提示：Windows 11 建议用 WSL2（参看 OpenClaw Windows 指南）

1.3 Linux — Debian/Ubuntu 与 RHEL 双路径

# Debian/Ubuntu
curl -fsSL https://claude.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"

# RHEL/CentOS（需 npm）
sudo dnf install -y nodejs npm
npm install -g @anthropic-ai/claude-code

1.4 必装的 3 个前置依赖

💡 ripgrep 默认 macOS 自带，Linux 用 apt install ripgrep，Windows 用 winget install BurntSushi.ripgrep。

二、登录认证：3 种方式

2.1 Anthropic 官方账号（最常用）

claude login
# 浏览器跳转 → 登录 → 授权
# 成功后 ~/.claude/.credentials.json 存有 token

2.2 API Key（适合 CI/CD）

export ANTHROPIC_API_KEY="sk-ant-api03-..."
# 写入 ~/.zshrc 持久化
claude  # 自动使用环境变量

2.3 Bedrock / Vertex AI（企业内网）

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_PROJECT_ID=my-project
gcloud auth application-default login

三、核心用法：从「问一句」到「多 Agent 协作」

3.1 交互模式（最常用）

cd ~/projects/my-app
claude

# 进入 REPL 状态，提示符变成 ❯
# 输入任务：> 帮我重构 src/auth/ 模块，把所有 bcrypt 换成 argon2

# Slash 命令（输入 / 触发）
/help        # 查看所有命令
/clear       # 清空上下文
/compact     # 压缩历史（节省 token）
/cost        # 查看当前会话消耗
/agents      # 管理 sub-agents
/mcp         # 管理 MCP 服务器
/skills      # 加载/卸载 Skills
/vim         # 切换到 vim 编辑模式
/exit        # 退出

3.2 Headless 模式（管道/批处理）

# 单次任务
claude -p "解释这个 Python 脚本做什么" < script.py

# 输出 JSON 格式
claude -p "总结 README.md 的 3 个核心要点" --output-format json

# 流水线集成（git hook）
claude -p "检查这次 commit 的代码规范" --allowedTools "Bash(git diff*)"

3.3 续接上次会话

claude --continue          # 续接最近一次会话
claude --resume            # 选择历史会话
claude --session-id "abc"  # 指定 session ID 续接

四、Sub-agents：多 Agent 协作

Claude Code 的杀手锏是原生 Sub-agents 派发——你可以让一个 Agent 负责代码审查、另一个负责写测试、第三个负责生成文档，全部并行跑。

4.1 定义 Sub-agent

# 在项目根目录创建 .claude/agents/reviewer.md
---
name: code-reviewer
description: 严格的代码审查专家
tools: Read, Grep, Bash(git diff*)
---

你是一个严谨的代码审查者。检查：
1. 命名规范
2. 错误处理
3. 边界条件
4. 性能隐患
输出结构化 markdown 报告。

4.2 派发 Sub-agent

# 在主 REPL 里输入：
> 用 code-reviewer 审查 src/api/ 下的所有改动

# 多个 agent 并行：
> 派 3 个 agent：一个写测试、一个生成文档、一个做性能分析

五、MCP 集成：接外部工具

MCP（Model Context Protocol）是 Anthropic 推动的开放协议，让 Claude Code 能调用任何 MCP 兼容的服务器——GitHub、Postgres、Slack、Figma、Playwright 等。

5.1 添加 MCP 服务器

# 官方 GitHub MCP
claude mcp add --transport stdio github -- npx -y @modelcontextprotocol/server-github
# 配置环境变量
claude mcp env github GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx

# 列出已配置 MCP
claude mcp list

# 使用（自动在 REPL 里可用）
> 用 github MCP 列出我所有的 open PR，按更新时间排序

5.2 常用 MCP 速查

六、Skills：把团队 SOP 变成 AI 习惯

Skills 是可复用的指令包，把团队的代码规范、PR 模板、部署流程沉淀成 Markdown，Claude Code 会在相关场景自动加载。

# 项目级 Skills 放在 .claude/skills/
mkdir -p .claude/skills/code-style

# .claude/skills/code-style/SKILL.md
---
name: code-style
description: 强制 TypeScript strict 模式 + ESLint airbnb-base
---

所有 TypeScript 代码必须：
- tsconfig.json 开启 strict: true
- 使用 ESLint airbnb-base 配置
- 函数参数显式标注类型
- 不允许使用 any
- import 必须按字母顺序

在 REPL 里：/skills 列出所有可用，/skills load code-style 显式加载。

七、装完必做的 4 件事

八、常见工作流实战

8.1 场景一：从零搭项目

mkdir my-saas && cd my-saas
claude
> 用 Next.js 15 + Tailwind + Prisma + PostgreSQL 搭一个 SaaS 模板
> 用 postgres MCP 设计 user/subscription/invoice 三张表
> 写完整的 README.md 和 docker-compose.yml

8.2 场景二：Code Review

git checkout -b feature/auth
# 改完代码
git add .
claude -p "用 code-reviewer sub-agent 审查 staged 改动" --output-format json
# 收到结构化审查报告

8.3 场景三：批量迁移

claude
> 把整个 src/ 目录下所有 React class 组件改成 hooks 函数组件
> 用 playwright MCP 验证每个改完的页面没破

九、Claude Cowork：团队协作 AI 工作空间

如果说 Claude Code 是你"终端里的 AI 程序员"，Claude Desktop 是"桌面上的 AI 助理"，那 Claude Cowork 则是 2026 年 1 月 Anthropic 发布的团队协作 AI 工作空间——把 Claude 装进整个团队的工作流里。

9.1 四大核心能力（vs Claude Desktop）

9.2 工作空间架构（CSS 示意图）

9.3 四个真实使用场景

场景一：产品需求文档（PRD）协作

产品经理在 Cowork 创建 PRD 文档，AI Agent 自动生成初稿；研发 @Claude Code 评估技术可行性；设计师直接标注 UI 截图；最后一份 PRD 同步到 GitHub Issues。

# PRD：用户登录重构
@claude-code 评估这个方案需要几天？
@cowork-agent 找一下过去 3 个类似项目的工期数据
@cowork-summary 生成 1 页摘要给老板看

场景二：客户支持工单

客户提交工单 → Cowork Agent 自动分类（bug/咨询/投诉）→ @Claude 起草回复 → 人工 1 键确认发送 → 全程审计。

场景三：研究报告 / 周报

周日晚 8 点 Agent 定时拉取团队所有人的更新 → 自动汇总成周报 → 老板周一早 9 点看到的是 AI 整理好的 1 页纸。

场景四：团队知识库 + Skills 共享

把"我们公司的公众号写作 SOP"、"客户报价模板"、"代码 review checklist"做成团队 Skill，全员 1 句 @skill-name 就能调用。

9.4 Cowork × Claude Code 联动（开发团队最强组合）

1. 在 Cowork 项目里创建"技术方案"文档
2. 文档里 @claude-code 触发 Claude Code agent，agent 读取文档 → 写代码 → 提 PR
3. PR 链接自动回写到 Cowork 文档
4. 团队成员在 Cowork 里 review PR（看 diff、留言），不用切到 GitHub
5. 合并后 Cowork Agent 自动更新"项目进度看板"