【超详细】Claude Code Ubuntu平台完整部署指南
目录
是什么
Claude Code是Anthropic公司推出的终端AI编程助手,能够通过自然语言指令自主完成代码生成、调试、重构和自动化开发任务。不同于传统的代码补全AI,它可以主动读取你的代码库、编辑文件、运行命令、执行测试,并与Git、IDE及其他开发工具集成。
环境
ubuntu24.04+ Node.js 18+、Git、终端
部署步骤
1. 更新系统环境
执行如下指令
sudo apt update && sudo apt upgrade -y

2. 安装node.js
该部署要求node.js版本在18以及更高,执行该指令查看版本:
node --version

如果版本较低,可以执行如下指令使用 NodeSource 官方源安装最新 LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install nodejs -y


安装完之后检查版本:
node --version
npm --version

3. 安装git
查看git版本
git --version
如果没有则需要安装
sudo apt install -y git
4. 安装 Claude Code CLI
终端执行指令:
sudo npm install -g @anthropic-ai/claude-code
遇到报错
说明需要切换国内镜像源,此处用淘宝的镜像源
sudo npm config set registry https://registry.npmmirror.com
切换后执行成功:
检查是否安装成功:
claude --version
尝试运行:
诶,发现运行不起来,因为没配置api平台地址和key。
据了解,因为某种原因,国内很难使用Claude模型,其实Claude code是一个执行框架,不一定需要对接Claude模型。
5. 注册平台获取Key
Claude code部署还在其次,重点在于选哪个平台比较实惠好用
阿里云百炼的千问系列模型支持 Anthropic API 兼容接口,可以通过 Claude Code 调用千问系列模型。
https://bailian.console.aliyun.com/cn-beijing?tab=model#/model-market/all?inferenceProviders=bailian




开启用完即停
6. 环境配置
终端执行指令
sudo mkdir -p ~/.claude
sudo nano ~/.claude/settings.json
将下面配置填写进去(注意:api key要替换成如上自己在平台申请的key)
{
"env": {
"ANTHROPIC_API_KEY": "sk-你的真实APIKey",
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-coder-plus"
}
}

ctrl+o保存,ctrl+x退出

这个时候,需要执行以下指令:
sudo nano ~/.claude.json
补充如下内容:
hasCompletedOnboarding": true
注意: 在最后补充时上面一条json的内容末尾需要增加逗号
接下来在终端执行claude,可得:
这个时候我们需要准备一下工作空间。当前选择在桌面创建一个claude_code的文件夹,然后进入该文件夹运行claude
mkdir ~/Desktop/claude_code
cd ~/Desktop/claude_code
claude
接下来就是enjoy时刻!
直接在终端对话,可运行exit退出
最后,运行如下指令,更新到最新,大功告成!
sudo claude update

附:claude code for vscode插件部署
我们在老是在终端当聊天框也不是办法,感觉和我们的工作文件内容没有形成太好的链接,那咋办呢,用vscode+claude code插件形式
前置条件:VS Code 1.98.0 或更高版本
应用商店搜索对应插件下载:
安装完之后,左侧可以看到claude code图标,点击需要我们登录。
搞这么麻烦对不对,能不能简单点呢。答案是有的。按下Ctrl+,快捷键, 打开vscode设置,搜索claude code关键词
将禁止每次登录提示打勾后,重启vscode,直接进入聊天框

3. 配置API Key和认证信息
参照之前部署步骤在~/.claude/settings.json配置即可,或者按照如下图所示点击齿轮
点开对应的setting.json文件(注意:此setting.json非上面路径的setting.json)
将之前填写的信息转化为如下的json格式写入即可,内容不变,格式以"name"和"value"呈现。填写完重启vscode,就可以愉快的开始了!

这里简单介绍一下该插件的三个模式:
ask(先说后动):在操作之前会咨询,由尊贵的总裁你选择采纳还是放弃
edit(直接执行):根据指令直接执行,适合一些明确的,风险可控的操作
plan(先规划后执行):claude code会拆解成很仔细的步骤和思路计划,一步一步和你确认,每次都会确认完再修改
结尾
后续超b小哥会编写更多技术相关内容,如有错误欢迎批评指出
如果对您有帮助的话记得一键三连哦~
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)