Claude Code Vim/Neovim终端原生工作流：从键盘到AI的无缝衔接

# 启动Claude Code
claude

# 在Claude Code提示符下输入
/vim

# 进入配置
/config

# 在设置中找到 vim_mode 并设为 true
# 或者直接编辑 ~/.claude/settings.json

{
  "vim_mode": true
}

# 确认Claude Code版本 >= 1.0.25
claude --version

# 更新到最新版
npm update -g @anthropic-ai/claude-code

# 在 ~/.bashrc 或 ~/.zshrc 中设置
export KEYTIMEOUT=1    # zsh用户

Preferences → Profiles → Keys → Key Mappings
找到 Shift+Enter，设置 Action 为 "Send Escape Sequence"
Esc+ 输入：\x1b[13;2u

# ~/.config/kitty/kitty.conf
map shift+enter send_text all \x1b[13;2u

# ~/.config/alacritty/alacritty.yml
keyboard:
  bindings:
    - key: Enter
      mods: Shift
      chars: "\x1b[13;2u"

# ~/.tmux.conf

# Shift+Enter支持（tmux会拦截按键序列）
bind-key -n S-Enter send-keys "\x1b[13;2u"

# 鼠标支持（方便在pane间切换）
set -g mouse on

# 真彩色支持（让Claude Code主题正确渲染）
set -g default-terminal "tmux-256color"
set -ag terminal-overrides ",xterm-256color:RGB"

# 终端铃声（Claude Code任务完成时通知）
set -g bell-action any
set -g visual-bell on

# 快速重载配置
bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"

# 更直观的分屏快捷键
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# 新窗口保持当前路径
bind c new-window -c "#{pane_current_path}"

# 在 ~/.claude/settings.json 中配置
{
  "vim_mode": true,
  "notifications": {
    "enabled": true,
    "sound": true,
    "terminal_bell": true
  }
}

graph TB
    A[Claude Code + Neovim集成] --> B[方案一: 终端内嵌]
    A --> C[方案二: 浮动窗口插件]
    A --> D[方案三: MCP协议直连]

    B --> B1[在Neovim :terminal 中<br>直接运行 claude]
    B --> B2[最简单，零配置]
    B --> B3[适合Vim熟练者]

    C --> C1[claude-code.nvim<br>greggh/claude-code.nvim]
    C --> C2[浮动终端 + Visual选择发送]
    C --> C3[适合日常开发]

    D --> D1[coder/claudecode.nvim<br>WebSocket MCP协议]
    D --> D2[prism.nvim 65+ MCP工具]
    D --> D3[适合深度集成需求]

    style A fill:#4A90D9,color:#fff
    style B fill:#7ED321,color:#fff
    style C fill:#F5A623,color:#fff
    style D fill:#D0021B,color:#fff

" 在Neovim中打开终端
:terminal

" 在终端中启动Claude Code
$ claude

" 切回Normal模式控制终端
" Ctrl+\ Ctrl+N  →  进入Normal模式
" :q  →  关闭终端缓冲区
" i  →  回到终端交互模式

# ~/.claude/skills/neovim-integration/skill.md
---
name: neovim-integration
description: Control Neovim from Claude Code terminal
---

When the user asks to open a file or navigate in the editor, use the following approach:

1. Send Vim commands through the terminal by using special escape sequences
2. For opening files: run `nvim --server /tmp/nvim.sock --remote-file <file>`
3. For running commands: use `nvim --server /tmp/nvim.sock --remote-expr "execute(':<cmd>')"`

Available commands:
- Open file: nvim --server /tmp/nvim.sock --remote-file <path>
- Run Ex command: nvim --server /tmp/nvim.sock --remote-send ":<cmd><CR>"
- Get current file: nvim --server /tmp/nvim.sock --remote-expr "expand('%:p')"
- Get current line: nvim --server /tmp/nvim.sock --remote-expr "getline('.')"

# 启动Neovim时启用服务器Socket
nvim --listen /tmp/nvim.sock

# 或在Neovim内执行
:call serverstart('/tmp/nvim.sock')

-- 在Neovim中执行 :LazyExtras
-- 找到 ai.claudecode 并启用
-- 或者手动添加到 ~/.config/nvim/lua/plugins/claude.lua
return {
  {
    "lazyvim.plugins.extras.ai.claudecode",
  },
}

-- ~/.config/nvim/lua/plugins/claude-code.lua
return {
  {
    "greggh/claude-code.nvim",
    dependencies = {
      "nvim-lua/plenary.nvim",  -- 必需依赖
    },
    config = function()
      require("claude-code").setup({
        -- 终端设置
        window = {
          position = "float",       -- 浮动窗口
          width = 0.8,              -- 宽度占比
          height = 0.8,             -- 高度占比
          border = "rounded",       -- 边框样式
        },
        -- 快捷键
        keymaps = {
          toggle = "<leader>cc",    -- 打开/关闭Claude Code
          send_visual = "<leader>cs", -- 发送Visual选择
          accept_diff = "<leader>ca", -- 接受Diff
          reject_diff = "<leader>cr", -- 拒绝Diff
        },
      })
    end,
  },
}

1. <leader>cc       →  打开Claude Code浮动终端
2. 在Normal模式选中代码段落（V进入行选择，v进入字符选择）
3. <leader>cs       →  将选中代码发送给Claude Code
4. Claude生成Diff后：
   - <leader>ca     →  接受当前Diff
   - <leader>cr     →  拒绝当前Diff
5. <leader>cc       →  关闭浮动终端，回到编辑

-- 在Visual模式下选中一段代码后
-- <leader>cs 会自动在Claude Code中输入：
-- "请分析/修改以下代码：[选中的代码片段]"
-- 光标所在的文件路径会自动作为上下文附加

# 安装prism.nvim
# 方式一：lazy.nvim
{
  "genomewalker/prism.nvim",
  build = "pip install nvim-mcp",
  config = function()
    require("prism").setup({
      tools = {
        enable_all = true,    -- 启用所有65+工具
      },
    })
  end,
}

# 方式二：pip安装MCP服务器
pip install nvim-mcp

// ~/.claude/mcp_servers.json
{
  "prism-neovim": {
    "command": "nvim-mcp",
    "args": ["--socket", "/tmp/nvim.sock"],
    "description": "Neovim editor control via MCP"
  }
}

# 创建专用tmux会话
tmux new-session -s dev -c ~/projects/myapp

# 水平分屏（上下）
Ctrl+b "

# 垂直分屏（左右）
Ctrl+b %

# 典型四窗格布局：
# ┌──────────────┬──────────────┐
# │  Neovim      │  Claude #1   │
# │  (编辑器)     │  (主力开发)   │
# ├──────────────┼──────────────┤
# │  Claude #2   │  测试/构建    │
# │  (代码审查)   │  (自动运行)   │
# └──────────────┴──────────────┘

# 上方pane：管理Agent
claude --system-prompt "你是项目管理Agent，负责审查下方Agent的代码修改并给出指导建议"

# 下方pane：执行Agent
claude

# ~/.claude/settings.json 中配置tmux相关的hooks
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "tmux send-keys -t {session}:0.0 '请审查最新的文件修改' Enter"
      }]
    }]
  }
}

