简单介绍6款AI编程相关工具的安装步骤、基础配置及核心使用方法,涵盖Claude Code、CCSwitch、Cherry Studio、OpenClaw、Cursor、Antigravity,重点补充Claude Code通过CCSwitch调用OpenRouter及智谱GLM模型的操作,适配Windows、macOS、Linux三大系统

一、Claude Code 安装教程(跨平台)

Claude Code是Anthropic推出的编程AI代理工具,国内开发者可通过CCSwitch配置OpenRouter或智谱GLM模型实现便捷使用,需先安装依赖环境再进行工具安装。

1.1 安装前准备

核心依赖:Node.js(LTS长期支持版本),所有系统均需先安装Node.js,验证安装成功后再进行Claude Code安装。

  • Windows系统:访问Node.js官网下载.msi安装包,双击运行并跟随向导完成安装;或使用winget包管理器,在PowerShell中执行命令:winget install OpenJS.NodeJS.LTS

  • macOS系统:推荐使用Homebrew安装,终端执行命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"(未安装Homebrew时),再执行brew install node;也可直接下载官网.pkg安装包。

  • Linux系统(以Ubuntu/Debian为例):终端执行命令curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -,再执行sudo apt-get install -y nodejs

验证Node.js安装:打开新的命令行/终端,执行node --versionnpm --version,能显示版本号即安装成功。

1.2 安装Claude Code

  • Windows系统:以管理员身份运行命令行,执行全局安装命令:npm install -g @anthropic-ai/claude-code

  • macOS/Linux系统:打开终端,直接执行全局安装命令:npm install -g @anthropic-ai/claude-code(Linux需加sudo:sudo npm install -g @anthropic-ai/claude-code)。

验证安装:执行claude --version,显示版本号即安装成功。

1.3 基础使用(结合CCSwitch配置)

安装完成后,默认需使用Anthropic官方API,国内用户可通过后续CCSwitch配置,切换至OpenRouter(Claude二道贩子)或智谱GLM模型,无需官方API Key,具体配置见下文CCSwitch核心使用部分。

二、CCSwitch 安装与模型切换教程(含OpenRouter/智谱GLM配置)

CCSwitch是基于Rust + Tauri框架开发的AI编程工具配置管理桌面应用,本质是「API配置切换管家」,支持快速切换Claude Code的API节点(OpenRouter、智谱GLM等),无需手动修改配置文件,核心价值是提升配置效率,解决Claude官方API使用不便的问题。

2.1 安装CCSwitch(跨平台)

2.1.1 Windows系统(两种方式)

  • 方式一:MSI安装包(推荐):下载地址(v3.10.3版本):https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows.msi,双击运行安装包,跟随向导完成安装,安装后可在开始菜单或桌面找到启动图标。

  • 方式二:便携版(绿色免安装):在GitHub Releases页面下载CC-Switch-v3.10.3-Windows-Portable.zip,解压到桌面,双击CC Switch.exe即可启动,无需安装、不写入注册表。

注意:从v3.10.2升级到v3.10.3的用户,需重新安装v3.10.3版本,避免出现配置数据丢失问题。

2.1.2 macOS系统(两种方式)

  • 方式一:Homebrew命令安装(推荐):终端依次执行命令:brew tap farion1231/ccswitchbrew install --cask cc-switch,安装完成后可在启动台找到图标。

  • 方式二:手动下载安装:访问GitHub官方Release页面,下载Mac版本安装包(.zip或.tar.gz格式),解压后将CC-Switch拖拽至「应用程序」文件夹;首次启动若提示「无法打开,因为它来自身份不明的开发者」,需进入「系统设置」→「隐私与安全性」,点击「仍要打开」确认即可。若提示文件损坏,终端执行xattr -cr "/Applications/CC Switch.app"即可修复。

2.1.3 Linux系统(两种方式)

  • Debian/Ubuntu系统:下载.deb安装包,终端执行sudo dpkg -i CC-Switch-vX.X.X-Linux.deb完成安装。

  • 通用方式(AppImage):下载AppImage格式安装包,终端执行chmod +x CC-Switch-vX.X.X-Linux.AppImage,再执行./CC-Switch-vX.X.X-Linux.AppImage即可启动。

2.2 CCSwitch 核心使用(重点:OpenRouter/智谱GLM切换)

