Claude Code 使用教程

一、什么是Claude Code

Claude Code是Anthropic官方推出的终端AI编程工具：

在终端中与Claude对话编程
深度理解你的代码库上下文
自主执行文件操作、运行命令
Agent模式完成复杂任务
SWE-bench Verified排名第一（80.9%）

二、安装配置

环境要求

Node.js 18+
macOS / Linux / Windows (WSL)

安装步骤

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

# 设置API Key
export ANTHROPIC_API_KEY="your-api-key"

# 验证安装
claude --version

获取API Key

访问 console.anthropic.com
注册/登录账号
创建API Key

三、基础使用

启动Claude Code

cd your-project
claude

常用斜杠命令

命令	功能
/help	查看帮助
/clear	清空对话
/compact	压缩上下文（省Token）
/cost	查看Token消耗
/config	配置设置
/bug	报告问题
/doctor	诊断问题

基础对话示例

> 帮我看看src/index.ts有什么问题

> 创建一个UserProfile React组件

> 运行测试并修复失败的用例

> 解释这段代码的作用

四、Agent模式

Claude Code的强大之处在于其Agent能力，可以自主完成复杂任务：

示例任务

> 把项目从JavaScript迁移到TypeScript

Claude会自动：

分析项目结构
安装TypeScript依赖
创建tsconfig.json
逐个转换文件
修复类型错误
运行验证测试

复杂任务示例

> 实现用户认证系统，包括：
> - 注册、登录、登出
> - JWT Token管理
> - 密码加密
> - 中间件保护路由

五、CLAUDE.md 项目配置

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

# 项目说明

## 技术栈
- 框架：Next.js 15 (App Router)
- 数据库：PostgreSQL + Prisma
- 认证：NextAuth.js
- 样式：Tailwind CSS

## 代码规范
- 使用TypeScript严格模式
- 组件使用函数式写法
- 使用pnpm作为包管理器

## 目录结构
- src/app/ - 页面路由
- src/components/ - React组件
- src/lib/ - 工具函数
- prisma/ - 数据库模型

## 常用命令
- pnpm dev - 启动开发服务器
- pnpm test - 运行测试
- pnpm lint - 代码检查

六、自定义命令

创建项目命令

在 .claude/commands/ 目录创建命令文件：

<!-- .claude/commands/fix-issue.md -->
请修复GitHub Issue #$ARGUMENTS

步骤：
1. 分析Issue描述
2. 定位相关代码
3. 编写修复代码
4. 运行测试验证
5. 创建提交信息

使用：

> /project:fix-issue 1234

七、MCP集成

Claude Code支持Model Context Protocol (MCP)，可以扩展功能：

// .claude/mcp.json
{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["@anthropic/mcp-server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["@anthropic/mcp-server-postgres"]
    }
  }
}

八、IDE集成

Claude Code支持在IDE中使用：

VS Code

# 安装VS Code扩展
code --install-extension anthropic.claude-code

JetBrains IDEs

在插件市场搜索 "Claude Code" 安装

Cursor / Windsurf

原生支持，无需额外配置

九、成本控制

定价

模型	输入价格	输出价格
Claude Opus 4.5	$15/1M	$75/1M
Claude Sonnet 4.5	$3/1M	$15/1M

省钱技巧

使用/compact命令：定期压缩上下文

> /compact

选择合适模型：简单任务用Sonnet
精确提问：减少来回对话
使用CLAUDE.md：减少重复解释项目背景

十、最佳实践

1. 清晰描述需求

❌ 修bug
✅ 修复src/api/users.ts中的getUserById函数，
   当用户不存在时应返回404而不是500错误

2. 分步骤执行复杂任务

> 第一步：先分析现有的认证逻辑
> 第二步：设计新的认证流程
> 第三步：实现代码

3. 善用上下文

> 基于刚才的讨论，请实现方案B

4. 及时反馈

> 这个实现有问题，请求应该是POST而不是GET

十一、故障排除

常见问题

Q: 命令执行失败

claude --doctor  # 诊断问题

Q: Token消耗太快

> /compact  # 压缩上下文

Q: Claude不理解项目

确保创建了CLAUDE.md文件
使用@file引用关键文件

获取帮助

使用 /bug 命令报告问题
访问 GitHub Issues
加入 Claude Developers Discord