自学教程

Claude Code 第一次使用

本章带你完成 Claude Code 的首次启动、安全确认、初次对话实战,了解基础操作与新手注意事项。阅读本章前,请先完成 Claude Code 的安装。

一、准备工作

  1. 准备一个空项目目录或者简单的小型项目,不要直接在重要业务项目首次测试。
  2. 打开终端,进入项目文件夹。
# 创建测试目录并进入
mkdir claude-demo-runoops && cd claude-demo-runoops

二、启动 Claude Code

在项目目录终端输入:

claude

首次启动流程

  1. 主题选择:第一次运行会提示选择终端显示主题,预览效果后选择喜欢的样式。后续可以使用 /theme 命令重新切换。
  2. 安全提示与目录信任确认 重要:Claude Code 可以读写当前目录文件、执行终端命令。
    • Yes, I trust this folder:信任该目录,允许读写文件、执行命令(仅在你自己的测试项目选择)
    • No, exit:不信任,直接退出
  3. 账号登录
    • 网页登录:自动打开浏览器,登录 Claude 账号
    • 若已经配置 ANTHROPIC_API_KEY(DeepSeek 或 Anthropic API),会自动跳过网页登录

登录成功后,进入交互式对话提示符,就可以输入指令。

三、第一次简单实战(推荐新手任务)

新手建议从小任务开始,不要一次性下达复杂重构需求。

示例指令:

帮我创建一个简单的 hello.js,打印 Hello Claude Code

执行过程:

  1. AI 理解需求,计划新建 hello.js
  2. 执行文件写入操作
  3. 完成后输出结果,告知改动内容

你可以继续输入指令,比如:

运行这个 js 文件,查看输出结果

执行命令前,Claude Code 会提示即将执行的命令,你可以选择允许或拒绝。

四、基础交互操作

常用控制快捷键

  • Esc:随时中断当前任务
  • Enter:发送指令
  • ↑ ↓:翻看历史对话

内置斜杠命令(初次使用最常用)

命令说明
/help查看帮助文档,列出全部可用命令
/theme修改终端主题样式
/clear清空本次会话上下文
/model切换模型(API 自定义模式下不可用)
/init生成 CLAUDE.md 项目规则文件

退出会话

输入 /exit 或者按 Ctrl + C 退出 Claude Code。

五、新手必须知道的安全规则

  1. 只信任你自己可控的项目目录,不要在未知/下载的项目中选择信任文件夹。
  2. AI 修改代码、执行命令前,务必审阅改动内容,AI 会产生幻觉。
  3. 不要交给 Claude Code 高危操作:批量删除文件、修改系统配置等。
  4. 敏感、涉密代码目录,不要启动 Claude Code。

六、常见问题

  1. 启动后弹出浏览器无法打开
    复制终端给出的链接,手动在浏览器打开完成登录。
  2. 提示文件夹安全警告
    这是正常机制,用来防止恶意项目,不确定项目就选择退出。
  3. 无法执行命令
    当前目录未被信任,重新启动并选择信任文件夹。
  4. 对话不生效、报错
    检查网络;如果使用 DeepSeek API,确认环境变量配置正确,新开终端重试。
标签:

0 条笔记