2.2.1 前期准备:申请API Key(必做)

需提前申请OpenRouter(Claude二道贩子)和智谱GLM的API Key,步骤如下:

  1. 申请OpenRouter API Key(Claude二道贩子):

    1. 访问OpenRouter官网(https://openrouter.ai/),点击右上角「Sign Up」注册账号,推荐使用GitHub账号一键登录,操作最快捷。

    2. 登录后,点击左侧菜单「Keys」,再点击右上角「New Key」,给Key自定义命名(如“Claude-Code-Use”),点击「Create」生成API Key。

    3. 复制生成的API Key(格式为sk-or-v1-...),妥善保存(仅显示一次),后续配置需用到;新用户会赠送少量免费额度,可满足初期使用需求。

  2. 申请智谱GLM API Key:

    1. 访问智谱AI官网(https://www.zhipuai.cn/),注册并登录账号,进入「控制台」→「API密钥」。

    2. 点击「创建密钥」,自定义密钥名称,选择适用场景(编程相关),点击确认生成API Key,复制保存备用。

    3. 补充:智谱GLM支持人民币充值,新用户有免费试用额度,GLM-5模型编程能力适配Claude Code,响应速度快,国内网络可直接访问。

2.2.2 首次启动与界面说明

启动CCSwitch后,主界面分为三个核心区域:左侧为应用选择区(可选择Claude Code等需要管理的工具),右侧上方为Provider列表(API接入节点,包括OpenRouter、智谱GLM等),右上角为设置入口,底部为本地代理状态栏。

2.2.3 添加Provider(OpenRouter/智谱GLM节点)

分别添加OpenRouter和智谱GLM的API节点,步骤如下(以OpenRouter为例,智谱GLM操作类似):

  1. 在主界面点击「Add Provider」按钮,选择「Custom」自定义节点(无预设模板,需手动填写)。

  2. 填写OpenRouter节点核心信息:

    1. Name(自定义名称):输入「OpenRouter-Claude」(方便识别,可自定义)。

    2. API Base URL:输入OpenRouter官方API端点https://openrouter.ai/api/v1/

    3. API Key:粘贴之前申请的OpenRouter API Key(sk-or-v1-...)。

    4. Model:选择「anthropic/claude-sonnet-3-5」(OpenRouter聚合的Claude模型,即“二道贩子”提供的Claude模型)。

    5. API Format:选择「Anthropic」(匹配Claude Code的API格式,确保兼容)。

  3. 点击「Save」保存,OpenRouter节点即添加到列表中。

  4. 添加智谱GLM节点:

    1. 再次点击「Add Provider」→「Custom」,Name填写「智谱GLM-5」。

    2. API Base URL:输入智谱官方API端点https://open.bigmodel.cn/api/paas/v4/

    3. API Key:粘贴智谱GLM API Key。

    4. Model:选择「glm-5-plus」(最新GLM-5模型,编程适配性最好)。

    5. API Format:选择「Zhipu」(智谱专属格式,确保Claude Code正常调用)。

    6. 点击「Save」保存,智谱GLM节点添加完成。

2.2.4 切换模型/API节点(核心操作)

切换操作简单,无需修改配置文件,步骤如下:

  1. 左侧应用选择区,点击「Claude Code」(需切换的工具)。

  2. 切换至OpenRouter(Claude二道贩子):右侧Provider列表中,点击「OpenRouter-Claude」的激活按钮(勾选),CCSwitch会自动将Claude Code的配置重定向至该节点。

  3. 切换至智谱GLM:点击「智谱GLM-5」的激活按钮(勾选),自动覆盖之前的配置。

  4. 生效方式:关闭当前命令行(终止Claude Code进程),重新打开命令行,执行Claude Code相关命令(如claude code "写一个简单的Python程序"),切换即可生效。

补充:若需恢复官方设置,选择「Official Login」预设,重启Claude Code并重新登录即可。

三、Cherry Studio 安装与使用教程

Cherry Studio是一款跨平台AI生产力工具,支持多模型聚合、本地知识库搭建、智能对话等功能,适合专业开发者提升工作效率,安装简单,使用门槛较低。

3.1 安装Cherry Studio(跨平台)

  1. 访问Cherry Studio官网(https://cherrystudiocn.com/guide.html),下载对应系统的安装包:Windows用户选择.exe格式,macOS用户选择.dmg格式,Linux用户选择对应发行版的安装包。

  2. 安装操作:

    1. Windows:双击.exe安装包,跟随向导完成安装,可选择安装路径,安装后桌面生成快捷图标。

    2. macOS:双击.dmg安装包,将Cherry Studio拖拽至「应用程序」文件夹,启动方式与其他Mac应用一致。

    3. Linux:根据发行版,执行对应安装命令(如Debian系统双击.deb包,或终端执行sudo dpkg -i命令)。

  3. 启动Cherry Studio,首次启动需同意用户协议,进入主界面即可开始配置使用。

3.2 Cherry Studio 核心使用方法

3.2.1 首次配置(模型服务)

首次启动后,需配置模型服务才能正常使用AI功能,步骤如下:

  1. 点击左下角「设置」按钮,进入「模型服务」管理界面。

选择模型提供商(如硅基流动、OpenAI、DeepSeek、智谱GLM等),填入对应API密钥(需在提供商官网注册申请);特别说明:Cherry Studio配置OpenRouter和OpenClaw极为便捷,无需复杂操作,具体配置步骤如下(适配国内用户,无需额外调试):

  • 配置OpenRouter(复用前文申请的API Key):选择「自定义模型」,填入名称(如“OpenRouter-通用”),API Base URL填写https://openrouter.ai/api/v1/,粘贴OpenRouter API Key(格式sk-or-v1-...),模型选择对应需求的类型(编程推荐「anthropic/claude-sonnet-3-5」),保存即可完成配置,全程1分钟内可完成。

  • 配置OpenClaw(利用OpenClaw的本地服务):OpenClaw安装初始化后,会自动启动本地服务(默认端口18789),在Cherry Studio中选择「自定义模型」,名称填写「OpenClaw-本地」,API Base URL填写http://127.0.0.1:18790/api/v1/,无需额外填写API Key(OpenClaw已完成本地授权),保存后即可调用OpenClaw的AI能力,无需重复配置,操作极为便捷。

  1. 配置模型参数:调整温度值(0.1-2.0,数值越低,输出越严谨;数值越高,输出越灵活)、最大输出长度(建议设置2048-4096,满足大多数编程需求)。

通过「模型广场」加载专业模型(如DeepSeek-R1),支持同时激活8个服务商,按需选择即可;补充:配置好OpenRouter和OpenClaw后,可在对话界面通过@符号快速切换这两个模型,无需重新进入设置,进一步提升使用便捷性,兼顾远程模型(OpenRouter)和本地模型(OpenClaw)的优势。

3.2.2 核心功能使用

  • 智能对话与编程:在对话界面输入需求(如「写一个Python爬虫脚本」「解释这段Java代码的逻辑」),可使用@符号呼出模型选择菜单,支持多模型并行响应对比,快速选择最优结果。

  • 文档处理:拖拽上传PDF/Word文档,Cherry Studio会自动分析文档内容,生成摘要、思维导图,也可直接询问文档相关问题,快速提取关键信息。

  • 快捷命令:通过「/」命令快速调用预设工作流,例如输入/code可生成Python脚本框架,输入/translate可快速翻译代码注释。

  • 本地知识库搭建(进阶):结合Ollama部署本地模型,终端执行ollama run deepseek-r1:14b启动本地模型服务,在Cherry Studio中创建知识库,选择BAAI/bge-m3嵌入模型进行语义处理,支持批量导入PDF/PPT等文档,实现私有化知识管理。

3.2.3 快捷键技巧

Ctrl+Shift+F:启动全局搜索,支持正则表达式匹配历史对话记录;Alt+T:调出翻译面板,可保持原文格式进行双语对照;配置WebDAV可实现多设备间对话记录和知识库同步。

四、OpenClaw 安装与使用教程

OpenClaw是一款开源的AI个人助手,可运行在本地机器上,支持通过Slack、Telegram等聊天应用或Web控制面板交互,能处理邮件、写代码、抓取网页数据等,功能强大且开源免费。

4.1 安装OpenClaw(跨平台)

4.1.1 核心安装方式(推荐)

所有系统均支持npm全局安装,步骤如下:

  1. 确保已安装Node.js(同Claude Code的依赖要求,若未安装,参考1.1节步骤)。

  2. 打开命令行/终端,执行全局安装命令:npm install -g openclaw

  3. 验证安装:执行openclaw --version,显示版本号即安装成功。

4.1.2 替代安装方式

  • 官方一键安装脚本:

    • macOS/Linux:终端执行curl -fsSL https://openclaw.ai/install.sh | bash

    • Windows PowerShell:执行iwr -useb https://openclaw.ai/install.ps1 | iex

  • 源码安装(适合开发者):终端执行git clone https://github.com/openclaw/openclaw.git,进入项目目录cd openclaw,再执行pnpm installpnpm build,完成后即可使用。

4.2 OpenClaw 核心使用方法

OpenClaw使用需先完成初始化配置(运行向导),再通过指定渠道交互使用,步骤如下:

4.2.1 初始化向导配置(必做)

  1. 打开命令行/终端,执行初始化命令:openclaw onboard

  2. 阅读安全警告,选择「Yes」继续。

  3. 选择Onboarding模式:推荐选择「QuickStart」,会自动配置网关端口(18789)、绑定地址(127.0.0.1)等默认设置,无需手动配置。

  4. 配置AI模型(核心步骤):

    1. 选择模型提供商,输入对应API Key(国内用户推荐选择DeepSeek或OpenRouter,无需国际信用卡)。

    2. 国内用户配置参考:

      • 方案一(DeepSeek):选择「DeepSeek」,粘贴在DeepSeek官网申请的API Key,默认模型选择「deepseek/deepseek-chat」。

      • 方案二(OpenRouter):选择「OpenRouter」,粘贴OpenRouter官网申请的API Key,默认模型可选择「openrouter/anthropic/claude-opus-4-6」,一个Key可访问多家模型。

    3. 国际用户:选择「Anthropic」,使用Anthropic API Key,默认模型选择「anthropic/claude-opus-4-6」(需国际信用卡)。

  5. 选择聊天渠道(可选):向导会显示支持的聊天渠道(Slack、Telegram等),选择需要配置的渠道,若暂时不需要,可跳过(后续可通过openclaw configure补充配置)。

  6. 配置完成后,向导会提示初始化成功,即可开始使用OpenClaw。

4.2.2 基础使用操作

  • Web控制面板:初始化完成后,访问http://127.0.0.1:18789,即可进入Web控制面板,直接输入需求(如「写一段Java代码」「抓取某个网页的内容」),AI会快速响应。

  • 聊天渠道交互:若配置了Slack、Telegram等渠道,可通过对应应用发送消息给OpenClaw,实现24小时在线交互,例如发送「帮我整理今天的邮件」,AI会自动处理并反馈结果。

  • 常用命令:openclaw configure(补充配置聊天渠道、模型等)、openclaw restart(重启OpenClaw服务)、openclaw help(查看所有可用命令)。

五、Cursor 安装与使用教程

Cursor是一款融合AI能力的现代代码编辑器,旨在提升开发者编码效率,支持跨平台安装,操作简单,兼容VS Code快捷键,适合各类开发者使用。

5.1 安装Cursor(跨平台)

  1. 访问Cursor官网(cursor.com),点击首页「Download」按钮,系统会自动识别当前系统,下载对应安装包(Windows为.exe,macOS为.dmg,Linux为对应发行版安装包)。

  2. 安装操作:

    1. Windows:双击.exe安装包,跟随向导完成安装,可选择安装路径,安装后桌面生成快捷图标。

    2. macOS:双击.dmg安装包,将Cursor拖拽至「应用程序」文件夹,启动即可使用。

    3. Linux:访问cursor.com/downloads,下载对应版本(如.deb、.rpm),执行对应安装命令即可。

  3. 启动Cursor,首次启动会进入初始化向导,完成基础配置即可。

5.2 Cursor 核心使用方法

5.2.1 首次运行设置

  • 快捷键方案选择:推荐选择VS Code风格,降低学习成本,也可自定义快捷键。

  • 主题选择:支持深色、浅色、高对比度主题,可根据个人习惯选择,后续可通过设置修改。

  • 终端环境配置:设置Shell类型、字体等,适配个人开发习惯。

补充:若需重新调整初始化设置,可通过Ctrl+Shift+P搜索「Cursor: Start Onboarding」重新配置。

5.2.2 账户注册(可选但推荐)

匿名使用可完成基础编码,但注册账户可解锁完整AI功能:通过Ctrl+Shift+J打开Settings,选择「Sign Up」完成邮箱验证,登录后可获得增强AI补全、团队协作、使用历史同步等功能,可在cursor.com/dashboard管理账户。

5.2.3 核心功能实战

  • Tab智能补全:新建代码文件(如demo.js),输入函数开头(如function calculate),会自动弹出补全建议,按Tab键接受,可自动生成完整函数框架,支持跨文件上下文关联、自动生成文档注释。

  • Inline Edit即时重构:选择一段代码,按下Ctrl+K激活编辑模式,输入自然语言指令(如「将这个函数修改为计算斐波那契数列」),按Enter确认,Cursor会自动实现逻辑、添加必要引用和注释。

  • AI Agent协作开发:按下Ctrl+I打开聊天面板,输入自然语言需求(如「为这段代码写测试用例并运行」),AI会自动创建测试文件、编写用例、运行测试并反馈结果,还支持优化算法、转换代码语言等复杂需求。

  • 项目初始化:可直接打开本地现有项目,或通过终端执行git clone git@github.com:voxelize/voxelize.git && cd voxelize && cursor .,克隆官方示例项目学习使用。

六、Antigravity 安装与使用教程

Antigravity是谷歌推出的AI编程IDE,支持免费使用Gemini 3模型进行编程,基于VS Code架构,界面简洁,操作流畅,需满足特定环境条件才能正常安装使用。

6.1 安装前准备

  • 硬件:一台可正常联网的电脑(Windows、macOS、Linux均可)。

  • 账户:一个美国Google账号(需提前注册,且账户地区需设置为美国)。

  • 网络:需使用美国地区IP(否则会卡在登录界面,无法正常使用)。

账户地区检查与修改:访问https://policies.google.com/country-association-form,检查Google账户地区,若不是美国,提交修改为美国地区即可。

6.2 安装Antigravity

  1. 访问Antigravity官方页面(https://antigravity.google),点击下载按钮,下载对应系统的安装包。

  2. 双击安装包,跟随向导完成安装(安装过程与普通IDE一致,无需额外配置)。

  3. 安装完成后,启动Antigravity,使用美国Google账号登录(确保IP为美国地区),登录后一直点击「Next」,即可进入主界面,完成安装。

6.3 Antigravity 核心使用方法

6.3.1 切换中文界面

默认界面为英文,切换中文步骤:按下快捷键Ctrl+Shift+P(苹果电脑为Cmd+Shift+P),输入「Install Extensions」按回车,搜索并安装「Chinese (Simplified)」扩展,退出并重启Antigravity,界面即可切换为中文。

6.3.2 强制Gemini 3中文回复

默认情况下,Gemini 3会输出英文,设置中文回复步骤:

  1. 打开右侧聊天面板,点击右上角「…」,选择「Customizations」。

  2. 选择「Rules」,作用范围建议选择「Project」(当前项目),系统会自动生成并打开GEMINI.md文件。

  3. 在GEMINI.md文件中输入「Always respond in 中文」,保存文件。

  4. 验证:新建一个Chat,输入需求(如「帮我写一个贪吃蛇游戏」),若回复为中文,说明设置生效。

6.3.3 基础编程使用

Antigravity基于VS Code架构,操作与VS Code类似,核心优势是集成Gemini 3模型,可通过聊天面板输入自然语言需求,快速生成代码、调试代码、优化逻辑;也可直接编写代码,AI会实时提供补全建议,提升编码效率。

七、通用注意事项

  • 所有工具安装前,确保系统满足对应依赖要求(如Node.js),避免安装失败。

  • API Key需在对应官网注册申请,妥善保管,不要泄露给他人,避免产生不必要的费用。

  • 部分工具(如Antigravity)需特定网络环境,需提前配置好,否则无法正常登录和使用。

  • 若安装或使用过程中出现报错,可查看工具官方文档或GitHub Issues,大部分问题可找到解决方案。

  • Claude Code通过CCSwitch切换模型后,若调用失败,可检查API Key是否正确、Provider配置是否匹配(如API Format选择正确),重启CCSwitch和Claude Code即可。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