安装步骤
工欲善其事,必先利其器。在正式使用 Claude Code 之前,需要先完成几项关键准备工作,确保环境就绪。
前置条件
- 操作系统需要安装 Node.js 18 或更高版本。
- Windows 用户请务必提前安装 Git for Windows,以确保兼容性。
完成上述环境配置后,即可进入核心安装环节。打开终端或命令行工具,直接执行以下命令,全局安装 Claude Code 软件包:
npm install -g @anthropic-ai/claude-code
安装过程通常耗时较短。安装完成后,输入如下命令检查版本号,若能正常显示,则表明安装成功:
claude --version
配置工具
自动化助手(推荐)
手动配置工具不仅过程繁琐,而且容易引发错误。借助 Ark Helper 这一自动化工具,可显著降低配置复杂度与出错概率,节省宝贵时间。
需要注意的是,Ark Helper 目前仅支持 MacOS 和 Linux 系统,Windows 用户暂时仍需采用手动方式进行配置。
以下步骤适用于首次使用 Ark Helper 的场景。若您之前已使用过该工具,请按照界面指引依次完成套餐配置与工具配置即可。
首先安装 Ark Helper:
curl -fsSL https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/install.sh | sh安装完后,同样通过版本号命令确认安装是否成功:
ark-helper --version在终端中输入
ark-helper启动该工具。根据界面引导完成套餐配置:
- 选择套餐:选中
[Volcano] Volcano Engine(国内)方案。 - 配置 API Key:请获取您专属的 API Key 并填入。
- 选择默认模型。
- 选择套餐:选中
继续跟随提示配置 Claude Code 工具:
- 选择所需配置的编码工具:选定
Claude Code。 - 选择
设置 Volcano 配置到 Claude Code。完成后选择退出。若需重新配置,请先选卸载 Claude Code 配置,再从头执行上述步骤。
- 选择所需配置的编码工具:选定
使用 Claude Code
至此,所有准备工作均已就绪,可以正式启用 Claude Code 的强大功能。
启动:切换到您的项目目录,执行
claude命令。cd my-project claude启动后会出现信任提示,请选择信任当前文件夹,授权 Claude Code 访问项目文件即可。
模型状态验证:输入
/status查看模型是否正常运行。对话:一切正常后,便可在 Claude Code 中开始提问或进行编码交互。
切换模型
不同使用场景往往需要调用不同的模型。切换方式取决于您最初配置模型时采用的方法,主要分为以下两种情况:
| 配置方式 | 配置 ark-code-latest |
配置 Model Name |
|---|---|---|
| 切换模型操作 | 1. 在开通管理页面选择目标模型,切换后等待 3-5 分钟即可生效。 2. 在命令行启动后,输入 /status 确认模型状态。 |
* 启动时:直接使用 claude --model 指定模型。* 对话期间:输入 /model 实现即时切换。 |
