Claude 使用指南

Claude 是 Anthropic 开发的 AI 助手，除了 Web 界面，还提供了 claudecode 命令行工具，让你在终端中直接使用 AI 辅助编程。

🌟 Claude 介绍

Claude 是一款强大的 AI 助手，具备：

• 强大的代码理解 - 支持多种编程语言
• 长上下文 - 最高支持 200K tokens
• 多模态 - 支持图片、文档分析
• 多版本 - Opus（最强）、Sonnet（平衡）、Haiku（快速）

版本对比

版本	特点	适用场景
Opus	最强大，最慢，最贵	复杂架构设计、代码重构
Sonnet	平衡性能和速度	日常编码、代码审查
Haiku	最快，最便宜	快速问答、简单任务

🌐 Web 界面使用

1. 访问 Claude

网址：https://claude.ai
需要：Anthropic 账号（免费注册）

2. 项目功能（Projects）

创建编程项目，上传代码文件：

1. 点击 "New Project"
2. 上传项目文件或文档
3. 开始对话

优势：

• 持久化项目上下文
• 支持多文件上传
• 长期记忆

3. Artifacts（代码生成）

Claude 会将生成的代码显示在右侧面板：

你：创建一个 React 组件，显示用户列表

Claude 会在右侧生成完整的代码，可以：
- 直接复制
- 继续修改
- 查看版本历史

4. 最佳实践

清晰的指令：

你：创建一个 Python 脚本，功能是：
1. 读取 CSV 文件
2. 数据清洗（去除空值）
3. 统计分析
4. 生成报告
使用 pandas 库

利用上下文：

你：这是我的项目结构：[上传文件]
帮我重构 user.py 模块，改用面向对象设计

🖥️ claudecode CLI 工具

什么是 claudecode？

claudecode 是 Claude 的命令行工具，让你在终端直接使用 AI 编程。

特点：

• ✅ 命令行直接对话
• ✅ 读取本地文件
• ✅ 执行代码生成
• ✅ 集成到工作流

安装 claudecode

# 使用 npm 安装
npm install -g claudecode

# 或使用 pip（如果支持）
pip install claudecode

# 验证安装
claudecode --version

配置 API Key

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

# 或者写入配置文件
claudecode config set-api-key your-api-key

# 获取 API Key：https://console.anthropic.com/

基础使用

1. 简单对话

# 直接提问
claudecode "解释 Python 的装饰器"

# 多行输入
claudecode "创建一个 Express 服务器，
包含用户认证和 CRUD API"

2. 读取文件

# 分析单个文件
claudecode "审查这个文件的代码质量" --file app.js

# 分析多个文件
claudecode "重构这些文件" \
  --file src/utils.js \
  --file src/helpers.js

# 读取目录
claudecode "分析这个项目的架构" --dir ./src

3. 生成文件

# 生成并保存到文件
claudecode "创建一个配置文件模板" \
  --output config.template.yml

# 生成多个文件
claudecode "创建 Express 项目结构" \
  --output-dir ./my-app

4. 管道操作

# 从标准输入读取
cat app.js | claudecode "添加错误处理"

# 输出到文件
claudecode "生成 README" > README.md

# 链式操作
echo "创建用户模型" | claudecode | tee models/user.js

高级用法

交互模式

# 启动交互式会话
claudecode --interactive

# 或简写
claudecode -i

# 在会话中使用命令：
> /file app.js          # 加载文件
> /dir ./src           # 加载目录
> 重构这些代码
> /save output.js      # 保存输出
> /exit               # 退出

指定模型

# 使用 Opus（最强）
claudecode "复杂的架构设计" --model opus

# 使用 Sonnet（平衡）
claudecode "日常编码任务" --model sonnet

# 使用 Haiku（快速）
claudecode "快速问答" --model haiku

项目上下文

# 创建项目配置
claudecode init

# 这会创建 .claudecode.json
{
  "model": "sonnet",
  "context": ["src/**/*.js", "docs/*.md"],
  "ignore": ["node_modules", "dist"]
}

# 使用项目上下文
claudecode "基于当前项目，添加登录功能"

实战示例

示例 1: 代码审查

# 审查代码并输出报告
claudecode "审查以下代码，找出：
1. 潜在 bug
2. 性能问题
3. 安全隐患
4. 改进建议" \
  --file app.js \
  --output review.md

示例 2: 批量重构

# 重构多个文件
claudecode "把这些文件改成 TypeScript" \
  --file src/**/*.js \
  --output-dir src-ts/

