Claude Code 是一款强大的 AI 编程助手工具,可以直接操作您的代码文件,帮助您更高效地进行开发工作。本文将为您详细介绍如何在 Windows 系统上安装和使用 Claude Code,最后章节扩展了macOS系统上的安装。

前期准备

第一步:获取 API 密钥

在开始安装之前,您需要先获取 Claude Code 的 API 密钥:

  1. 访问 AICodeMirror 注册页面
  2. 完成注册流程
  3. 获取您的 API 密钥
  4. 平台提供一定的免费额度供您使用

注意:如果您已经拥有 类似的符合OpenAI规范的密钥,可以跳过此步骤。

第二步:安装必备软件

Windows 用户需要安装两个基础工具:

1. 安装 Git
  • 访问 Git 官方下载页面
  • 下载最新版本的 Git for Windows(x64 或 ARM64 版本)
  • 运行安装程序,按照默认设置完成安装
2. 安装 Node.js
  • 访问 Node.js 中文官网
  • 推荐下载 LTS(长期支持)版本
  • 运行安装程序,完成 Node.js 和 npm 的安装
3. 验证安装

打开命令提示符(CMD)或 PowerShell,输入以下命令验证安装:

node -v
npm -v

如果显示版本号,说明安装成功。

安装 Claude Code

卸载旧版本(如适用)

如果您之前安装过 Claude Code,建议先卸载旧版本:

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

注意:如果是首次安装,请跳过此步骤。

安装 Claude Code Router

由于国内用户可能遇到"地区限制无法使用"的问题,推荐使用 claude-code-router 解决方案:

npm install -g @musistudio/claude-code-router

此工具专为解决地区限制问题而设计,安装后即可正常使用。

配置 Claude Code

方法一:使用可视化配置界面(推荐)

安装完 claude-code-router 后,您可以使用可视化界面进行配置:

  1. 在命令行中输入:
ccr ui
  1. 系统会自动弹出配置界面
    配置供应商信息
    配置供应商信息还有填它们能提供的模型名称

  2. 配置完成后,选择对应模型,关闭配置界面
    在这里插入图片描述

方法二:使用环境变量配置

如果您不想使用 claude-code-router,可以通过配置环境变量的方式:

需要配置以下三个环境变量:

  • ANTHROPIC_BASE_URL:配置 API 基础 URL
  • ANTHROPIC_API_KEY:配置您的 API 密钥
  • ANTHROPIC_AUTH_TOKEN:配置授权令牌

启动和使用

启动 Claude Code

  1. 重启 Shell 终端:配置完成后,需要重启命令行窗口使配置生效

  2. 启动 Claude Code

# 导航到您的项目
cd your-project-folder

# 安装了的claude-code-router启动
ccr code

# 原生Claude Code启动
claude
  1. 启动成功后,您就可以开始与 Claude Code 进行对话了

主要功能

Claude Code 启动后具有以下强大功能:

  • 智能对话:通过自然语言与 AI 交流您的编程需求
  • 代码操作:Claude Code 可以直接读取、修改和创建您的代码文件
  • 项目理解:AI 能够理解您的项目结构,提供针对性的建议
  • 实时协作:在编码过程中获得即时帮助和指导

常见问题解决

地区限制问题

如果遇到"地区限制无法使用"的提示,确保:

  • 已正确安装 @musistudio/claude-code-router
  • 使用 ccr 命令而非原始命令启动

配置不生效

如果配置后无法正常使用:

  • 确认已重启命令行终端
  • 检查 API 密钥是否正确
  • 验证网络连接是否正常

版本兼容性

Claude Code 在 Windows 系统上现已支持通过 Git 方式直接安装,无需使用 WSL(Windows Subsystem for Linux),大大简化了安装流程。

总结

通过以上步骤,您应该能够成功在 Windows 系统上安装和使用 Claude Code。这个强大的 AI 编程助手将成为您开发工作中的得力帮手,显著提升编码效率。记住要充分利用免费额度,探索 Claude Code 的各种功能,让 AI 助力您的编程之旅!

扩展 macOS安装

AICodeMirror macOS安装 镜像站里面有macOS和linux的安装教程,流程和本文一致,若国内用户也想使用claude-code-router绕过限制,可视化操作,命令也一致。

# 安装Homebrew 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Homebrew安装git,也可官网下载
brew install git
# 验证git安装
git --version

# Homebrew安装node,也可官网下载
brew install node
# 验证安装
node -v
npm -v

# 卸载旧版本(如适用,首次安装可跳过)
npm uninstall -g @anthropic-ai/claude-code

# 安装Claude Code Router(国内用户跳过地区限制,可视化配置可使用)
npm install -g @musistudio/claude-code-router

# 配置API(如不使用Claude Code Router跳过)
ccr ui

# 配置变量(如使用Claude Code Router跳过)
export ANTHROPIC_BASE_URL="your_base_url"
export ANTHROPIC_API_KEY="your_api_key"
export ANTHROPIC_AUTH_TOKEN="your_auth_token"

# 启动Claude code
# 原生
claude
# 安装了Claude Code Router
ccr code
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