Claude Code 使用入门教程：从安装到实战

Claude Code 是 Anthropic 推出的终端原生 AI 编程工具，基于 Claude 4 系列模型打造，无需切换 IDE 或聊天窗口，直接在终端中实现代码生成、调试、项目导航和自动化任务处理。本文将详细介绍 Claude Code 的安装、配置和使用方法。

📦 一、Claude Code 安装

Claude Code 支持 Windows、macOS、Linux（含 WSL）等操作系统，有多种安装方式可供选择。

1.1 安装方式

方式一：npm 全局安装

# 全局安装最新稳定版
npm install -g @anthropic-ai/claude-code

# 验证安装成功（显示版本号即生效）
claude --version

方式二：原生安装（无需 Node.js）

macOS/Linux/WSL：

# 稳定版
curl -fsSL https://claude.ai/install.sh | bash

# 最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

Windows PowerShell：

# 稳定版
irm https://claude.ai/install.ps1 | iex

# 最新版
& ((scriptblock)::Create((irm https://claude.ai/install.ps1))) latest

1.2 首次启动与认证

# 进入项目目录
cd your-project

# 启动工具
claude

按提示在浏览器中完成 OAuth 授权（登录 Claude 账号即可），授权成功后，终端将自动缓存令牌，后续无需重复登录。

⚙️ 二、cc switch API 配置

cc switch 是 Claude Code 的 API 配置管理工具，支持快速切换不同的 API 提供商和模型。

2.1 安装 cc switch

macOS（Homebrew 方式）：

# 添加 ccswitch 的软件源
brew tap farion1231/ccswitch

# 安装 ccswitch
brew install --cask cc-switch

2.2 环境变量冲突处理

在使用 cc switch 之前，需要清理可能存在的环境变量冲突：

# 检查环境变量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# 清理旧配置（以 zsh 为例）
vim ~/.zshrc
# 删除所有 anthropic_* 相关的行
source ~/.zshrc

2.3 添加 API 供应商

1. 打开 cc switch，点击右上角的加号按钮
2. 选择预设模板（如智谱 glm、kimi、moonshot）或创建自定义配置
3. 填入你的 API key 和 base url，点击保存

示例配置：

• 智谱 glm：

  • 供应商名称：智谱 glm
  • base url：https://open.bigmodel.cn/api/paas/v4
  • api key：你的智谱 API key

• Kimi：

  • 供应商名称：kimik2
  • base url：https://api.moonshot.cn/anthropic/
  • api key：你的 moonshot API key

📜 三、常用命令解析

3.1 基础命令

3.2 斜杠命令

3.3 快捷键

🧪 四、简单案例示范

4.1 代码生成案例

需求：用 Python 写一个快速排序算法

claude "用 Python 实现快速排序算法，并添加详细注释"

输出：

def quick_sort(arr):
    """
    快速排序算法实现
    
    参数:
    arr (list): 待排序的列表
    
    返回:
    list: 排序后的列表
    """
    # 基线条件：如果列表长度小于等于1，直接返回
    if len(arr) <= 1:
        return arr
    
    # 选择基准元素（这里选择中间元素）
    pivot = arr[len(arr) // 2]
    
    # 分区操作
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]
    
    # 递归排序左右两部分并合并结果
    return quick_sort(left) + middle + quick_sort(right)

# 示例用法
if __name__ == "__main__":
    unsorted_list = [3, 6, 8, 10, 1, 2, 1]
    sorted_list = quick_sort(unsorted_list)
    print("排序前:", unsorted_list)
    print("排序后:", sorted_list)

4.2 代码调试案例

需求：修复以下 Python 代码中的错误

claude "修复以下代码中的错误：
def divide(a, b):
    return a / b

print(divide(10, 0))"

输出：

def divide(a, b):
    try:
        return a / b
    except ZeroDivisionError:
        return "不能除以零"

print(divide(10, 0))

💡 五、使用技巧与最佳实践

5.1 权限模式切换

• 普通模式（默认）：所有操作需手动确认，适合新手
• 自动接受模式：自动执行所有操作，效率最高（信任场景使用）
• Plan 模式：先生成详细开发计划，确认后再执行（复杂项目推荐）

切换方式：Shift+Tab

5.2 高效交互技巧

• 文件提及：用 @ 快速引用文件（支持路径自动补全），如 分析@src/App.tsx
• Bash 模式：前缀 ! 直接执行终端命令，如 ! git status
• 多行输入：\+Enter 或 Shift+Enter 换行输入复杂需求

5.3 记忆管理

运行 /init 命令，将自动生成 CLAUDE.md 文件，记录项目架构、编码规范、数据库结构等信息。后续启动工具时，将自动加载该文件，无需重复解释项目背景。

可手动编辑 CLAUDE.md 添加自定义规则，例如：

# 项目规范
1. 代码风格：使用 ESLint+Prettier，单引号，无分号
2. 接口请求：统一使用 @src/services/request.ts 的 request 函数
3. 组件命名：PascalCase 格式，文件夹与组件名一致

✅ 六、总结

Claude Code 是一款功能强大的 AI 编程助手，通过自然语言交互方式，帮助开发者快速实现代码生成、调试、项目导航等功能。掌握 Claude Code 的安装、配置和常用命令，能够显著提升开发效率，降低编程门槛。