文档快速开始

Claude Code 安装与快速开始指南

让Claude Code在你的系统上运行起来，只需要几个简单步骤。这份完整的安装和配置指南涵盖了Windows、Mac和Linux系统的下载、安装、配置和模型选择。

注意： 获取最新安装说明，请访问Claude Code官方文档。

系统要求与前置条件

Claude Code支持以下操作系统：

  • macOS 10.15 (Catalina) 或更高版本
  • Windows 10 或更高版本
  • Linux (Ubuntu 18.04+, CentOS 7+ 或同等系统)

硬件要求

  • 最小4GB内存（推荐16GB）
  • 500MB可用磁盘空间
  • 稳定的网络连接用于API通信

前置依赖

安装Claude Code之前，确保你已安装：

  • Node.js 版本18.0或更高
  • Anthropic API密钥（从console.anthropic.com获取）
  • 终端或命令提示符

安装方法：分步骤指南

方法一：npm安装（推荐）

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

方法二：直接下载

从GitHub releases页面下载最新的二进制文件。

配置指南

API密钥配置

安装完成后，使用API密钥配置Claude Code：

claude config

你将完成与Claude Max或Anthropic控制台账户的一次性OAuth流程。

环境变量方式（推荐）

你也可以使用环境变量设置API密钥：

export ANTHROPIC_API_KEY="your-api-key-here"

将此命令添加到你的shell配置文件（.bashrc、.zshrc等）以使其持久化。

Claude Max订阅建议

重要提示： Anthropic API按使用量付费，频繁使用可能费用较高。对于常规Claude Code用户，Claude Max订阅可能更经济实惠。Claude Max以固定月费提供更高的使用限额，非常适合广泛使用Claude Code的开发者。

考虑Claude Max的情况：

  • 每天使用Claude Code数小时
  • 处理大型代码库
  • 定期执行复杂的多文件操作

建议： 如果不确定使用模式，建议先购买约20美元的API积分来测试Claude Code的典型工作流程，这将帮助你判断Claude Max订阅是否值得投资。

代码示例：初学者的快速入门

# 准备一个测试目录
mkdir claude-test && cd claude-test
echo "console.log('Hello Claude Code!');" > test.js
 
# 启动交互会话
claude

进入会话后可以尝试：

  • “展示此目录中的文件”
  • “请帮我优化这个 JavaScript 文件”

两种使用方式

  • 交互模式：在项目根目录运行
cd your-project
claude
  • 单次（One-shot）模式：无需进入会话，适合快速查询
claude -p "展示此目录中的文件"
claude -p "这是什么类型的项目？"

快速上手示例（Quick Wins）

理解你的项目：

展示此目录中的文件
这是什么类型的项目？
解释一下这个项目是做什么的

快速分析：

主入口文件在哪里？
项目依赖有哪些？
如何运行这个项目？

第一次文件创建：

创建一个 hello_world.txt，内容是一句问候语

Claude 会创建并展示变更，帮助你理解其对文件系统的实际操作。

常用命令速览

文件操作：

# 读取文件
read src/components/Button.js

# 编辑文件
edit src/components/Button.js

# 新建文件
write src/components/NewComponent.js

代码分析：

# 分析代码结构
analyze this codebase

# 查找模式
find all React components

# 解释模块/流程
explain how authentication works

开发任务：

# 新增特性
add a dark mode toggle to the app

# 修复问题
fix the memory leak in the data fetcher

# 重构
refactor the user service to use TypeScript

# 编写测试
write unit tests for the Button component

自然语言用法示例

# 代替复杂的 Git 命令
创建一个提交，包含我对用户认证相关代码的所有修改

# 代替繁琐的批量操作
把所有组件更新为使用新的主题系统

# 代替到处翻文档
这个项目应该如何设置数据库迁移？

模型选择与配置

Claude Code支持多个模型，你可以指定使用哪个模型以获得最佳性能：

