Claude Code 快速开始

在安装完成 Claude Code 后，让我们通过几个简单的例子来快速上手。

基本设置

在开始使用之前，建议先进行基本配置：

支持的模型：

• claude-opus-4-1-20250805 - Opus 4.1
• claude-opus-4-20250514 - Opus 4
• claude-sonnet-4-20250514 - Sonnet 4
• claude-3-7-sonnet-20250219 - Sonnet 3.7
• claude-3-5-haiku-20241022 - Haiku 3.5

# 设置模型和基本选项
claude config set -g model claude-sonnet-4-20250514
claude config set -g verbose true
claude config set -g outputFormat text

# 测试连接
claude "Hello, Claude!"

# 健康检查
claude /doctor

基本使用

启动 Claude Code

打开终端或命令行，运行：

claude

这将启动交互式模式，您可以直接与 Claude Code 对话。

常用命令

基础交互：

claude                      # 启动交互模式
claude "帮我修复这个代码漏洞"   # 单次命令
claude -p "<提示内容>"        # 打印模式
cat 文件名 | claude -p "<提示内容>"  # 管道输入

对话管理：

claude -c                   # 继续最近对话
claude -r <会话ID>           # 恢复特定会话
claude --resume <名称>       # 按名称恢复

维护命令：

claude update               # 更新到最新版本
claude mcp                  # MCP 服务管理

在项目中使用

进入您的项目目录，然后启动 Claude Code：

cd /path/to/your/project
claude

Claude Code 会自动分析项目结构，为您提供更精准的帮助。

常用场景示例

代码解释

# 解释特定文件
claude -p "解释 src/main.js 文件的作用"

# 分析函数
claude -p "分析 getUserData 函数的逻辑"

代码生成

# 生成新功能
claude "帮我创建一个用户注册的 API 接口"

# 生成测试代码
claude "为这个函数生成单元测试"

调试帮助

# 分析错误日志
cat error.log | claude -p "分析这些错误并提供解决方案"

# 检查代码问题
claude -p "检查代码中是否有潜在的安全问题"

代码优化

# 性能优化
claude "优化这个查询函数的性能"

# 代码重构
claude "重构这个组件，使其更易维护"

交互式会话示例

启动 Claude Code 后，您可以进行如下对话：

$ claude

Claude Code v1.0.0

🤖 你好！我是 Claude Code，你的 AI 编程助手。我可以帮你：
   • 分析和解释代码
   • 生成新的功能代码
   • 调试和修复问题
   • 优化和重构代码
   
   请告诉我需要什么帮助？

👤 分析一下这个项目的结构

🤖 我来分析你的项目结构...
   [Claude Code 会扫描项目文件并提供详细分析]
   
👤 帮我优化数据库查询性能

🤖 我来检查你的数据库查询代码...
   [提供优化建议和改进后的代码]

会话管理

继续上次对话

claude -c

恢复特定会话

claude --resume abc123

会话 ID 会在每次对话开始时显示。

输出格式

JSON 格式输出（适合脚本）

claude -p "分析代码质量" --output-format json

详细日志模式

claude --verbose -p "检查类型错误"

交互式快捷命令

在交互模式中，您可以使用以下快捷命令：

/help       # 显示帮助信息
/add-dir    # 添加工作目录
/clear      # 清屏
/config     # 查看配置
/cost       # 查看使用费用
/exit       # 退出
/init       # 初始化项目记忆
/model      # 切换模型
/review     # 代码审查
/sessions   # 查看会话列表

实用技巧

1. 使用管道：将其他命令的输出传递给 Claude Code

   git diff | claude -p "总结这次提交的变更"

2. 添加工作目录：让 Claude Code 访问多个目录

   claude --add-dir ../utils ../components

3. 权限控制：限制 Claude Code 可以使用的工具

   claude --allowedTools "Read" "Grep"

下一步

现在您已经掌握了基本用法，可以：

• 查看 CLI 参考手册 了解所有可用命令
• 浏览 使用教程 学习高级技巧
• 阅读 常见问题 解决可能遇到的问题

开始您的 AI 编程之旅吧！