跳到主要内容

安装指南

系统要求​

在安装 Claude Code 之前，请确保你的系统满足以下要求：

  • 操作系统：Windows 10+、macOS 10.15+ 或 Linux
  • Node.js：版本 18.0 或更高
  • 内存：至少 4GB RAM
  • 网络：稳定的互联网连接

安装 Claude Code​

方法一：通过 npm 安装（推荐）​

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

方法二：通过 Homebrew 安装（macOS）​

brew install claude-code

方法三：下载二进制文件​

访问我们的发布页面下载适合你平台的最新二进制文件。

初始设置​

安装完成后，运行设置命令：

claude setup

这将引导你完成：

  1. API 密钥配置 - 连接到 Anthropic 的 API
  2. 工作空间设置 - 配置你的默认工作空间
  3. 偏好设置 - 设置你的编码风格和偏好

验证安装​

测试你的安装：

claude --version
claude --help

快速开始​

使用 Claude Code 创建你的第一个项目：

mkdir my-project
cd my-project
claude init

身份验证​

使用 Anthropic API 密钥​

  1. 从 Anthropic Console 获取你的 API 密钥
  2. 进行设置：
claude auth login

企业设置​

对于使用 Bedrock 或 Vertex AI 的企业部署：

claude auth configure --provider bedrock
# 或
claude auth configure --provider vertex

配置​

Claude Code 可以通过以下方式配置：

  • 全局配置：~/.claude/config.yaml
  • 项目配置：./claude.config.js
  • 环境变量：CLAUDE_*

配置示例​

# ~/.claude/config.yaml
api:
  provider: anthropic
  key: your-api-key
  
preferences:
  model: claude-3-sonnet
  language: zh-Hans
  editor: vscode
  
workspace:
  default_path: ~/projects
  auto_save: true

IDE 集成​

VS Code 扩展​

从 VS Code 市场安装 Claude Code 扩展：

code --install-extension anthropic.claude-code

其他编辑器​

Claude Code 支持与以下编辑器集成：

  • IntelliJ IDEA - 插件可用
  • Vim/Neovim - 通过 LSP
  • Emacs - 通过包管理器

故障排除​

常见问题​

权限被拒绝错误

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

API 密钥问题

claude auth status
claude auth refresh

网络连接问题

claude doctor

获取帮助​

下一步​

现在你已经安装了 Claude Code：

  1. 跟随教程 - 学习基础知识
  2. 配置你的环境 - 自定义设置
  3. 探索功能 - 发现能力

**准备好开始 AI 编程了吗？**从我们的教程开始！