Claude Code 教程

什么是 Claude Code？

Claude Code 是 Anthropic 推出的现代开发者 AI 编程助手，通过集成 AI 能力，可大幅提升开发效率。它直接在终端中运行，能够理解你的整个代码库，通过自然语言命令帮助你更快地编码。

智能代码理解

深度理解项目结构、依赖关系和代码逻辑

自然语言交互

用中文或英文描述需求，AI 自动生成代码

终端原生体验

无需离开终端，直接在命令行中完成所有操作

多文件编辑

一次对话中可同时修改多个文件，保持一致性

效率对比

支持环境与系统要求

支持平台

• macOS 12+（推荐）

• Ubuntu 20.04+ / Debian 11+

• Windows（需额外安装 Git for Windows）

系统要求

• Node.js 18.0 或更高版本

• npm 或 yarn 包管理器

• Windows 用户需安装 Git for Windows

• 4GB+ 可用内存

• 稳定的网络连接

安装步骤

1. 安装 Node.js

如果尚未安装 Node.js，推荐使用 nvm 进行版本管理：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 安装 Node.js LTS
nvm install --lts
nvm use --lts

# 验证安装
node --version  # 应显示 v18+ 或 v20+

⚠ Windows 用户注意

Windows 系统还需要额外安装 Git for Windows，否则 Claude Code 可能无法正常运行。安装时保持默认选项即可。

2. 安装 Claude Code CLI（必须）

这是后续所有配置的前提，必须先在本地安装好 Claude Code CLI 工具：

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

验证安装

运行 claude --version 确认安装成功。

API 配置（关键步骤）

1. 获取令牌

前往 SpritNest 控制台获取您的 API Key。注册即送免费额度。

2. 配置环境变量

编辑配置文件 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://aifusion.network/",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "alwaysThinkingEnabled": false
}

提示

也可以通过环境变量配置：export ANTHROPIC_BASE_URL=https://aifusion.network/和 export ANTHROPIC_AUTH_TOKEN="sk-xxx"

3. 配置 .claude.json

编辑或新增 ~/.claude.json 文件（Windows 为 用户目录/.claude.json），添加以下内容跳过首次引导流程：

{
  "hasCompletedOnboarding": true
}

为什么需要这一步？

配置此参数后，Claude Code 启动时会跳过官方的 onboarding 引导流程，直接进入使用状态，避免因网络限制导致卡在引导页面。

基本使用方法

1. 启动 Claude Code

# 在项目目录中启动
cd your-project
claude

2. 首次启动设置

首次启动时，Claude Code 会自动扫描项目结构。你可以直接用自然语言描述需求：

# 示例对话
> 帮我分析这个项目的架构
> 给 UserService 添加一个分页查询方法
> 修复 login 接口的参数校验问题
> 写一个单元测试覆盖 utils/format.ts

3. 基础操作示例

# 让 Claude 解释代码
> 解释一下 src/auth/middleware.ts 的逻辑

# 让 Claude 重构代码
> 把这个 class 组件重构为 hooks

# 让 Claude 生成代码
> 创建一个 REST API 的 CRUD 模板

常用命令参考

交互模式常用命令

压缩上下文

当对话过长导致 token 接近上限时，使用 /compact 命令压缩上下文：

/compact [instructions]  # 可以添加说明，告诉 Claude 保留哪些重要信息

恢复以前的对话

使用 /resume 或在启动时加 --resume 参数恢复之前的对话：

claude --resume        # 启动时恢复上次对话
claude --resume <id>   # 恢复指定 ID 的对话

处理图像信息

Claude Code 支持在对话中传入图片进行分析，可以直接拖拽图片到终端或使用路径引用。

MCP (上下文通用协议)

MCP（Model Context Protocol）允许 Claude Code 连接外部工具和服务。只需在项目根目录创建 .mcp.json 文件即可配置。

MCP 的最佳实践

将 MCP 配置放在项目根目录的 .mcp.json 中，团队成员可以共享相同的工具配置。

MCP 配置示例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

高级技巧

项目记忆文件 (CLAUDE.md)

在项目根目录创建 CLAUDE.md 文件，Claude 会在每次启动时自动读取，用于了解项目上下文：

# 项目架构
- 前端：React + TypeScript + Tailwind
- 后端：Node.js + Express + Prisma
- 数据库：PostgreSQL

# 编码标准
- 使用 ESLint + Prettier
- 组件使用函数式写法 + Hooks
- API 响应统一使用 { code, data, message } 格式

# 注意事项
- 不要修改 migrations 目录下的文件
- 环境变量在 .env.example 中有模板

IDE 集成

Claude Code 可以与主流 IDE 配合使用：

• VS Code：在内置终端中直接运行 claude

• Cursor：可同时使用 Cursor AI 和 Claude Code

• JetBrains：在 Terminal 面板中启动

VS Code 插件：Claude Code for VS Code

除了在终端中使用，你还可以在 VS Code 中安装官方的 Claude Code for VS Code 插件，获得图形化的交互体验。

💡 前提条件

使用此插件前，必须先按照上方步骤在本地安装并配置好 Claude Code CLI（即完成 npm install -g @anthropic-ai/claude-code + 配置 settings.json 和 .claude.json）。插件会自动读取 CLI 的配置，无需在插件中重复配置 API Key。

**安装方式：**在 VS Code 扩展商店搜索 Claude Code（发布者为 Anthropic），点击安装即可。

使用说明：

• 安装后插件会自动检测本地的 Claude Code CLI 及其配置

• 如果 CLI 已正确配置好 API Key 和 Base URL，插件会直接可用，不会弹出登录页面

• 如果插件提示需要登录，说明本地 CLI 尚未安装或配置不完整，请先完成上方的安装配置步骤

使用心得 & 常见问题

最佳实践

1. 先让 Claude 分析项目结构，再提具体需求

2. 复杂任务拆分为小步骤，逐步完成

3. 善用 CLAUDE.md 提供项目上下文

4. 定期使用 /compact 压缩上下文，避免 token 溢出

5. 对生成的代码进行 review，不要盲目接受常见问题

Q: 连接超时怎么办？

检查 ~/.claude/settings.json 中的 API 地址和 Key 是否正确。如果使用环境变量，确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 已正确设置。

Q: 如何切换模型？

在对话中输入 /model 即可查看和切换可用模型。

Q: token 用完了怎么办？

使用 /compact 压缩上下文，或 /clear 清除对话重新开始。

参考链接

• Claude Code 官方文档

• Claude Code GitHub 仓库