AI 原生开放教材

外观

Claude Code & OpenClaw & Codex & WorkBuddy 中文教程课时教程·中文原文 ↗原件 ↓仓库 ↗

第6.5部分：Claude Code启动方式详解 ​

💡 本节重点：掌握2种启动Claude Code的方式，理解权限参数的作用

6.5.1 启动方式概览 ​

Claude Code有2种启动方式：

启动方式适用场景优点缺点
终端命令启动独立使用Claude Code快速、灵活、支持参数需要记命令
IDE扩展启动在编辑器内使用可视化、方便需要安装扩展

💡 推荐：初学者先学终端启动，掌握后再用IDE扩展（更灵活）

6.5.2 方式一：终端命令启动（基础必学） ​

这是什么？ 在命令行（终端）里输入 claude 命令，直接启动Claude Code的对话界面。

为什么要学这个？

  • ✅ 最基础的启动方式，适用所有场景
  • ✅ 可以添加参数控制行为
  • ✅ 支持脚本自动化

基础启动命令 ​

最简单的启动方式：

bash
# 在任意目录下运行
claude

运行后会看到：

╭─────────────────────────────────────────────────────────╮
│                                                         │
│  Welcome to Claude Code v2.1                           │
│                                                         │
│  • Type /help to see available commands                │
│  • Use /exit to quit                                    │
╰─────────────────────────────────────────────────────────╯

Claude Code v2.1.92
Working directory: /你的当前目录

You: █

看到这个界面 → ✅ 启动成功！

带参数的启动命令 ​

常用启动参数：

参数作用什么时候用
claude默认启动（会询问权限）日常使用
claude --dangerously-skip-permissions跳过权限询问信任的项目，快速开发
claude -p "你的问题"直接提问模式快速查询，不需要对话
claude --headless无界面模式脚本自动化

--dangerously-skip-permissions 详解（重要！） ​

这是什么？ 这个参数会让Claude Code跳过权限询问，直接执行所有操作（读文件、写文件、运行命令）。Anthropic官方称之为**"Safe YOLO mode"**（You Only Live Once模式）。

为什么叫"dangerously"（危险）？

因为Claude Code是AI助手，它可能会：

  • 修改你的代码文件
  • 删除文件
  • 运行系统命令
  • 安装/卸载软件包

如果跳过权限询问，AI做错了你可能来不及阻止！

风险参考（社区案例）：

⚠️ 风险数据：

  • 相当比例的开发者使用此参数时遇到过文件误修改
  • 少数案例涉及数据损失或损坏

数据来源：https://www.ksred.com/claude-code-dangerously-skip-permissions

生活类比：

  • 不加参数 = 保姆做事前都问你"这样行吗？"（安全）
  • 加这个参数 = 保姆直接干，不问你（快但危险）

什么时候该用？

✅ 推荐使用场景：

  • 你自己的个人项目（信任的代码）
  • 快速开发，频繁修改（避免反复确认）
  • 只读操作（查询、分析，不修改代码）
  • 你已经很熟悉Claude Code的行为

❌ 绝对不要用：

  • 公司项目、开源项目（不是你一个人的代码）
  • 第一次用Claude Code（还不了解它会干什么）
  • 生产环境代码（一个错误可能造成事故）
  • 包含敏感数据的项目（财务、用户隐私）

安全使用建议（Anthropic官方）：

  1. 容器隔离：在Docker容器中使用（无网络访问）
  2. 白名单限制：配置 .claude/settings.json（权限通过 permissions.allow 管理，详见 官方权限文档）
    json
    {
  "permissions": {
    "allow": [
      "Read",
      "Grep",
      "Glob",
      "Bash(npm test)",
      "Bash(git status)"
    ]
  }
}
  3. Git保护：确保代码已提交，随时可回滚

使用示例：

bash
# ✅ 场景1：只读查询（安全）
claude --dangerously-skip-permissions -p "分析这个项目的依赖关系"

# ⚠️ 场景2：信任的个人项目（谨慎）
cd ~/my-toy-project
claude --dangerously-skip-permissions

# ❌ 场景3：公司项目（绝对不要）
cd ~/company-critical-project
claude --dangerously-skip-permissions  # 💀 别这么干！

⚠️ 重要建议：

新手阶段（前1个月）：绝对不要加这个参数！让AI每次操作都问你，你能学到它在做什么，还能避免误操作。

熟练阶段（1个月后）：自己的学习项目可以加，但：

  • ✅ 代码先提交到Git
  • ✅ 不包含重要数据
  • ✅ 随时能删重来

专业阶段：公司项目、开源项目永远别加！社区已记录用此参数把项目搞坏的案例，来源（32%误修改率）！

参考：

启动验证清单 ​

启动成功后，确认以下内容：

□ 看到Claude Code的欢迎界面
□ 显示正确的工作目录路径
□ 显示版本号（v2.1+）
□ 能看到 "You: █" 光标闪烁
□ 输入 /help 能看到帮助信息

全部打勾 → 🎉 启动成功！

6.5.3 方式二：IDE扩展启动（进阶） ​

这是什么？ 在VS Code或Cursor编辑器内安装扩展/插件，通过点击按钮或快捷键启动Claude Code，不用手敲命令。