Claude 4.1 Opus（最新最强）

最新一代最高性能模型，增强了编码和调试能力

export ANTHROPIC_MODEL="claude-opus-4-1-20250805"

Claude 4 Sonnet（平衡推荐）

最新的平衡性能和速度

export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

Claude 3.5 Haiku（经济高效）

最快速且最具成本效益

export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"

Haiku模型的重要限制

虽然Haiku成本效益高，但在Claude Code使用中有显著限制：

  • 推理能力有限 - 在复杂的多步骤规划和架构决策方面表现不佳
  • 上下文理解有限 - 在分析大型代码库和跨多个文件维护上下文方面效果较差
  • 代码分析简化 - 可能遗漏现代模型能捕获的细微错误、依赖关系或复杂模式
  • 仅适用基础重构 - 不适合复杂的重构或功能实现
  • 框架知识有限 - 在复杂框架或新颖编码模式方面效果较差

Haiku推荐使用场景：

  • 简单的单文件编辑
  • 基本语法修正
  • 快速代码问题
  • 学习Claude Code基础后再升级

对于严肃的开发工作，Claude 4 Sonnet或Opus提供显著更好的结果，额外的成本是值得的。

运行时指定模型

你也可以在启动Claude Code时直接指定模型：

claude --model claude-opus-4-1-20250805
claude --model claude-sonnet-4-20250514
claude --model claude-3-5-haiku-20241022

会话中切换模型

使用/model命令在会话中切换模型：

/model

可用选项：

  1. Default (推荐) - 使用限额的20%内使用Opus 4.1，然后使用Sonnet 4
  2. Opus - Opus 4.1用于复杂任务（更快达到使用限额）
  3. Sonnet - Sonnet 4用于日常使用
  4. Opus Plan Mode - 计划模式使用Opus 4.1，其他情况使用Sonnet 4

平台专用设置

Windows设置优化

WSL2安装与配置

1. 安装WSL2（如果尚未安装）：

wsl --install

2. 安装Linux发行版（推荐Ubuntu）：

wsl --install -d Ubuntu

3. WSL2性能优化：

在Windows用户目录中创建.wslconfig文件：

# Windows用户目录: %USERPROFILE%\.wslconfig
[wsl2]
memory=8GB          # 限制WSL2内存使用
processors=4        # 限制CPU核心
swap=2GB           # 设置交换空间
localhostForwarding=true

4. 更新WSL2到最新版本：

wsl --update

VS Code集成

1. 安装VS Code扩展：

  • WSL扩展： ms-vscode-remote.remote-wsl
  • 远程开发扩展包： ms-vscode-remote.vscode-remote-extensionpack

2. 连接VS Code到WSL：

# 在项目目录的WSL终端中
code .

3. VS Code集成功能：

  • 使用Ctrl+Esc直接打开Claude Code
  • 文件引用：Alt+Ctrl+K插入文件引用
  • 在VS Code的差异查看器中查看建议的更改

常见问题排查

网络和代理问题

公司防火墙环境：

# 设置HTTPS代理
export HTTPS_PROXY="http://proxy.company.com:8080"
export HTTP_PROXY="http://proxy.company.com:8080"
 
# 或使用socks5代理
export HTTPS_PROXY="socks5://127.0.0.1:1080"

权限错误（EACCES）

如果遇到权限错误：

# 修复npm全局安装权限
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
 
# 或使用npm的内置修复
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

SSL连接失败

# 更新证书（Ubuntu/Debian）
sudo apt update && sudo apt install ca-certificates
 
# macOS
brew install ca-certificates
 
# 或临时跳过SSL验证（不推荐用于生产）
export NODE_TLS_REJECT_UNAUTHORIZED=0

下一步

安装完成后，建议查看：

恭喜！ Claude Code已成功安装，你现在可以使用最强大的AI开发工具之一。每个伟大的开发之旅都始于坚实的基础。

概述
关于我