本文详细介绍了 Claude Code CLI 工具和 Cursor 编辑器的完整安装配置流程,包括环境准备、安装步骤、VS Code 集成以及多种 API 端点选择方案。

📋 目录


一、Claude Code 安装

📚 参考教程

官方详细教程:飞书文档 - Claude Code 安装指南

1.1 环境准备

1.1.1 安装 Node.js

Windows 平台:

  1. 访问 Node.js 官网:https://nodejs.org/zh-cn/download/

  2. 下载适合您系统的安装包(推荐 LTS 版本)

  3. 运行安装程序,按照提示完成安装

  4. 验证安装:

    node --version
    npm --version
    

Linux 平台:

请根据您的发行版使用相应的包管理器自行安装 Node.js。

1.1.2 安装 Git

Windows 平台:

  1. 访问 Git 官网:https://git-scm.com/download/win

  2. 下载安装包并运行

  3. 按照安装向导完成安装(建议使用默认配置)

  4. 验证安装:

    git --version
    

Linux 平台:

请根据您的发行版使用相应的包管理器自行安装 Git。

1.2 安装 Claude Code

在完成环境准备后,使用 npm 全局安装 Claude Code CLI 工具:

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

安装完成后,验证安装是否成功:

claude --version

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

1.3 环境变量配置

Claude Code 需要配置两个关键的环境变量:ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN

1.3.1 Windows PowerShell 配置

在 PowerShell 中运行以下命令:

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://code.newcli.com/claude/2api', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '替换为您的API Key', 'User')

⚠️ 重要提示:

  • 请将 替换为您的API Key 替换为您实际分配到的 API Key
  • 配置完成后,必须关闭并重新打开终端才能生效
1.3.2 Linux 配置

在 Linux 系统中,运行以下命令:

echo 'export ANTHROPIC_BASE_URL="https://code.newcli.com/claude/2api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的API Key"' >> ~/.bash_profile

配置完成后,重新加载配置文件:

source ~/.bash_profile

1.4 VS Code 集成

1.4.1 启动 Claude Code

打开终端(PowerShell 或 Bash),输入以下命令启动 Claude:

claude
1.4.2 切换模型

在 Claude 控制台中,可以使用 /model 命令切换不同的模型:

/model claude-sonnet-4-5-20250929
/model claude-haiku-4-5-20251001
/model claude-opus-4-5-20251101

可用的模型名称:

  • claude-sonnet-4-5-20250929 - Sonnet 模型(平衡性能)
  • claude-haiku-4-5-20251001 - Haiku 模型(快速响应)
  • claude-opus-4-5-20251101 - Opus 模型(最强性能)
1.4.3 安装 VS Code 插件

在 Claude 控制台中,输入以下命令自动安装 VS Code 插件:

/ide

该命令会自动为 VS Code 安装 Claude 插件,实现编辑器集成。

1.4.4 禁用 GitHub Copilot(可选)

如果您的 VS Code 中安装了 GitHub Copilot,建议禁用它以避免冲突:

  1. 打开 VS Code
  2. 进入扩展(Extensions)面板
  3. 搜索 GitHub Copilot
  4. 点击禁用按钮

💡 提示: 点击卸载可能无效,因为插件可能会被自动重新安装,建议直接禁用。

1.4.5 启用 Plan 模式

在 VS Code 中,可以通过点击界面上的特定位置切换到 Plan 模式,实现更智能的代码规划功能。

1.4.6 VS Code 设置配置

在 VS Code 的设置文件(settings.json)中,找到 claudeCode.environmentVariables[] 配置项,添加以下代码:

{
  "name": "ANTHROPIC_AUTH_TOKEN",
  "value": "替换为您的API Key"
},
{
  "name": "ANTHROPIC_BASE_URL",
  "value": "https://code.newcli.com/claude/2api"
}

⚠️ 注意: 请将 替换为您的API Key 替换为您实际的 API Key。

1.5 API 端点选择

Claude Code 支持多个 API 端点,您可以根据需求和预算选择合适的端点:

端点地址 价格等级 适用场景 推荐指数
https://code.newcli.com/claude ⭐⭐⭐⭐⭐ 特别贵 不推荐轻易选择
https://code.newcli.com/azure ⭐⭐⭐⭐ 稍贵 需要 1M 上下文时使用 ⭐⭐⭐
https://code.newcli.com/claude/2api ⭐⭐⭐ 中等 推荐使用 ⭐⭐⭐⭐⭐
https://code.newcli.com/claude/aws ⭐⭐ 便宜 预算不足时使用,需要切换思考模型 ⭐⭐⭐⭐
https://code.newcli.com/claude/droid ⭐ 最便宜 预算紧张时的选择 ⭐⭐⭐
1.5.1 如何切换端点

要切换到不同的 API 端点,需要:

  1. 更新环境变量中的 ANTHROPIC_BASE_URL
  2. 使用 /model 命令切换到对应的模型

例如,切换到 AWS 端点:

# 更新环境变量(Windows PowerShell)
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://code.newcli.com/claude/aws', 'User')

# 重启终端后,使用 /model 命令切换模型
/model claude-sonnet-4-5-20250929

二、Cursor 安装

2.1 下载与安装

Cursor 是一款基于 AI 的代码编辑器,安装过程非常简单:

  1. 访问 Cursor 官网:https://cursor.com/cn
  2. 下载适合您操作系统的安装包
  3. 运行安装程序,按照提示完成安装

2.2 登录账号

安装完成后:

  1. 启动 Cursor 编辑器
  2. 使用自己注册的账号和密码登录
  3. 登录成功后即可开始使用

三、常见问题

3.1 环境变量不生效

问题: 配置环境变量后,Claude Code 仍然无法连接。

解决方案:

  • Windows:确保已关闭并重新打开终端(PowerShell)
  • Linux:运行 source ~/.bash_profile 重新加载配置
  • 验证环境变量:运行 echo $ANTHROPIC_BASE_URL 检查是否正确设置

3.2 VS Code 插件安装失败

问题: 使用 /ide 命令后,VS Code 插件未能成功安装。

解决方案:

  • 确保 VS Code 已正确安装并可以从命令行访问
  • 手动在 VS Code 扩展市场搜索 “Claude” 并安装
  • 检查 VS Code 版本是否为最新版本

3.3 模型切换失败

问题: 使用 /model 命令后,模型未能成功切换。

解决方案:

  • 确认 API 端点支持该模型
  • 检查 API Key 是否有效
  • 尝试重启 Claude Code

四、总结

本文详细介绍了 Claude Code 和 Cursor 的完整安装配置流程:

Claude Code 安装要点:

  • 需要预先安装 Node.js 和 Git
  • 使用 npm 全局安装 @anthropic-ai/claude-code
  • 配置环境变量 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN
  • 支持多种 API 端点,推荐使用 https://code.newcli.com/claude/2api
  • 可与 VS Code 深度集成

Cursor 安装要点:

  • 直接从官网下载安装包
  • 使用注册的账号密码登录即可使用

五、参考资源


六、结语

通过本教程,您应该已经成功安装并配置了 Claude Code 和 Cursor。这两款工具将大大提升您的开发效率,让 AI 成为您的编程助手。

如果在使用过程中遇到问题,欢迎在评论区留言交流!

💡 提示: 建议根据实际使用情况选择合适的 API 端点,平衡成本和性能。


关键词: Claude Code, Cursor, AI 编程助手, VS Code 集成, 开发工具

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