【超详细】Claude Code Ubuntu平台完整部署指南

是什么
环境
部署步骤
- [1. 更新系统环境](#1. 更新系统环境)
- [2. 安装node.js](#2. 安装node.js)
- [3. 安装git](#3. 安装git)
- [4. 安装 Claude Code CLI](#4. 安装 Claude Code CLI)
- [5. 注册平台获取Key](#5. 注册平台获取Key)
- [6. 环境配置](#6. 环境配置)
- [附：claude code for vscode插件部署](#附：claude code for vscode插件部署)

是什么

Claude Code是Anthropic公司推出的终端AI编程助手，能够通过自然语言指令自主完成代码生成、调试、重构和自动化开发任务。不同于传统的代码补全AI，它可以主动读取你的代码库、编辑文件、运行命令、执行测试，并与Git、IDE及其他开发工具集成。

环境

ubuntu24.04+ Node.js 18+、Git、终端

部署步骤

1. 更新系统环境

执行如下指令

bash 复制代码

sudo apt update && sudo apt upgrade -y

2. 安装node.js

该部署要求node.js版本在18以及更高，执行该指令查看版本：

bash 复制代码

node --version

如果版本较低，可以执行如下指令使用 NodeSource 官方源安装最新 LTS

bash 复制代码

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install nodejs -y

安装完之后检查版本：

bash 复制代码

node --version
npm --version

3. 安装git

查看git版本

bash 复制代码

git --version

如果没有则需要安装

bash 复制代码

sudo apt install -y git

4. 安装 Claude Code CLI

终端执行指令：

bash 复制代码

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

遇到报错

说明需要切换国内镜像源，此处用淘宝的镜像源

bash 复制代码

sudo npm config set registry https://registry.npmmirror.com

切换后执行成功：

检查是否安装成功：

bash 复制代码

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. 环境配置

终端执行指令

bash 复制代码

sudo mkdir -p ~/.claude
sudo nano ~/.claude/settings.json

将下面配置填写进去(注意：api key要替换成如上自己在平台申请的key)

bash 复制代码

{
  "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退出

这个时候，需要执行以下指令：

bash 复制代码

sudo nano ~/.claude.json

补充如下内容：

hasCompletedOnboarding": true
注意: 在最后补充时上面一条json的内容末尾需要增加逗号

接下来在终端执行claude，可得：

这个时候我们需要准备一下工作空间。当前选择在桌面创建一个claude_code的文件夹，然后进入该文件夹运行claude

bash 复制代码

mkdir ~/Desktop/claude_code
cd ~/Desktop/claude_code
claude

接下来就是enjoy时刻！

直接在终端对话，可运行exit退出

最后，运行如下指令，更新到最新，大功告成！

bash 复制代码

sudo claude update

附：claude code for vscode插件部署

我们在老是在终端当聊天框也不是办法，感觉和我们的工作文件内容没有形成太好的链接，那咋办呢，用vscode+claude code插件形式

前置条件：VS Code 1.98.0 或更高版本

应用商店搜索对应插件下载：

安装完之后，左侧可以看到claude code图标，点击需要我们登录。

搞这么麻烦对不对，能不能简单点呢。答案是有的。按下Ctrl+,快捷键，打开vscode设置，搜索claude code关键词

将禁止每次登录提示打勾后，重启vscode，直接进入聊天框

配置API Key和认证信息

参照之前部署步骤在~/.claude/settings.json配置即可，或者按照如下图所示点击齿轮

点开对应的setting.json文件(注意：此setting.json非上面路径的setting.json)

将之前填写的信息转化为如下的json格式写入即可，内容不变，格式以"name"和"value"呈现。填写完重启vscode，就可以愉快的开始了！

这里简单介绍一下该插件的三个模式：

ask(先说后动)：在操作之前会咨询，由尊贵的总裁你选择采纳还是放弃

edit(直接执行)：根据指令直接执行，适合一些明确的，风险可控的操作

plan(先规划后执行)：claude code会拆解成很仔细的步骤和思路计划，一步一步和你确认，每次都会确认完再修改

结尾

后续超b小哥会编写更多技术相关内容，如有错误欢迎批评指出

如果对您有帮助的话记得一键三连哦~

【超详细】Claude Code Ubuntu平台完整部署指南

目录

是什么

环境

部署步骤

1. 更新系统环境

2. 安装node.js

3. 安装git

4. 安装 Claude Code CLI

5. 注册平台获取Key

6. 环境配置

附：claude code for vscode插件部署