示例 3: 自动化文档

# 为所有函数生成文档
claudecode "为每个函数添加 JSDoc 注释" \
  --dir ./src \
  --output-dir ./src-documented

示例 4: 集成到 Git Hook

# .git/hooks/pre-commit
#!/bin/bash

# AI 审查提交的代码
git diff --cached --name-only | while read file; do
  claudecode "快速审查这个文件" --file "$file"
done

示例 5: 脚本生成

# 生成部署脚本
claudecode "创建一个 bash 脚本：
1. 拉取最新代码
2. 安装依赖
3. 运行测试
4. 构建项目
5. 重启服务" \
  --output deploy.sh

chmod +x deploy.sh

配置选项

创建 ~/.claudecode/config.json：

{
  "defaultModel": "sonnet",
  "apiKey": "your-api-key",
  "maxTokens": 4096,
  "temperature": 0.7,
  "outputFormat": "markdown",
  "autoSave": true,
  "contextFiles": [
    ".cursorrules",
    "README.md"
  ]
}

🎯 使用场景

Web 界面适合

• ✅ 复杂的对话交互
• ✅ 需要可视化代码预览
• ✅ 学习和探索
• ✅ 长期项目协作

CLI 适合

• ✅ 自动化工作流
• ✅ 批量处理文件
• ✅ 集成到脚本
• ✅ 命令行爱好者
• ✅ CI/CD 流程

🔧 高级技巧

1. 自定义 Prompt 模板

创建 ~/.claudecode/prompts/review.txt：

审查以下代码：
1. 代码质量评分（1-10）
2. 主要问题列表
3. 改进建议
4. 重构代码示例

---代码---
{content}

使用：

claudecode --template review --file app.js

2. 结合其他工具

# 结合 eslint
eslint app.js --format json | \
  claudecode "根据这些 lint 错误，修复代码"

# 结合 git
git diff | claudecode "生成提交信息"

# 结合 jq
claudecode "生成用户 API 响应示例" | jq

3. 创建别名

# 添加到 ~/.zshrc 或 ~/.bashrc
alias cr="claudecode --file"
alias cg="claudecode --output"
alias ci="claudecode --interactive"

# 使用
cr app.js "添加注释"

🆚 与其他工具对比

特性	Claude Web	claudecode	Cursor	Antigravity
命令行	❌	⭐⭐⭐⭐⭐	❌	❌
可视化	⭐⭐⭐⭐⭐	❌	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
自动化	❌	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐
上手难度	简单	中等	简单	简单

💡 详细对比请查看：工具对比分析

❓ 常见问题

Q1: claudecode 免费吗？

A:

• Web 界面: 有免费版（有限制）和 Pro 版（$20/月）
• CLI: 需要 API Key，按使用量付费

Q2: API 如何计费？

A:

• 按 token 计费
• Opus: ~$15/1M tokens
• Sonnet: ~$3/1M tokens
• Haiku: ~$0.25/1M tokens

Q3: 如何控制成本？

A:

# 使用较便宜的模型
claudecode --model haiku

# 限制输出长度
claudecode --max-tokens 1000

# 使用缓存（减少重复输入）
claudecode --enable-cache

Q4: 支持哪些编程语言？

A: 支持所有主流语言，特别擅长：

• Python、JavaScript/TypeScript
• Java、C++、Go、Rust
• SQL、Shell、Markdown

Q5: 如何在 CI/CD 中使用？

A:

# GitHub Actions 示例
- name: AI Code Review
  run: |
    export ANTHROPIC_API_KEY=${{ secrets.ANTHROPIC_API_KEY }}
    claudecode "审查 PR 中的代码" --dir ./src

💰 定价参考

Web 界面

版本	价格	限制
Free	$0	有使用限制
Pro	$20/月	5倍使用量 + 优先访问

API（claudecode）

模型	输入价格	输出价格
Opus	$15/1M tokens	$75/1M tokens
Sonnet	$3/1M tokens	$15/1M tokens
Haiku	$0.25/1M tokens	$1.25/1M tokens

🔗 相关资源

• 返回 AI 编程助手首页
• Antigravity 使用指南
• Cursor 使用指南
• VSCode AI 插件指南
• 工具对比分析

官方资源

• Claude Web
• Anthropic API 文档
• claudecode GitHub
• 获取 API Key

---

下一步：查看 工具对比分析，选择最适合你的工具。