为什么要用这个方式？

  • ✅ 可视化界面，更直观
  • ✅ 和编辑器深度集成
  • ✅ 不用切换窗口

适用工具：

  • VS Code（需要安装Claude Code扩展）
  • Cursor（可以通过Tasks集成，见第7章）

VS Code扩展安装（官方扩展已发布） ​

✅ 2026年2月最新：Claude Code官方VS Code扩展已正式发布（Beta版）！

扩展信息：

安装步骤：

  1. 打开扩展市场

    • 按 Ctrl/Cmd + Shift + X

  2. 搜索并安装

    • 搜索：Claude Code
    • 找到Anthropic官方扩展
    • 点击"Install"

  3. 验证安装

    • 左侧活动栏出现 ⚡火花图标
    • 点击图标打开Claude Code面板

扩展功能（vs 终端CLI）：

  • ✅ 侧边栏专用面板（代码和对话分离）
  • ✅ 实时内联差异显示（修改高亮）
  • ✅ Checkpoint自动保存（按Esc两次回滚）
  • ✅ @提及文件/函数（智能引用）

参考文档：https://code.claude.com/docs/en/vs-code

Cursor集成方式（需要手动安装） ​

重要提示：Cursor虽然基于VS Code，但Claude Code扩展不能自动检测Cursor为兼容IDE。

解决方案（社区验证通常能成功）：手动安装VSIX文件

步骤：

  1. 找到VSIX文件

    • 位置：本地Claude Code安装目录
    • 或从VS Code Marketplace下载VSIX

  2. 手动安装到Cursor

    bash
    # 方法1：命令行安装
cursor --install-extension /path/to/claude-code.vsix

# 方法2：拖拽安装
# 把VSIX文件拖到Cursor的扩展面板

  3. 验证安装

    • 重启Cursor
    • 左侧应出现Claude Code图标

详细教程：https://www.cursor-ide.com/blog/claude-code-cursor-extension-guide

替代方案：Tasks集成（推荐新手）

如果扩展安装失败，可以用Tasks方式（见第7.1节配置）：

  1. 配置 tasks.json
  2. 通过命令面板运行任务
  3. 效果类似但更稳定

6.5.4 启动方式选择建议 ​

你的情况推荐方式原因
刚开始学习终端命令启动理解基础，灵活
熟悉后日常使用终端 + IDE快捷键效率最高
只想快速体验终端命令启动最简单
需要自动化终端 + 参数支持脚本

老金的建议： 先用终端命令启动，等你熟悉了Claude Code的行为，再配置IDE快捷键。这样基础扎实，以后遇到问题好排查！

6.6 Hello World 快速验证 ​

💡 重要：启动成功后，立即做这个快速验证，确保Claude Code能正常工作！这样后面配置IDE时心里有底。

6.6.1 基础功能测试（5分钟） ​

快速7项测试，确认核心功能正常：

bash
# 测试1：版本检查
claude --version
# 预期输出：Claude Code v2.1.x (native)

# 测试2：简单问答
claude -p "What is 2 + 2?"
# 预期输出：4

# 测试3：中文支持
claude -p "你好,请用一句话介绍你自己"
# 预期输出：中文回复（确认中文正常）

# 测试4：帮助命令
claude --help
# 预期输出：显示所有可用命令

如果以上4项全部成功 → ✅ Claude Code工作正常，继续往下！

如果有失败 → ⚠️ 跳到第8部分故障排查

6.6.2 Hello World 项目实战（15分钟） ​

这是什么？ 创建一个完整的小项目，测试Claude Code的文件操作、代码生成、测试生成等核心功能。

为什么要做？ 快速测试能发现大多数配置问题，避免后续出错。

操作步骤：

bash
# 步骤1：创建项目目录
mkdir ~/claude-hello-world
cd ~/claude-hello-world

# 步骤2：初始化Git仓库
git init

# 步骤3：让Claude创建项目结构
claude -p "请创建一个Python Hello World项目，包含：
1. hello.py - 打印 'Hello, Claude Code!'
2. README.md - 项目说明
3. .gitignore - Python标准忽略文件"

# 步骤4：验证文件是否创建
ls -la
# 预期看到：hello.py, README.md, .gitignore

# 步骤5：运行程序
python hello.py
# 预期输出：Hello, Claude Code!

预期项目结构：

claude-hello-world/
├── .git/
├── .gitignore
├── hello.py
└── README.md

验证成功标志：

  • ✅ 文件自动创建成功
  • ✅ Python程序能正常运行
  • ✅ Claude理解你的中文指令

6.6.3 完整验证清单 ​

启动和验证都成功后，最后确认：

验证项命令预期结果状态
版本信息claude --versionv2.1.x+ (native)[ ]
帮助文档claude --help显示命令列表[ ]
API Keyecho $ANTHROPIC_API_KEY显示完整Key[ ]
网络连通ping api.anthropic.com有响应[ ]
文件操作Hello World项目成功创建文件[ ]
代码执行python hello.py正常输出[ ]

全部打勾 → Claude Code 安装和配置成功。

现在你可以：

  • ✅ 继续学习第7部分（IDE集成配置）
  • ✅ 跳过第7部分，直接开始用Claude Code写项目
  • ✅ 查看第9部分FAQ了解更多技巧