2026年保姆级教程｜在Ubuntu上部署Claude CodeUI全过程

大家好，我是讯享网，很高兴认识大家。

<think>我们参考了三个引用来源，综合给出Claude Code的安装方法。根据引用内容，安装步骤会因操作系统和安装方式不同而有所差异。以下是整理后的安装指南：

一、通用前提条件

获取API密钥：注册Claude Code服务，获取ANTHROPIC_AUTH_TOKEN（即ARK_API_KEY）[^3]
确定服务地址：根据服务提供商设置ANTHROPIC_BASE_URL（示例：https://ark.cn-beijing.volces.com/api/coding）[^3]
选择模型：设置ANTHROPIC_MODEL（示例：doubao-seed-code-preview-latest）

二、Windows安装方法

方法1：直接安装（推荐初学者）

安装Visual Studio Code
- 访问VS Code官网下载安装程序
- 按照向导完成安装[^1]
安装Claude Code扩展
- 打开VS Code → 点击左侧扩展图标（四个方块）→ 搜索"Claude Code" → 点击安装[^1]

配置环境变量（在终端中执行）：

 setx ANTHROPIC_AUTH_TOKEN &quot;您的ARK_API_KEY&quot; setx ANTHROPIC_BASE_URL &quot;https://ark.cn-beijing.volces.com/api/coding&quot; setx ANTHROPIC_MODEL &quot;doubao-seed-<em>code</em>-preview-latest&quot;

讯享网重启终端使配置生效

方法2：Docker安装（推荐高级用户）

安装Docker Desktop
- 从Docker官网下载安装
- 安装时勾选“Use WSL 2 based engine”[^2]
拉取Claude Code镜像
```
讯享网 docker pull claude-code-image 
```
（具体镜像名称需根据官方提供信息调整）

运行容器时传入环境变量

 docker run -e ANTHROPIC_AUTH_TOKEN=您的密钥 -e ANTHROPIC_BASE_URL=服务地址 -e ANTHROPIC_MODEL=模型名称 <em>claude</em>-<em>code</em>-image

三、Linux/MacOS安装

通过终端设置环境变量：

讯享网 export ANTHROPIC_AUTH_TOKEN=&quot;您的ARK_API_KEY&quot; export ANTHROPIC_BASE_URL=&quot;https://ark.cn-beijing.volces.com/api/coding&quot; export ANTHROPIC_MODEL=&quot;doubao-seed-<em>code</em>-preview-latest&quot;

（建议将以上命令添加到~/.bashrc或~/.zshrc中永久生效）

安装VS Code及Claude Code扩展（步骤同Windows）

四、验证安装

打开终端输入：

echo %ANTHROPIC_AUTH_TOKEN% # Windows echo $ANTHROPIC_AUTH_TOKEN # <em>Linux</em>/MacOS

正确显示密钥即配置成功。

五、常见问题

若遇到连接问题：

检查网络连接
确认环境变量拼写正确
确保使用最新版扩展[^1]

> 注意：具体URL和模型名称请以您获得的实际服务信息为准。

§§相关问题§§

如何验证Claude Code安装是否成功？
Claude Code支持哪些编程语言？
安装后无法连接Claude服务怎么办？
如何在PyCharm中配置Claude Code？ </think> 根据提供的引用信息，我将为您整理Claude Code的安装方法。以下是详细的安装步骤，涵盖不同操作系统环境：

一、通用准备步骤

获取API密钥
- 注册Claude Code服务获取ARK_API_KEY（即ANTHROPIC_AUTH_TOKEN）[^3]
- 确认服务地址ANTHROPIC_BASE_URL（例如：https://ark.cn-beijing.volces.com/api/coding）[^3]
- 设置模型名称ANTHROPIC_MODEL（例如：doubao-seed-code-preview-latest）
配置环境变量（所有系统必需）
在终端执行（根据系统选择）： “`shell

Windows

setx ANTHROPIC_AUTH_TOKEN "您的ARK_API_KEY" setx ANTHROPIC_BASE_URL "https://ark.cn-beijing.volces.com/api/coding" setx ANTHROPIC_MODEL "doubao-seed-code-preview-latest"

# Linux/macOS export ANTHROPIC_AUTH_TOKEN="您的ARK_API_KEY" export ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/coding" export ANTHROPIC_MODEL="doubao-seed-code-preview-latest"

讯享网 验证配置：执行`echo $ANTHROPIC_AUTH_TOKEN`（<em>Linux</em>/macOS）或`echo %ANTHROPIC_AUTH_TOKEN%`（Windows），正确显示密钥即成功[^3] 二、Windows安装方法 1. 安装VS <em>Code</em> - 访问[VS <em>Code</em>官网](https://<em>code</em>.visualstudio.com/)下载安装程序 - 运行安装程序并按向导完成安装 2. 安装<em>Claude</em> <em>Code</em>扩展 - 打开VS <em>Code</em> &rarr; 点击左侧扩展图标（四个方块） - 搜索&ldquo;<em>Claude</em> <em>Code</em>&rdquo; &rarr; 点击&ldquo;Install&rdquo; 3. 验证连接 - 重启VS <em>Code</em>，检查扩展是否自动连接服务 - 如遇连接问题，参见&ldquo;常见问题&rdquo;部分 三、Docker安装（跨平台） 1. 安装Docker - 从[Docker官网](https://www.docker.com/)下载Docker Desktop - 安装时勾选&ldquo;Use WSL 2 based engine&rdquo;（Windows）[^2] - 完成安装后重启系统 2. 拉取镜像 ```docker docker pull official-<em>claude</em>-<em>code</em>-image # 具体镜像名需查询官方文档

运行容器

 docker run -e ANTHROPIC_AUTH_TOKEN=您的密钥 -e ANTHROPIC_BASE_URL=服务地址 -e ANTHROPIC_MODEL=模型名 -p 8080:80 official-<em>claude</em>-<em>code</em>-image

四、Linux/macOS安装

通过包管理器安装
”`shell

Ubuntu/Debian

sudo apt install claude-code

# macOS (Homebrew) brew install claude-code “`

手动安装
- 从GitHub发布页下载最新二进制文件
- 解压后添加到PATH路径

五、常见问题解决

连接失败
- 检查环境变量拼写和值是否正确[^1]
- 确认网络可访问ANTHROPIC_BASE_URL
- 更新VS Code和扩展至最新版本
API密钥无效
- 重新生成密钥并更新环境变量
- 重启终端和应用

> 注意：具体服务地址和模型名称需以您获得的实际服务信息为准。

2026年保姆级教程 ｜ 在Ubuntu上部署Claude CodeUI全过程