---

服务管理

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

查看日志：

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

---

工作目录与上下文

vibe_dir 会在 vibe_data 下创建：

• CLAUDE.md
• AGENTS.md（指向 CLAUDE.md 的符号链接）

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

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

---

密码与认证

Code-Server

修改配置：

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

或通过 Ansible：

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

JupyterLab

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

字段：c.IdentityProvider.token。

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

---

Code-Server 扩展

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

切换扩展市场：

code_gallery: microsoft

重新部署：

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

---

JupyterLab 环境管理

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

uv venv /data/venv

安装/更新 JupyterLab：

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

安装扩展（以 venv 为准）：

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

---

Claude Code

claude_config 子任务仅写入配置文件。 Claude CLI 默认由 nodejs_pkg 根据 npm_packages 全局安装（默认包含 @anthropic-ai/claude-code）。

which claude
claude --version

配置文件：

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

更新配置：

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

重装/补装 Claude CLI：

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

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

---

文件位置速查

组件	关键文件
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

---

故障排查

端口检查：

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

Nginx 入口：

nginx -t
systemctl status nginx