Claude Code 安装使用指南
Claude Code 是 Anthropic 官方推出的 AI 编程助手，基于 Claude 模型提供终端交互式代码生成、重构、调试等能力。它支持 100 万 Token 上下文，擅长处理整个代码库的大型任务，是当前最强大的 AI 编程工具之一。本文将从安装配置到实战使用，全面介绍 Claude Code 的使用方法。
1、Claude Code 简介
1.1、核心特性
• 100 万 Token 上下文窗口，支持大型代码库
• 终端交互式对话，支持多步骤自治任务
• 支持文件读写、命令执行、浏览器自动化
• MCP（Model Context Protocol）扩展支持
• 多模型切换（Haiku、Sonnet、Opus）
• 会话检查点与回滚功能
1.2、适用场景
• 大型重构任务
• 添加新功能
• 代码审查与优化
• Bug 调试与修复
• 项目初始化与脚手架
2、系统要求
2.1、操作系统
• macOS：macOS 12 (Monterey) 及以上
• Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+
• Windows：推荐使用 WSL2（Windows Subsystem for Linux）
2.2、前置依赖
原生安装方式无需 Node.js，推荐使用官方安装脚本。
3、安装方式
3.1、原生安装（推荐）
2025 年 10 月起，Anthropic 推荐使用原生安装方式，无需 Node.js，更简单稳定。
macOS / Linux / WSL2：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
irm https://claude.ai/install.ps1 | iexWindows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd3.2、NPM 安装（备选）
如果已有 Node.js 环境，也可以通过 npm 安装：
# 全局安装
npm install -g @anthropic-ai/claude-code
# 如遇权限问题
sudo npm install -g @anthropic-ai/claude-code3.3、验证安装
# 检查版本
claude --version
# 查看帮助
claude --help4、认证配置
4.1、官方登录
首次运行会引导登录：
# 启动 Claude Code
claude
# 按提示完成浏览器登录授权登录后会自动保存凭证，后续无需重复登录。
4.2、API Key 配置
使用第三方供应商或自托管 API：
# 设置环境变量
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://your-proxy.com" # 可选
# 或在 ~/.claude/settings.json 中配置
{
"env": {
"ANTHROPIC_API_KEY": "your-api-key",
"ANTHROPIC_BASE_URL": "https://your-proxy.com"
}
}5、基本使用
5.1、启动与交互
# 在项目目录启动
cd your-project
claude
# 直接执行任务
claude "帮我重构这个模块"
# 指定模型
claude --model claude-opus-4-20250514 "分析这个代码库"5.2、交互模式
启动后进入交互式对话界面：
• 输入自然语言描述任务
• Claude Code 会读取文件、执行命令、修改代码
• 每次操作前会请求确认（可配置自动执行）
5.3、非交互模式
# 单次执行
claude -p "添加单元测试" --allowedTools "Edit,Write"
# 输出到文件
claude -p "生成 API 文档" > api-docs.md6、核心命令
6.1、会话管理
/help # 显示可用命令和快捷键
/model # 切换模型
/compact # 压缩对话，释放上下文空间
/clear # 清除当前对话历史
/continue # 继续上一个未完成的任务
/rewind # 回滚到上一个检查点
/refresh # 刷新文件列表6.2、配置管理
/config # 查看和修改配置设置
/permissions # 管理工具权限
/theme # 切换主题
/line-numbers # 开关代码行号显示
/collapse # 折叠长文本输出6.3、模型切换
/model # 交互式选择模型
/model haiku # 切换到 Haiku（快速响应）
/model sonnet # 切换到 Sonnet（平衡）
/model opus # 切换到 Opus（最强能力）6.4、快捷键
Ctrl+R # 搜索历史提示
Esc (2次) # 回滚到上一个检查点
Ctrl+C # 取消当前操作
Ctrl+D # 退出 Claude Code7、MCP 扩展
MCP（Model Context Protocol）是 Claude Code 的扩展机制，可添加自定义工具和数据源。
7.1、配置 MCP 服务器
编辑 ~/.claude/settings.json：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "your-token"
}
}
}
}7.2、常用 MCP 服务器
• @modelcontextprotocol/server-filesystem：文件系统访问
• @modelcontextprotocol/server-github：GitHub 集成
• @modelcontextprotocol/server-postgres：PostgreSQL 数据库
• @modelcontextprotocol/server-slack：Slack 集成
8、实战技巧
8.1、项目初始化
# 创建 CLAUDE.md 项目说明文件
claude "创建一个 CLAUDE.md 文件，描述这个项目的架构和编码规范"CLAUDE.md 会被 Claude Code 自动读取，帮助理解项目上下文。
8.2、大型重构
# 明确任务范围
claude "将这个项目的网络层从 Retrofit 迁移到 Ktor，保持 API 接口不变"8.3、代码审查
# 审查最近提交
claude "审查最近一次 git commit 的改动，指出潜在问题"8.4、上下文管理
• 使用 /compact 压缩对话历史
• 使用 /rewind 回滚到关键节点
• 长任务分阶段执行，避免上下文溢出
9、常见问题
9.1、登录失败
• 检查网络连接
• 尝试使用 API Key 方式认证
• 使用 CC Switch 等工具配置代理
9.2、权限问题
# 检查权限配置
/permissions
# 允许特定工具自动执行
claude --allowedTools "Read,Edit,Write,Bash"9.3、上下文不足
• 使用 /compact 压缩对话
• 使用 /clear 开始新会话
• 将大任务拆分为小任务
10、总结
Claude Code 是当前最强大的 AI 编程工具之一，其 100 万 Token 上下文和多步骤自治能力使其特别适合大型代码库任务。核心使用要点：
• 安装：推荐使用原生安装脚本，无需 Node.js
• 认证：支持官方登录和 API Key 两种方式
• 交互：终端对话式，支持斜杠命令和快捷键
• 扩展：通过 MCP 添加自定义工具和数据源
• 技巧：善用 /compact、/rewind 管理上下文
结合 CC Switch 等工具，可以更方便地管理多个供应商配置，实现自动故障转移和用量追踪，进一步提升开发效率。
