Claude Code

Anthropic 官方终端 AI 编程助手 —— 让 Claude 在你的终端里写代码、改文件、跑命令

阅读前自检：这篇教程适合你吗？

如果你符合以下任意一条，这篇教程就是为你准备的：

  • 你在用终端开发，想借助 AI 加速编码效率
  • 你听说过 Claude Code 但不知道怎么上手
  • 你想了解 Claude Code 和 Copilot/Cursor 的差异
  • 你需要一份完整的中文命令参考手册

价格： ¥9.9 买断制，一次购买永久查阅。

目录

第一章 认识 Claude Code
Anthropic 出品 · 终端原生 · 代码库感知 · MCP 协议
第二章 快速上手（5分钟）
安装 → 配置 → 运行第一条指令
第三章 安装指南（全平台）
macOS · Linux · Windows 三平台完整安装
第四章 配置详解
API Key · 权限模式 · CLAUDE.md · 团队配置
第五章 日常使用
交互模式 · 单次执行 · 管道模式 · 会话管理
第六章 实战场景（核心价值）
代码审查 · 重构 · Git 操作 · 调试 · PR 生成
第七章 高级功能
MCP 服务器 · 自定义斜杠命令 · IDE 集成
第八章 进阶技巧
Prompt 工程 · 权限优化 · CI/CD · GitHub Actions
第九章 常见问题与排错
安装 · 配置 · 网络 · 权限 · 性能
附录：命令速查表
全部 CLI 命令 + 快捷键一览

第一章 认识 Claude Code

1.1 什么是 Claude Code

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手。它直接运行在你的终端里，能理解整个代码库的上下文，帮助你快速完成编码任务——从写代码、改文件、运行命令到处理 Git 工作流，全部通过自然语言指令完成。

核心特性：

  • 代码库感知： 自动索引你的项目，理解文件结构和依赖关系
  • 终端原生： 不离开终端就能完成所有操作，支持管道输入和输出
  • 安全可控： 三级权限系统（Plan/Accept/Full），每次修改都需确认
  • MCP 协议： 原生支持 Model Context Protocol，可外接任意工具和数据源
  • Claude 模型专属： 基于 Anthropic API，享受 Claude 系列最强的编码能力

1.2 谁需要它

Claude Code 特别适合：

  • 全栈开发者——快速写功能、修 bug、重构代码
  • DevOps 工程师——脚本编写、CI/CD 配置、日志分析
  • 开源贡献者——从 GitHub Issue 直接生成 PR
  • 技术负责人——代码审查、架构建议、团队规范检查

1.3 对比其他终端 AI 工具

特性Claude CodeGitHub CopilotCursor
运行环境终端原生IDE 插件独立编辑器
代码库感知自动全量索引当前文件+上下文项目索引
权限模型3 级（Plan/Accept/Full）直接插入直接修改
Git 集成PR 生成/提交/分支管理无基础
MCP 扩展原生支持不支持不支持
定价API 按量计费$10-39/月$20-40/月

1.4 系统要求

  • 操作系统： macOS、Linux、Windows（WSL2 推荐）
  • Node.js： 18+（推荐 20+）
  • Anthropic API Key： 需要有效的 API 密钥
  • 网络： 需要访问 api.anthropic.com

第二章 快速上手（5分钟）

2.1 安装 Claude Code

npm install -g @anthropic-ai/claude-code
claude --version

2.2 配置 API Key

export ANTHROPIC_API_KEY="sk-ant-api03-你的key"

💡 建议把 API Key 写入 ~/.bashrc 或 ~/.zshrc，避免每次重复设置。

2.3 第一次运行

claude

进入交互模式后，你会看到一个终端内的对话界面。试试输入：

帮我创建一个 Python 项目，包含一个 hello world 脚本

2.4 设置权限模式

Claude Code 有三种权限模式，首次使用的用户建议从 Plan 模式开始：

  • Plan 模式： 仅分析和建议，不修改任何文件
  • Accept 模式： 每次修改需手动确认
  • Full 模式： 完全自动执行（仅限受信任环境）

第三章 安装指南（全平台）

3.1 环境准备

node --version

必须 Node.js 18+。如版本不足：

3.2 macOS 安装

brew install node
npm install -g @anthropic-ai/claude-code

3.3 Linux 安装

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

3.4 Windows 安装

推荐使用 WSL2：

wsl --install -d Ubuntu

然后在 WSL 中按 Linux 流程安装。

如果必须使用原生 Windows：

winget install OpenJS.NodeJS.LTS
npm install -g @anthropic-ai/claude-code

3.5 验证安装

claude --version
claude --help

第四章 配置详解

4.1 API Key 深入

API Key 可通过三种方式设置：

export ANTHROPIC_API_KEY="sk-ant-api03-..."

写入配置文件 ~/.claude.json：

{"apiKey": "sk-ant-api03-..."}

4.2 CLAUDE.md 项目配置

在项目根目录创建 CLAUDE.md 文件，写入项目专属指令。Claude Code 启动后自动读取：

# CLAUDE.md
本项目使用 TypeScript + React
代码风格：使用 Prettier 默认配置
包管理器：pnpm
测试框架：vitest

