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

一、系统环境

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

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

sql 复制代码
sudo apt update && sudo apt upgrade -y

安装 Node.js

bash 复制代码
# 安装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. 使用淘宝的国内镜像源进行安装

arduino 复制代码
sudo npm config set registry https://registry.npmmirror.com

2. 检查是否安装成功:

css 复制代码
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文件

将以下配置填写进去:

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,程序可能会错误地认为你没有完成过初始化,从而每次启动都强制弹出引导界面。

bash 复制代码
sudo nano ~/.claude.json

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

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

三、效果测试

1. 创建工作空间

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

bash 复制代码
mkdir ~/Desktop/claude_code
cd ~/Desktop/claude_code
claude

观察到以下输出:

询问问题进行测试:

相关推荐
一起_java5 小时前
技术文章-基于Dify-Agent的智能问答系统设计与实现
java·spring boot·后端·agent·dify
stormzhangV9 小时前
Coding Agent,通往 AGI 的重要一环
人工智能·agent·ai编程
花椒技术10 小时前
Genie 4 刷屏之后,AI 视频生成正在走向下一阶段
agent·ai编程·音视频开发
IvanCodes11 小时前
LangChain(04):Runnable 与 LCEL 的执行与组合机制
python·langchain·agent
IT规划师11 小时前
热点速递 | Agent 交付没人敢合?GitHub 榜在补验收
agent·ai编程
阿里云云原生11 小时前
欢迎报名丨让 Agent 成为企业生产力,AgentCore 八城巡回沙龙·南京站
agent
ZerekZhang11 小时前
A2UI:让 Agent 画界面,而不是写代码
agent·a2ui
阿里云云原生12 小时前
阿里云 AgentLoop 通过中国信通院《企业级 FDE 交付能力要求》标准评估
agent
阿里云云原生13 小时前
2026 中国开源年会:Agent Builder Meetup×AAIF Meetup 分论坛精彩回顾 & PPT 下载
agent
花椒技术13 小时前
客户端团队用 AI 做直播间桌球,状态同步和渲染怎么落地
agent·ai编程·游戏开发