前言
藍耘 Coding UI 作為基于 Claude Code 的可視化工具,憑借對本地項目的深度掌控、與 Git 倉庫的無縫銜接以及直觀的交互界面,正在重構開發者的工作流。本文將帶你一步步完成從環境搭建到實戰使用的全流程,讓這款工具真正成為你的編程「副駕」。
溫馨提示:
博主寫的時候腦子比較混亂,正篇文章的思路應該如此:
先進行node.js和npm的安裝,然后進行claude code的本地配置,最后再進行lanyuncodingui的配置與安裝操作
lanyuncodingui可視化界面目前只支持Mac和Liux環境,目前不支持Windows的,如果你想體驗的話你可以使用虛擬機、云服務器、wsl、mac進行體驗的,我的這篇文章是基于云服務器Ubuntu搭建的,后續會出基于wsl搭建的教程的
安裝 Node.js 和 npm
更新系統包管理器
首先,確保您的系統是最新的。打開終端并運行以下命令:
sudo apt update && sudo apt upgrade -y
如果你出現下面這種情況的話:軟件包之間存在沖突或某些軟件包沒有被正確安裝導致的。你就得輸入下方命令進行嘗試修復系統中的破損包。運行以下命令來修復
sudo apt --fix-broken install
然后再次進行管理包的更新
根據系統環境,使用以下命令安裝 Node.js 和 npm。
sudo apt-get install -f
sudo apt-get install nodejs npm
你如果出現了下方的報錯說明你在安裝 Node.js 時遇到了一些問題,具體是由于文件沖突導致的。錯誤信息顯示 dpkg: error processing
,并且提到 'libnode-dev'
包與 nodejs
包的文件沖突。
刪除現有的 Node.js 和相關依賴
由于存在包沖突,首先我們需要刪除現有的 Node.js 和 libnode-dev
包。
運行以下命令:
sudo apt-get remove --purge nodejs libnode-dev
清理殘留的包
然后執行以下命令清理所有不再需要的包和依賴:
sudo apt-get autoremove -y
sudo apt-get clean
重新安裝 Node.js
清理完成后,您可以再次嘗試安裝最新版本的 Node.js:
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
檢查版本
安裝完成后,再次檢查版本,確保 Node.js 已成功安裝:
node -v
npm -v
輸入命令安裝藍耘 Coding agent
npx lanyuncodingui
但是出現下方報錯命令
報錯顯示
Error: spawn xdg-open ENOENT
...
code: 'ENOENT',
syscall: 'spawn xdg-open',
這表示應用試圖自動用默認瀏覽器打開 http://localhost:3732
,但系統中找不到 xdg-open
命令。
輸入下方命令在 Ubuntu 上安裝 xdg-open
所在的軟件包
sudo apt install -y xdg-utils
藍耘ui界面的配置與安裝
我們輸入命令安裝藍耘 Coding agent
npx lanyuncodingui
這里可以看到我們成功了,在本地的3876端口開放了界面
他這里讓我們要進行賬戶的創建
輸入你的姓名,然后重復輸入兩次密碼就能進行賬戶的創建操作了
創建好了賬戶之后我們就進入到了主界面了
這里我們需要先點擊左上角進行項目文件夾的創建
然后輸入對應的文件路徑就可以進行創建了
我還發現,我這里文件夾創建失敗了,然后本地出現了報錯,有點意思哈,實時監控報錯還是蠻不錯的
這個報錯說我們服務器上面缺少相關的目錄和配置文件
我們需要針對上面的報錯創建必要的目錄和配置文件:
mkdir -p /root/.claude/projects
touch /root/.claude/project-config.json
初始化配置內容(可選但推薦):
打開配置文件:
nano /root/.claude/project-config.json
粘貼以下最基本的配置(如果沒有具體要求):
{"projects": []
}
然后按 Ctrl + O
保存,Ctrl + X
退出。
搞定完成上面的步驟之后我們重新進行項目文件夾的打開
搞定之后我們本地就可以看到文件夾了
這個時候我們就可以開始進行對話操作了
但是我們發了幾句對話消息,沒反應,為什么,因為我們還沒設置api哈哈哈,沒有設置基礎的大模型
我們打開左下角的Tools Settings
進入到設置界面
這里有三個導航欄,第一個導航欄Tools
- Skip permission prompts:勾選后會跳過權限提示(類似命令行
--dangerously-skip-permissions
標識 ),但需謹慎使用,因為可能讓工具在無確認時執行,存在風險。 - Allowed Tools(允許的工具):
可設置無需權限提示、自動允許使用的工具,比如常見的Bash(git log:*)
(允許執行 git log 相關命令)、Write
(寫入操作)等。界面提供快捷添加按鈕,方便快速配置常用工具,若沒配置則顯示 “No allowed tools configured”。 - Disallowed Tools(禁止的工具):
用于設置自動阻止、無需提示的工具,像危險的Bash(rm:*)
(避免誤刪文件的 rm 命令)。沒配置時顯示 “No disallowed tools configured”。 - MCP Servers:可添加 Model Context Protocol 服務器,為 Claude 這類模型提供額外工具和數據源,沒配置時顯示 “No MCP servers configured” 。
我目前除了里面的MCP其他的都使用不到
第二個導航欄里面的Apperance
就是調整當前網頁的外觀的,看你們自己的喜好
第三個導航欄就很重要了,就是設置我們的kimi -k2模型的api的
這里我們需要獲取到api-keys
來到藍耘注冊
官網,進入到MaaS平臺
進行api-keys的創建,創建好了之后復制到我們的claude code ui
界面
來到ui界面,點擊Test Connecting
進行鏈接測試,這里你如果鏈接成功的話,下方會出現successfully的
然后我們就可以開始愉快的使用了
但是我們設置好關鍵配置之后一定得點擊右下角的Save Setting
進行保存設置
claude code安裝
[[#1. 安裝 Node.js 和 npm]]這里我們需要先將nodejs和npm環境配置好
終端先輸入命令進行提權,如果不進行提權操作的話是會出現一系列的報錯的
sudo -i
然后輸入命令將claude code
安裝到服務器中,這里會檢查我們的nodejs的版本,如果太低了的話是不行的
bash -c "$(curl -fsSL https://raw.githubusercontent.com/LanyunAI-labs/lanyun-cc/main/install.sh)"
這里我們需要在藍耘官網獲取下api-key,然后粘貼到這里,相當于將信息放到了環境變量里面了,不用我們每次都去官網復制粘貼,這個就減輕了負擔了
然后模型的話我們就默認使用k2了,直接回車就行了
然后我們需要輸入命令進行claude code
的激活操作
source /root/.bashrc
然后就可以直接輸入命令進行claude code
的使用了
claude
然后他就檢測到了我們之前往環境變量中輸入的api-key的信息,我們這里選擇Yes
然后他會詢問我們是否信任當前文件夾中的內容,我們選擇Yes,proceed
然后我們就可以開始愉快的使用了
這里我們可以在對話框中進行對話操作了哦
如果你想通過claude code針對一個項目進行操作的話,你得進行初始化操作
/init
除了初始化還有很多的功能
如果你想退出的話直接ctrl c就行了,退出界面這里會詳細介紹到具體的api耗費情況
并且我們的網頁是可以監控到具體的耗費情況的
以上都是基于命令行的提問操作的,對于新手小白可能不友好,甚至有時候大佬都覺得挺麻煩的,所以我們藍耘開發了可視化ui界面,[[#藍耘ui界面的配置與安裝]]這里我們已經介紹了如何進行可視化界面的安裝操作
輸入命令啟動下ui界面
npx lanyuncodingui
如果你出現下面的情況
這種情況通常是主機權限問題,我們可以使用管理員權限進行安裝:sudo npm install -g lanyuncodingui@latest ,執行后稍等片刻,這次我們看到安裝成功了:
然后輸入命令直接啟動ui界面
lanyuncodingui
這里我們點擊在瀏覽器中打開
輸入信息登錄即可,如果是第一次打開的話會讓你創建用戶的,設置相關密碼信息的
在可視化界面,可以看到歷史信息
并且再次打開我們的Settings
界面是可以看到我們的api相關的信息是已經被保存好了的,不用二次進行設置了的
在左側打開終端中的文件夾,然后在這里進行可視化對話,讓ai生成對應的文件,真的很方便。
并且我們也不用打開vscode
我們直接在這個可視化ui界面進行項目代碼的設計,終端界面應有盡有,
文件可視化全面,偉大無需多言
并且這里可以和git倉庫進行關聯的,這里我沒有進行關聯,如果必要的話可以進行關聯下的,然后代碼寫好了直接進行提交操作
藍耘元生代8月福利:新人專享與限量優惠雙加持
🔹新用戶注冊:
20元算力代金券+千萬Token資源包
🔹限量福利:
超值滿減券最高減200
每周登錄領10元算力
充值限時1折禮遇
https://mp.weixin.qq.com/s/mqeC7AIAmBs9BBSeMN4jXQ?scene=1
總結
無論你選擇功能豐富的 lanyuncodingui 圖形化界面,還是高效簡潔的 claude 命令行工具,藍耘 Coding 都為現代開發者提供了一套強大的 AI 輔助解決方案。它不僅能幫你生成代碼、修復錯誤,還能成為你項目開發中最得力的伙伴。
在這個 AI 浪潮席卷而來的時代,擁抱變化、善用工具,是每一位開發者保持核心競爭力的關鍵。現在就動手配置你的藍耘 Coding 環境,親身體驗編程效率的飛躍吧!
https://console.lanyun.net/#/register?promoterCode=0131