Linux系统上的官方Claude Code安装教程 Linux官方原版包【新手友好向快速安装指南】

415 阅读3分钟

一、安装组件

1.下载安装nodejs

1.1 安装NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc

1.2 安装最近的稳定版本的node.js

nvm install --lts

1.3 验证安装

node -v
npm -v

2.打开终端

使用 Cmd+Space 搜索 "Terminal" 或在 应用程序 > 实用工具 中找到终端

3.卸载已安装的Claude Code(未安装请跳过)

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

4.安装官方原版的Claude Code

# 设置镜像源 加快下载速度
sudo npm config set registry https://registry.npmmirror.com

#下载claude code
sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

二、配置环境变量

1.一键配置环境变量(推荐使用)

1.1 复制一键安装命令

moacode官网的控制中心中找到“快速设置”模块,点击复制符合您系统的相应命令。

屏幕截图 2025-12-16 092748.png 将复制的命令粘贴到终端后运行,即可一键配置 claude code 环境。

2.手动配置环境变量

2.1 查找API key

a.快速查找(小白推荐)

moacode官网的控制中心中找到“API配置”模块,点击复制您的API key即可。

屏幕截图 2025-12-21 152258.png

b.自定义API key

若您需要指定使用的模型,登入moacode官网,在左侧工具栏处点击接口模块,即可在右侧操作区域创建符合您需求的API key,完成后复制即可

屏幕截图 2025-12-20 154052.png

2.2 设置环境变量

1.复制完key后,按下面的格式粘贴进mac终端后运行

#复制你的key
复制下面代码,把your api key换成你的api key,然后全部复制一起粘贴进mac终端,再回车运行
echo 'export ANTHROPIC_AUTH_TOKEN="your api key"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="your api key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://moacode.org"' >> ~/.zshrc
source ~/.zshrc

(备注:使用服务器端每次重新ssh连接需要重新export key,输入export ANTHROPIC_AUTH_TOKEN="your api key"',export ANTHROPIC_API_KEY="your api key")

Tip:安装中出现问题,可以截图发给免费的国产ai比如豆包,基本排查一下就可以解决90%的问题

保存好环境后重启终端!!!

三、使用Claude Code

在终端输入claude,然后回车运行,问你是否要用这个API key,选完Yes然后一路回车就可以开始使用了!

恭喜你完成了Claude Code的安装,现在开始你的Claude Code之旅吧!!!

*若您希望将Claude code接入Vscode/cursor使用可参考此快速部署教程:Claude code接入vscode/cursor教程【新手友好向快速安装指南】想提高你的编程效率吗?快来试试clau - 掘金

*若您在安装Claude code时遇到困难可参考此快速处理指南:Claude Code常见报错原因&问题合集还在为编程苦恼吗?快来试试claude code吧!本文将会以简单明了的步 - 掘金