4.3 权限模式配置

claude --permission-mode plan
claude --permission-mode accept

在会话中切换权限：

/permission accept

4.4 模型选择

claude --model claude-sonnet-4-20250514

4.5 国内网络配置

export HTTPS_PROXY="http://127.0.0.1:7890"

第五章 日常使用

5.1 交互模式

cd ~/my-project
claude

进入后直接输入自然语言指令。

5.2 单次执行

claude -p "解释这个项目的目录结构"

5.3 管道模式

cat error.log | claude -p "分析这些错误日志，给出修复建议"
git diff HEAD~5 | claude -p "总结最近5次提交的变更"

5.4 会话管理

claude --resume
claude --continue

常用斜杠命令：

  • /clear - 清除当前会话上下文
  • /compact - 压缩长对话以节省 token
  • /cost - 查看当前会话的 API 费用

第六章 实战场景（付费核心价值）

场景 1：代码审查

git diff main...feature-branch | claude -p "Review 这些改动，找出潜在 bug 和改进建议"

场景 2：重构

claude -p "把 src/utils/ 目录下的所有 JavaScript 文件重构为 TypeScript"

场景 3：Git 操作自动化

claude -p "创建一个新的 feature 分支，添加用户登录模块，提交并推送到远端"

场景 4：调试

npm test 2>&1 | claude -p "这些测试失败了，帮我逐个分析原因并修复"

场景 5：PR 自动生成

claude -p "查看当前分支相对 main 的所有改动，生成一个完整的 PR 描述"

场景 6：批量文件处理

claude -p "在 src/ 下所有 .tsx 文件里，把 console.log 替换为 logger.debug"

第七章 高级功能

7.1 MCP 协议

Claude Code 原生支持 Model Context Protocol，可接入外部工具和数据源。安装 MCP 服务器：

claude mcp add github-server npx -y @anthropic/mcp-server-github

然后在会话中直接操作 GitHub：

帮我列出我的所有仓库，并给 open-issues 最多的那个创建新 issue

7.2 IDE 集成

Claude Code 支持作为 VS Code 和 JetBrains 的终端集成。在 VS Code 中可以直接用内置终端运行 Claude Code。

7.3 自定义斜杠命令

在 CLAUDE.md 中定义：

## Commands
/format: 对所有修改过的文件运行 prettier
/test: 运行完整测试套件并报告结果
/deploy: 构建并推送到 staging 环境

第八章 进阶技巧（新手不知道的）

8.1 Prompt 工程

  • 给具体约束： "用 TypeScript 写，不要 any 类型，要有完整的测试"
  • 指定文件范围： "只看 src/api/ 目录下的文件"
  • 给出示例输出： "按照这个格式输出结果..."

8.2 成本控制

  • 小任务用 claude -p 单次执行，而非交互模式
  • 长对话中用 /compact 压缩上下文
  • 优先用 claude-sonnet（够用且比 claude-opus 便宜 5x）

8.3 CI/CD 集成

claude -p "Review 本次 PR 的代码变更" --output-format json > review.json

8.4 GitHub Actions 集成

- name: Claude Code Review
  run: |
    git diff origin/main | claude -p "Review these changes" --permission-mode plan

第九章 常见问题与排错

9.1 安装问题

npm install -g @anthropic-ai/claude-code --unsafe-perm

权限不足时使用：

npm install -g @anthropic-ai/claude-code --prefix ~/.local

9.2 API 问题

echo $ANTHROPIC_API_KEY

确认环境变量已设置。如果仍然报 401：

  • 检查 Key 是否有效（在 Anthropic Console 确认）
  • 检查是否有网络代理
  • 确认 Key 格式正确（以 sk-ant-api03- 开头）

9.3 网络问题

curl -s -o /dev/null -w "%{http_code}" https://api.anthropic.com/v1/messages

如果返回非 200，检查代理或网络连通性。

9.4 性能问题

  • 响应慢：考虑换用更快模型（claude-haiku）
  • 索引慢：清理 ~/.claude/cache/
  • 内存占用高：减少同时打开的文件数

附录：命令速查表

# 安装
npm install -g @anthropic-ai/claude-code

# 启动
claude                              # 交互模式
claude -p "指令"                    # 单次执行
claude --resume                     # 恢复上次会话
claude --version                    # 版本号

# 权限
claude --permission-mode plan       # 仅分析
claude --permission-mode accept     # 需确认
claude --permission-mode full       # 完全自动

# 模型
claude --model claude-sonnet-4-20250514

# 会话内斜杠命令
/clear                              # 清除上下文
/compact                            # 压缩对话
/cost                               # 查看费用
/permission                         # 切换权限
/help                               # 帮助

# MCP
claude mcp add      # 添加MCP服务器
claude mcp list                     # 列出MCP服务器
claude mcp remove             # 移除MCP服务器

# 环境变量
ANTHROPIC_API_KEY="sk-ant-api03-..."

本教程由 老K学长 整理制作 · ¥9.9 买断制 · 一次购买永久查阅

闲鱼 / 小红书 / B站 / 知乎 搜索「老K学长」

返回首页