Claude Code 完全使用教程

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，可以直接在终端中与 Claude 对话，完成代码编写、调试、重构等开发任务。本文从安装到实战，带你全面掌握 Claude Code。

安装 Claude Code

前置要求

• Node.js 18+ 环境
• npm 或其他包管理器
• 终端（macOS Terminal、Windows PowerShell、Linux Shell）

安装命令

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

配置 API 凭证

方式一：环境变量（推荐）

# 直接使用官方 Key
export ANTHROPIC_API_KEY="sk-ant-xxxx"

# 或使用中转站 Key
export ANTHROPIC_AUTH_TOKEN="your-relay-key"
export ANTHROPIC_BASE_URL="https://claude4u.com/antigravity"

方式二：settings.json

# 创建 ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-relay-key",
    "ANTHROPIC_BASE_URL": "https://claude4u.com/antigravity"
  }
}

第一次使用

进入你的项目目录，直接运行 claude：

cd ~/my-project
claude

Claude Code 会自动识别项目结构，你可以直接用自然语言描述需求：

• "帮我写一个用户注册的 API 接口"
• "修复这个函数的 bug，它在输入为空时会崩溃"
• "把这段代码重构成 TypeScript"
• "给这个模块添加单元测试"

常用命令与操作

基本命令

# 启动交互式会话
claude

# 直接执行单次任务
claude -p "解释这个函数的作用" < my-file.js

# 继续上一次的会话
claude --continue

# 从上次会话恢复（选择历史会话）
claude --resume

会话内命令

/help          # 查看帮助
/clear         # 清除当前对话上下文
/compact       # 压缩上下文，释放 Token 空间
/cost          # 查看当前会话的 Token 用量和费用
/model         # 切换模型（如切换到 Opus）
/config        # 查看和修改配置

VS Code 集成

Claude Code 可以直接在 VS Code 的终端中使用：

1. 打开 VS Code 的集成终端（Ctrl+`）
2. 确保环境变量已配置
3. 运行 claude 启动

Claude Code 能感知 VS Code 当前打开的文件和项目结构，提供更精准的代码建议。

项目工作流最佳实践

1. 使用 CLAUDE.md

在项目根目录创建 CLAUDE.md 文件，告诉 Claude Code 项目的背景信息：

# CLAUDE.md
## 项目简介
这是一个 React + TypeScript 的电商前端项目。

## 技术栈
- React 18 + TypeScript
- Zustand 状态管理
- Tailwind CSS
- Vite 构建

## 代码规范
- 使用函数组件和 Hooks
- 组件文件放在 src/components/
- 接口类型定义放在 src/types/

2. 分步骤完成复杂任务

把大任务拆解为小步骤，每一步让 Claude Code 完成后再进行下一步：

1. 先让它分析需求和设计方案
2. 确认方案后再开始编码
3. 编码完成后让它补充测试
4. 最后做代码审查和优化

3. 活用 /compact 管理上下文

当对话变长后，使用 /compact 命令压缩上下文，避免 Token 消耗过多，同时保持关键信息不丢失。