# 安装
pip install claude-tmux

# 启动
claude-tmux

# 提供的功能：
# - 一键创建新的Claude Code会话
# - 会话列表和快速切换
# - 统一的日志查看
# - 批量操作（向所有会话发送命令）

# 在tmux中创建多窗格
tmux new-session -s parallel \; \
  split-window -h \; \
  split-window -v \; \
  select-pane -t 0 \; \
  split-window -v

# 窗格1：主开发
claude --worktree feature-auth

# 窗格2：测试编写
claude --worktree feature-auth-test

# 窗格3：文档更新
claude --worktree feature-auth-docs

# 窗格4：代码审查
claude --worktree feature-auth-review

# 每个Worktree是独立的目录，互不干扰

flowchart LR
    subgraph tmux_session[tmux会话: parallel]
        A[Agent #1<br>功能开发<br>worktree: auth]
        B[Agent #2<br>测试编写<br>worktree: auth-test]
        C[Agent #3<br>文档更新<br>worktree: auth-docs]
        D[Agent #4<br>代码审查<br>worktree: auth-review]
    end

    A -->|代码变更| E[共享远程分支]
    B -->|测试用例| E
    C -->|文档MD| E
    D -->|审查反馈| A

    style A fill:#4A90D9,color:#fff
    style B fill:#7ED321,color:#fff
    style C fill:#F5A623,color:#fff
    style D fill:#D0021B,color:#fff
    style E fill:#9B59B6,color:#fff

#!/bin/bash
# setup-terminal-ai.sh — 一键配置终端AI开发环境

# 1. 确保Claude Code最新版
npm install -g @anthropic-ai/claude-code@latest

# 2. 验证安装
claude --version

# 3. 配置Vim模式
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'SETTINGS'
{
  "vim_mode": true,
  "notifications": {
    "enabled": true,
    "terminal_bell": true
  },
  "theme": "dark"
}
SETTINGS

echo "✅ Claude Code基础配置完成"

-- ~/.config/nvim/lua/plugins/ai-setup.lua
-- 完整的AI编码插件配置

return {
  -- Claude Code浮动终端
  {
    "greggh/claude-code.nvim",
    dependencies = { "nvim-lua/plenary.nvim" },
    config = function()
      require("claude-code").setup({
        window = {
          position = "float",
          width = 0.85,
          height = 0.85,
          border = "rounded",
        },
        keymaps = {
          toggle = "<leader>cc",
          send_visual = "<leader>cs",
          accept_diff = "<leader>ca",
          reject_diff = "<leader>cr",
        },
      })
    end,
  },

  -- 文件变化自动刷新（让Claude的修改即时可见）
  {
    "nvim-lua/autoread.nvim",
    config = function()
      vim.o.autoread = true
      vim.api.nvim_create_autocmd({"FocusGained", "BufEnter"}, {
        pattern = "*",
        command = "checktime",
      })
    end,
  },
}

#!/bin/bash
# start-dev-session.sh — 启动AI开发会话

PROJECT_DIR="${1:-$(pwd)}"
SESSION_NAME="ai-dev-$(basename $PROJECT_DIR)"

# 如果会话已存在，直接附加
tmux has-session -t $SESSION_NAME 2>/dev/null
if [ $? -eq 0 ]; then
  tmux attach-session -t $SESSION_NAME
  exit 0
fi

# 创建新会话
tmux new-session -d -s $SESSION_NAME -c $PROJECT_DIR

# 窗格布局：Neovim + Claude Code + 终端
tmux split-window -h -t $SESSION_NAME -c $PROJECT_DIR
tmux split-window -v -t $SESSION_NAME:0.1 -c $PROJECT_DIR

# 窗格1：Neovim
tmux send-keys -t $SESSION_NAME:0.0 "nvim ." Enter

# 窗格2：Claude Code（主开发）
tmux send-keys -t $SESSION_NAME:0.1 "claude" Enter

# 窗格3：终端（测试/构建）
tmux send-keys -t $SESSION_NAME:0.2 "# 终端命令在此执行" Enter

# 选择Neovim窗格
tmux select-pane -t $SESSION_NAME:0.0

# 附加到会话
tmux attach-session -t $SESSION_NAME

chmod +x start-dev-session.sh
./start-dev-session.sh ~/projects/my-react-app

<!-- ~/.claude/skills/terminal-workflow/skill.md -->
---
name: terminal-workflow
description: Optimize Claude Code for terminal-native Neovim development workflow
---

## 工作流规则

1. **文件修改通知**：每次修改文件后，在输出中包含文件路径和行号范围，方便在Neovim中快速跳转
2. **代码块格式**：输出的代码块始终标注语言类型和文件路径注释
3. **Neovim友好**：建议用 `nvim --server /tmp/nvim.sock --remote-file <path>` 打开文件
4. **tmux协作**：如果需要在其他tmux窗格执行命令，使用 `tmux send-keys -t <target> '<cmd>' Enter`
5. **Shift+Enter多行**：生成的Prompt建议使用多行格式，便于阅读

## 输出格式

修改文件时，始终使用以下格式：

## 快捷操作

- 用户输入 `@check` → 检查当前所有修改文件的LSP错误
- 用户输入 `@test` → 在tmux窗格3中运行测试
- 用户输入 `@review` → 生成当前修改的代码审查摘要

=== 场景：修复React组件中的状态管理Bug ===

Step 1: 在Neovim中打开问题文件
  <leader>cc          →  打开Claude Code浮动终端
  /vim                →  确保Vim模式激活

Step 2: 描述问题
  输入（Vim模式下用i进入Insert）：
  "我在 UserProfile.tsx 中遇到一个问题：用户更新头像后，
  组件没有重新渲染。请帮我分析 useEffect 的依赖数组。"

Step 3: 选中代码发送
  Esc回到Normal → 移到目标代码 → V进入行选择 → 选中相关代码
  <leader>cs    →  发送给Claude Code

Step 4: 审查Diff
  Claude生成修复方案后：
  <leader>ca    →  接受合理的修改
  <leader>cr    →  拒绝不合理的部分

Step 5: 验证修复
  在Claude Code中输入：
  "@test 运行 UserProfile 相关测试"

  Claude自动在tmux窗格3中执行：
  npm test -- --grep "UserProfile"

Step 6: 最终审查
  输入："@review 生成本次修改的审查摘要"
  检查输出 → 确认无误

# 安装neovim-mcp-server
pip install nvim-mcp

# 在 ~/.claude/mcp_servers.json 中配置
cat >> ~/.claude/mcp_servers.json << 'EOF'
{
  "neovim-context": {
    "command": "nvim-mcp",
    "args": ["--socket", "/tmp/nvim.sock"],
    "description": "Provide Neovim editor context to Claude Code"
  }
}
EOF

-- ~/.config/nvim/lua/plugins/claude-snippets.lua
local claude_prompts = {
  fix = "分析以下代码中的Bug并修复，保持向后兼容：",
  refactor = "重构以下代码，提高可读性和性能，不改变外部行为：",
  test = "为以下函数编写单元测试，覆盖正常路径和边界条件：",
  doc = "为以下代码生成文档注释，包括参数说明和返回值：",
  review = "审查以下代码的安全性和最佳实践合规性：",
  perf = "分析以下代码的性能瓶颈并提出优化建议：",
}

-- 注册用户命令
for name, prompt in pairs(claude_prompts) do
  vim.api.nvim_create_user_command("Claude" .. name:sub(1,1):upper() .. name:sub(2), function()
    -- 获取Visual选择
    local start_line = vim.fn.line("'<")
    local end_line = vim.fn.line("'>")
    local lines = vim.fn.getline(start_line, end_line)
    local code = table.concat(lines, "\n")

    -- 发送到Claude Code
    require("claude-code").send(prompt .. "\n```\n" .. code .. "\n```")
  end, { range = true })
end

" 在Visual模式下选中代码
:ClaudeFix       " 修复Bug
:ClaudeRefactor  " 重构
:ClaudeTest      " 生成测试
:ClaudeDoc       " 生成文档
:ClaudeReview    " 代码审查
:ClaudePerf      " 性能分析

# 启用tmux持续会话
# ~/.tmux.conf
set -g destroy-unattached off

# 使用 plugin: tmux-resurrect 保存/恢复会话
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @resurrect-capture-pane-contents 'on'

# 保存：Ctrl+b Ctrl+s
# 恢复：Ctrl+b Ctrl+r

flowchart TD
    Start[选择集成方案] --> Q1{是否需要Neovim<br>与Claude深度交互?}

    Q1 -->|否, 够用就行| S1[方案一: 终端内嵌<br>在Neovim :terminal中运行]
    Q1 -->|是| Q2{需要Claude直接<br>操控Neovim吗?}

    Q2 -->|否, 浮动窗口够用| S2[方案二: claude-code.nvim<br>Visual选择 + Diff管理]
    Q2 -->|是, 深度集成| S3[方案三: prism.nvim<br>65+ MCP工具直连]

    S1 --> Q3{需要多Agent并行?}
    S2 --> Q3
    S3 --> Q3

    Q3 -->|否| Done1[单会话工作流<br>Vim模式 + 单Claude实例]
    Q3 -->|是| Done2[tmux多会话<br>Worktree隔离 + 多Agent编排]

    style Start fill:#4A90D9,color:#fff
    style Done1 fill:#7ED321,color:#fff
    style Done2 fill:#F5A623,color:#fff

# 确保$TERM正确
export TERM=xterm-256color

# Neovim终端中设置
:let &term = 'xterm-256color'

# 只读Agent（用于代码审查）
claude --allowedTools "Read,Glob,Grep,Bash(git *,npm test*)"

# 写入Agent（用于开发）
claude --allowedTools "Read,Write,Edit,Bash"

# ~/.tmux.conf 中取消tmux对Ctrl键的拦截
# 将前缀键改为不常用的组合
unbind C-b
set -g prefix 'C-a'
bind 'C-a' send-prefix

# 检查Socket是否存在
ls -la /tmp/nvim.sock

# 如果不存在，在Neovim中启动
:call serverstart('/tmp/nvim.sock')

# 设置Socket权限
chmod 600 /tmp/nvim.sock