VibeCoding实践——Ubuntu 接入Claude Code Cli 配置教程

一、系统环境

Ubuntu 24.04, Node.js v20.20.2, Git 2.34.1

如果没有上述库需要自行安装：

sudo apt update && sudo apt upgrade -y

安装 Node.js

# 安装Node.js最新版本，要求node.js版本在18以及更高
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install nodejs -y

安装 git

sudo apt install -y git 

二、安装 Claude Code CLI

1. 使用淘宝的国内镜像源进行安装

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

2. 检查是否安装成功：

claude --version

3. 配置APIKEY和地址：

这里需要注意，Claude code是一个执行框架，不一定需要对接Claude模型，对于国内用户而言，只要模型支持 Anthropic API 兼容接口，可以通过 Claude Code 调用这些系列模型。下面以deepseek模型为例讲解。

（1）通过查看Deepseek的官方API接口文档：

首次调用 API | DeepSeek API Docs

我们发现deepseek兼容Anthropic API，此时的base_url变为了https://api.deepseek.com/anthropic ，而不是我们之前实践中创建agent常用的https://api.deepseek.com，除了deepseek之外的其他国产大模型也是如此查找。

（2）申请对应大模型的API

以deepseek为例，在API开放平台进行申请，得到APIkey

DeepSeek 开放平台

（3）配置~/.claude/settings.json文件

将以下配置填写进去：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-99f***********************c",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-flash"
  },
  "model": "deepseek-v4-flash"
}

还有一种方法是直接配置环境变量：

本例采用第一种方法配置~/.claude/settings.json文件。

（4）跳出引导界面

手动修改了配置文件、更换了 API 密钥、或者遇到了某些 Bug，程序可能会错误地认为你没有完成过初始化，从而每次启动都强制弹出引导界面。

sudo nano ~/.claude.json

在 ~/.claude.json 文件的末尾加上 "hasCompletedOnboarding": true

手动加上这一行并设为 true，可以强制跳过该弹窗，让你能够正常进入命令行交互界面。

三、效果测试

1. 创建工作空间

当前选择在桌面创建一个claude_code的文件夹，然后进入该文件夹运行claude。

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

观察到以下输出：

询问问题进行测试：