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
步骤:
- 访问DeepSeek开放平台:https://platform.deepseek.com
- 注册账号:使用邮箱或手机号注册
- 完成实名认证(国内平台要求)
- 获取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 会:
- 找到适当的文件
- 向您显示建议的更改
- 请求您的批准
- 进行编辑
重要:Claude Code 在修改文件前始终请求许可,确保安全性。
3. Git操作自动化
# 查看更改
我更改了哪些文件?
# 提交更改
用描述性消息提交我的更改
# 创建分支
创建一个名为feature/quickstart的新分支
# 解决冲突
帮我解决合并冲突
4. 调试与修复
# 添加功能
向用户注册表单添加输入验证
# 修复bug
有一个错误,用户可以提交空表单 - 修复它
Claude Code 将定位相关代码、理解上下文、实现解决方案,并在可用时运行测试。
5. 其他常见工作流
- 重构代码:
重构身份验证模块以使用async/await而不是回调 - 编写测试:
为计算器函数编写单元测试 - 更新文档:
使用安装说明更新README - 代码审查:
审查我的更改并建议改进
6. 模型选择策略
根据 2026 年最新数据,以下是国内大模型搭配使用 Claude Code 的性价比推荐分析,大家可以根据自己的经济情况进行选择。如果能力允许,国外的大模型自然是最优的选择。
| 排名 | 品牌 | 模型型号 | 性能特点 | 成本(元/百万token) | 性价比评分 | 推荐场景 |
|---|---|---|---|---|---|---|
| 1 | DeepSeek | V4-Flash | 最新经济版,Agent场景优化,缓存命中成本极低 | 输入0.2-1元,输出2元 | ⭐⭐⭐⭐⭐ | 高频调用、Agent开发、成本敏感项目 |
| 2 | DeepSeek | V3.2 | 性价比之王,API兼容OpenAI,数学推理强 | 输入2元,输出3元 | ⭐⭐⭐⭐⭐ | 日常开发、数学计算、OpenAI迁移项目 |
| 3 | 智谱AI | GLM-4.5-Flash | 完全免费,生产级可用能力 | 免费 | ⭐⭐⭐⭐⭐ | 入门学习、测试验证、预算为零的项目 |
| 4 | 字节跳动 | 豆包Seed 2.0 Lite | 极致低价,中文综合评分第一 | 输入0.6元 | ⭐⭐⭐⭐ | 中文场景、轻量应用、高频简单任务 |
| 5 | 智谱AI | GLM-4.6 | 编程能力最强,代码生成提升27%,对齐Claude Sonnet 4 | 输入2-4元,输出8-16元 | ⭐⭐⭐⭐ | 专业编程、复杂架构、企业级应用 |
| 6 | 阿里云 | 通义千问Flash | 速度快成本低,适合简单任务 | 输入0.15元,输出1.5元 | ⭐⭐⭐⭐ | 简单问答、内容生成、高频调用 |
| 7 | MiniMax | M2.7 | 极速之王,响应速度快 | 输入2.1元,输出8.4元 | ⭐⭐⭐ | 实时应用、低延迟场景 |
| 8 | 阿里云 | Qwen3-Coder-Plus | 编程专用模型,1M上下文,Agent能力强 | 输入4.8-24元,输出19.2-240元 | ⭐⭐ | 专业编程、长代码分析、企业级开发 |
总结
Claude Code 代表了 AI 编程助手的新范式——从简单的对话辅助进化到具备自主执行、长程推理能力的智能体。它的终端优先设计、完整的代码库理解能力、以及自然语言交互方式,使其成为现代开发者的强大助手。
对于初学者来说,掌握 Claude Code 只需要记住三点:
- 自然语言描述需求:像与同事交谈一样与Claude交流
- 信任但验证:Claude会在修改前请求确认,确保安全
- 逐步深入:从简单任务开始,逐步尝试复杂工作流
本次基础安装和使用就到这里,后期再给大家详细讲解 Claude code 的使用技巧以及如何进行项目实战。
评论交流
欢迎留下你的想法