Claude Code入门指南:从零开始掌握AI编程助手

什么是Claude Code?

Claude Code 是 Anthropic 公司推出的命令行 AI 编程助手,基于 Claude 大语言模型构建。与传统的代码补全工具不同,它被设计为一个真正的 AI 代理,不仅能进行对话问答,还能直接操作你的代码库、执行命令、修改文件,是一个真正意义上的 AI 编程伙伴。

核心优势

  • 终端集成:在终端中工作,可以与常见的测试套件、构建系统和版本控制工具(如Git)无缝集成
  • 完整代码理解:支持200,000 token的超大上下文窗口,能够理解整个大型代码库
  • 自动化工作流:直接通过CLI执行复杂任务,支持多步骤操作分解
  • 自然语言交互:无需依赖图形界面,用自然语言描述需求即可

系统要求与安装

系统要求

  • 操作系统:macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+

  • 硬件配置:建议 8GB RAM 及以上

  • 前置依赖:Node.js ≥ 18.0、Git 2.23+

安装步骤

根据自己的电脑系统,选择正确的安装方式

1. 原生安装(推荐)

# macOS/Linux/WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows 打开PowerShell(管理员)面板
irm https://claude.ai/install.ps1 | iex

# Windows 打开CMD面板
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

原生安装会自动处理依赖并支持后台自动更新。

2. Homebrew安装(macOS)

brew install --cask claude-code

3. npm全局安装

npm install -g @anthropic-ai/claude-code

4. 验证安装

安装完成后打开终端,输入验证

claude --version

成功安装后会显示类似Claude Code 1.x.x的版本信息。

配置与登录

作为国内大学生使用 Claude Code,最具性价比的方案需要综合考虑成本、稳定性和使用体验。

由于国外大模型费用通常较高,接下来我以国内使用成本较低的 DeepSeek 为例进行配置说明。

一、准备工作

1. 注册DeepSeek账号并获取API Key

步骤:

  1. 访问DeepSeek开放平台https://platform.deepseek.com
  2. 注册账号:使用邮箱或手机号注册
  3. 完成实名认证(国内平台要求)
  4. 获取API Key
  • 登录后进入"控制台"
  • 点击"API Keys" → "创建新的API Key"
  • 重要:API Key只显示一次,请立即保存到安全位置
  • API Key格式:
    sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

计费方式:灵活计费,成本可控,充多少用多少。

二、配置DeepSeek环境变量

根据你的操作系统和使用场景,选择以下配置方式之一:

方案一:临时配置(适合试用)

在终端中执行以下命令,配置仅对当前终端会话有效:

# 配置DeepSeek API端点
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# 配置你的DeepSeek API Key(替换sk-xxx为你的实际Key)
export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek_API_Key"

# 设置超时时间(防止长输出超时)
export API_TIMEOUT_MS=600000  # 10分钟

# 指定使用DeepSeek模型
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"

# 禁用非必要流量(可选,提高稳定性)
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

方案二:永久配置(推荐长期使用)

macOS/Linux 用户

# 1. 编辑shell配置文件
# 如果使用Zsh(macOS默认)
nano ~/.zshrc

# 如果使用Bash
nano ~/.bashrc

# 2. 在文件末尾添加以下内容
# ===== DeepSeek配置 =====
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek_API_Key"
export API_TIMEOUT_MS=600000
export ANTHROPIC_MODEL="deepseek-chat"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# ===== 配置结束 =====

# 3. 保存并退出(Ctrl+O → Enter → Ctrl+X)
# 4. 使配置生效
source ~/.zshrc  # 或 source ~/.bashrc

Windows 用户

# 方法1:通过系统环境变量(永久生效)
# 1. 右键"此电脑" → "属性" → "高级系统设置"
# 2. 点击"环境变量"
# 3. 在"用户变量"中新建:
#    变量名:ANTHROPIC_BASE_URL
#    变量值:https://api.deepseek.com/anthropic
# 4. 同样方法添加其他变量

# 方法2:通过PowerShell配置文件
# 1. 打开PowerShell
# 2. 查看配置文件路径
echo $PROFILE

# 3. 编辑配置文件(如不存在则创建)
notepad $PROFILE

# 4. 添加以下内容
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的DeepSeek_API_Key"
$env:API_TIMEOUT_MS = "600000"
$env:ANTHROPIC_MODEL = "deepseek-chat"
$env:ANTHROPIC_SMALL_FAST_MODEL = "deepseek-chat"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

# 5. 保存并重启PowerShell

方案三:配置文件方式(最稳定,最推荐)

创建 Claude Code 专用配置文件,避免与其他配置冲突:

macOS/Linux

# 创建配置目录
mkdir -p ~/.claude

# 创建配置文件
cat > ~/.claude/settings.json << EOF
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
    "API_TIMEOUT_MS": "600000",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
EOF

Windows

#打开powershell
# 创建文件夹(如果不存在)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# 创建配置文件
@'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
    "API_TIMEOUT_MS": "600000",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
'@ | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8

验证配置是否成功

一. 基础验证

在终端中执行:

# 启动Claude Code
claude

# 输入验证命令
你现在使用的模型名称是什么?

预期响应

我当前使用的模型是 deepseek-chat。

