启动参数看官方文档启动时自动连接到可用IDESyntax--ide示例claude --ide全网调研整理典型场景从外部终端(非 IDE 内置终端)启动 claude 时,自动连接到已运行的 VS Code / JetBrains 插件需要让终端 diff 直接在 IDE 原生 Diff Viewer 中展示,而非 terminal 内渲染希望 Claude 自动获取 IDE 当前光标选区和打开文件作为上下文在脚本或自动化流程中启动 claude 且同时需要 IDE 集成能力多项目切换时,每次从项目根目录打开外部终端后快速挂接 IDE实用技巧在 IDE 内置终端(VS Code / JetBrains)中运行 claude 时默认已自动连接,无需 --ide,可省略在 shell profile(~/.zshrc 等)中设置 CLAUDE_CODE_AUTO_CONNECT_IDE=1 可永久省去手动加 --ide同时运行多个 IDE 时,用 /ide 交互命令可弹出选择器精确选择要挂接的实例,比 --ide 更可控连接成功后,Claude 可通过 mcp__ide__getDiagnostics 直接读取 IDE Problems 面板的报错,无需手动粘贴IDE 连接通过本地 MCP server(~/.claude/ide/ 下的随机端口+token)实现,重启 IDE 后需重新连接或重启 claude常见坑若没有已运行且安装了 Claude Code 插件的 IDE 实例,--ide 静默无效,不会报错在 IDE 内置终端中使用 --ide 等同于重复操作,因为此场景已默认自动连接设置 CLAUDE_CODE_AUTO_CONNECT_IDE=0 可显式禁用自动连接,--ide 依然会覆盖此变量并尝试连接来源Use Claude Code in VS Code - Claude Code DocsIDE Integration - Claude Code (Mintlify mirror)Claude Code CLI Cheatsheet - Shipyard将 Claude Code 添加到您的 IDE - claude-cn.org 中文镜像站IDE Integration: VS Code, JetBrains, and Beyond - Developer Toolkit最早记录ⓘ≤v2.1.169最近更新v2.1.169变化次数1改进 1变化时间线(按版本倒序)改进v2.1.169· 2026/06/09 · 2026/06/09背景会话现在在 retire→wake 和 respawn 过程中保留此参数上一个--help回到命令字典下一个--include-partial-messages