管理预案

VIBE 模块运维操作与常见管理任务。

服务管理

BASH 
systemctl status code-server
systemctl restart code-server
systemctl status jupyter
systemctl restart jupyter

查看日志：

BASH 
journalctl -u code-server -f
journalctl -u jupyter -f

工作目录与上下文

vibe_dir 会在 vibe_data 下创建：

  • AGENTS.md：由角色模板渲染的上下文文件
  • CLAUDE.md：指向 AGENTS.md 的符号链接

默认位置（可由 vibe_data 调整）：

TEXT 
/fs/CLAUDE.md
/fs/AGENTS.md

密码与认证

Code-Server

修改配置：

BASH 
vi /data/code/code-server/config.yaml
systemctl restart code-server

或通过 Ansible：

BASH 
./vibe.yml -l <host> -e code_password='NewPassword' -t code_config,code_launch

JupyterLab

配置文件位置：/data/jupyter/jupyter_config.py

字段：c.IdentityProvider.token。

BASH 
vi /data/jupyter/jupyter_config.py
systemctl restart jupyter

Code-Server 扩展

BASH 
code-server --install-extension ms-python.python
code-server --list-extensions
code-server --uninstall-extension ms-python.python

切换扩展市场：

YAML 
code_gallery: microsoft

重新部署：

BASH 
./vibe.yml -l <host> -t code_config,code_launch

JupyterLab 环境管理

VIBE 不会自动创建 venv，请确保 jupyter_venv 存在：

BASH 
uv venv /data/venv

安装/更新 JupyterLab：

BASH 
uv pip install --python /data/venv/bin/python jupyterlab ipykernel
systemctl restart jupyter

安装扩展（以 venv 为准）：

BASH 
source /data/venv/bin/activate
pip install jupyterlab-git
systemctl restart jupyter

Claude Code

claude_install 子任务安装 Claude CLI，claude_config 子任务写入配置文件。

BASH 
which claude
claude --version

配置文件：

  • ~/.claude.json
  • ~/.claude/settings.json

更新配置：

BASH 
./vibe.yml -l <host> -t claude_config

重装/补装 Claude CLI：

BASH 
./vibe.yml -l <host> -t claude_install
# 或手工安装
npm install -g @anthropic-ai/claude-code

需要使用其他 npm 包时，可覆盖 claude_package。

Codex CLI

VIBE 通过 codex_install 安装 @openai/codex，但不托管 Codex 配置：

BASH 
which codex
codex --version
./vibe.yml -l <host> -t codex_install

如果需要配置到其他用户，请使用对应的远程登录用户执行或手动拷贝配置文件。

文件位置速查

组件关键文件
Code-Server/data/code/code-server/config.yaml
Code-Server/etc/default/code
Code-Server/etc/systemd/system/code-server.service
JupyterLab/data/jupyter/jupyter_config.py
JupyterLab/etc/default/jupyter
JupyterLab/etc/systemd/system/jupyter.service
Claude Code~/.claude.json / ~/.claude/settings.json

故障排查

端口检查：

BASH 
ss -tlnp | grep 8443
ss -tlnp | grep 8888

Nginx 入口：

BASH 
nginx -t
systemctl status nginx

最后修改 2026-08-09 · docs: normalize Markdown formatting (0813202a)