二. 功能测试

# 测试代码生成能力
请用Python写一个计算斐波那契数列的函数

# 测试代码解释能力
解释一下这段代码的作用:[粘贴一段代码]

# 测试问题解决能力
我有一个Python列表,如何快速去重?

三. 检查环境变量

# 查看当前环境变量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# 或在Claude Code中
/env

到此,claude code 已经完成安装可以正常使用了,大家还可以在自己常用的编辑器中使用 claude code。

基础使用指南

启动第一个会话

cd /path/to/your/project
claude

启动后你会看到 Claude Code 欢迎屏幕,包含会话信息、最近的对话和最新更新。输入/help查看可用命令,或输入/resume继续之前的对话。

核心命令速查表

命令功能示例
claude启动交互模式claude
claude "task"运行一次性任务claude "fix the build error"
claude -p "query"运行一次性查询,然后退出claude -p "解释下main.js文件有哪些组件"
claude -c继续最近的对话claude -c
claude -r恢复之前的对话claude -r
claude commit根据代码变更创建Git提交信息claude commit
/clear清除对话历史/clear
/help显示可用命令/help

高频斜杠命令

  • /init:扫描项目生成CLAUDE.md(新项目接入时首次使用)
  • /model:切换使用的模型(简单任务切小模型节省Token)
  • /cost:查看本次会话费用
  • /review:让AI做Code Review(提交代码前检查)
  • /mcp:管理MCP服务器(接入外部工具)

交互前缀与修饰符

  • @文件路径:引用文件作为上下文,如请review @src/utils/auth.ts
  • 使用分步说明将复杂任务分解为步骤

实战应用场景

1. 理解项目结构

# 让Claude分析你的项目
这个项目做什么?
这个项目使用什么技术?
主入口点在哪里?
解释文件夹结构

2. 代码编辑与创建

# 添加一个hello world函数到主文件
在主文件中添加一个hello world函数

Claude Code 会:

  1. 找到适当的文件
  2. 向您显示建议的更改
  3. 请求您的批准
  4. 进行编辑

重要:Claude Code 在修改文件前始终请求许可,确保安全性。

3. Git操作自动化

# 查看更改
我更改了哪些文件?

# 提交更改
用描述性消息提交我的更改

# 创建分支
创建一个名为feature/quickstart的新分支

# 解决冲突
帮我解决合并冲突

4. 调试与修复

# 添加功能
向用户注册表单添加输入验证

# 修复bug
有一个错误,用户可以提交空表单 - 修复它

Claude Code 将定位相关代码、理解上下文、实现解决方案,并在可用时运行测试。

5. 其他常见工作流

  • 重构代码重构身份验证模块以使用async/await而不是回调
  • 编写测试为计算器函数编写单元测试
  • 更新文档使用安装说明更新README
  • 代码审查审查我的更改并建议改进

6. 模型选择策略

根据 2026 年最新数据,以下是国内大模型搭配使用 Claude Code 的性价比推荐分析,大家可以根据自己的经济情况进行选择。如果能力允许,国外的大模型自然是最优的选择。

排名品牌模型型号性能特点成本(元/百万token)性价比评分推荐场景
1DeepSeekV4-Flash最新经济版,Agent场景优化,缓存命中成本极低输入0.2-1元,输出2元⭐⭐⭐⭐⭐高频调用、Agent开发、成本敏感项目
2DeepSeekV3.2性价比之王,API兼容OpenAI,数学推理强输入2元,输出3元⭐⭐⭐⭐⭐日常开发、数学计算、OpenAI迁移项目
3智谱AIGLM-4.5-Flash完全免费,生产级可用能力免费⭐⭐⭐⭐⭐入门学习、测试验证、预算为零的项目
4字节跳动豆包Seed 2.0 Lite极致低价,中文综合评分第一输入0.6元⭐⭐⭐⭐中文场景、轻量应用、高频简单任务
5智谱AIGLM-4.6编程能力最强,代码生成提升27%,对齐Claude Sonnet 4输入2-4元,输出8-16元⭐⭐⭐⭐专业编程、复杂架构、企业级应用
6阿里云通义千问Flash速度快成本低,适合简单任务输入0.15元,输出1.5元⭐⭐⭐⭐简单问答、内容生成、高频调用
7MiniMaxM2.7极速之王,响应速度快输入2.1元,输出8.4元⭐⭐⭐实时应用、低延迟场景
8阿里云Qwen3-Coder-Plus编程专用模型,1M上下文,Agent能力强输入4.8-24元,输出19.2-240元⭐⭐专业编程、长代码分析、企业级开发

总结

Claude Code 代表了 AI 编程助手的新范式——从简单的对话辅助进化到具备自主执行、长程推理能力的智能体。它的终端优先设计、完整的代码库理解能力、以及自然语言交互方式,使其成为现代开发者的强大助手。

对于初学者来说,掌握 Claude Code 只需要记住三点:

  1. 自然语言描述需求:像与同事交谈一样与Claude交流
  2. 信任但验证:Claude会在修改前请求确认,确保安全
  3. 逐步深入:从简单任务开始,逐步尝试复杂工作流

本次基础安装和使用就到这里,后期再给大家详细讲解 Claude code 的使用技巧以及如何进行项目实战。