工具大全
AI 教程作者:Coocon2026年3月29日298 次阅读约 3 分钟阅读

Claude Code 快速上手指南:你的第一次实战会话

Claude Code 是 Anthropic 推出的终端式编程助手。想快速看到效果,不需要先把所有命令背下来。更有效的方式是先完成一次干净的首次会话,让 Claude 先读懂代码库,再去执行一个明确的改动任务。

Anthropic 的快速上手与概览文档给出的路径很直接:安装 CLI、使用 Claude.ai 或 Anthropic Console 账号登录、进入项目目录,然后运行 claude 开始会话。之后,Claude 可以帮助你理解代码库、提出修改方案、运行测试,并在同一个对话里继续推进。

开始前准备什么

在打开 Claude Code 之前,先准备好下面几项:

  1. 一个可用的终端窗口
  2. 一个真实的项目仓库
  3. Claude.ai 或 Anthropic Console 账号
  4. 如果打算用 npm 安装,需要 Node.js 18 或更高版本

这些就够了。第一次体验不需要复杂的配置流程,也不需要先准备额外的项目模板。

安装并启动 Claude Code

Anthropic 文档提供了两种安装方式:

npm install -g @anthropic-ai/claude-code

或者使用新的原生安装方式:

curl -fsSL claude.ai/install.sh | bash

安装完成后,进入项目目录并启动:

cd /path/to/your/project
claude

如果需要登录,Claude 会在会话中提示你完成认证。认证成功后,就可以直接开始使用。

先问代码库本身的问题

第一次提问最好是“描述性”的,而不是直接要求修改。可以先问 Claude:

  • 这个项目是做什么的?
  • 主入口文件在哪里?
  • 这个仓库用了哪些技术栈?
  • 请解释一下文件夹结构

这样做的好处是让 Claude 先读取项目上下文,再进入修改阶段。它会更像一个同事,而不是只能靠猜测回答的工具。

做第一次修改

等 Claude 理解了代码库,再给它一个具体任务:

这里有一个 bug:用户可以提交空表单。请找出原因并修复。

Anthropic 对典型工作流的描述很清楚:Claude 会定位相关代码、理解上下文、实现修复,并在可用时运行测试。这就是你应该建立的使用预期。

用后续追问控制节奏

Claude Code 最适合“边做边调整”:

  • 大改动前先让它列计划
  • 对风险较高的改动要求先解释
  • 输出范围太大时让它收缩
  • 让它用测试或更小的复现来验证结果

第一周真正要养成的习惯,不是立刻得到完美答案,而是把工作拆成可检查的小步骤。

常用命令

Anthropic 的快速上手文档里列了几个最常用的命令:

claude
claude "fix the build error"
claude -p "explain this function"
claude -c
claude -r

在会话中,/help 可以查看命令列表,/clear 可以重置对话历史,方便重新开始。

第一次会话检查清单

建议按下面的顺序尝试:

  1. 安装 CLI
  2. 登录
  3. 打开一个真实项目
  4. 让 Claude 解释仓库
  5. 交给它一个小而明确的任务
  6. 先审查结果,再决定是否扩大范围

这个流程刻意保持简单,就是为了让你先了解 Claude 在你的环境里是怎么工作的,再逐步把它用到更大的改动中。

官方参考资料

以上资料检索于 2026年3月29日。功能可用性、套餐限制和界面细节可能会变化,发布前请以链接中的 Anthropic 官方资料为准。

相关文章

Claude Code 禁止 rm -rf 怎么配:deny 规则两周拦下 14 次,实测还有 7 种写法照样能删,一个 hook 补齐

为了防 Claude Code 误删文件,我在全局 settings 里加了一条 deny 规则 Bash(rm -rf *)。翻本机 10 月 7 日到 21 日的会话记录:这条规则拦下 14 次删除,模型被拒后 8 次换新目录名、6 次直接放弃删除,一次都没换写法绕过。但在 Claude Code 2.1.285 上用 stub 逐字回放 22 种删除写法后发现:rm -fr、rm -r -f、rm -Rf、rm -r 在手动、auto、bypass 三种模式下都照删不误,/bin/rm、find -delete、bash -c 在手动和 bypass 模式下也能删。auto 模式下,工作目录内的 rm -fr 会被当成「acceptEdits 也会放行」的操作,连分类器都不过。另一道闸是内置的 dangerous-rm 检查,目标是 $D/* 这类变量展开时触发,bypass 模式也拦;多行命令里前面有 heredoc,它就跟不上同一条命令里的变量赋值。文末给出一个 PreToolUse hook,三种模式下补齐全部递归删除写法,并告诉模型被拒后该怎么做。

claude-codehooks+5
pitfalls2026年10月21日7 min
208

Claude Code 接 DeepSeek / GLM / Kimi 开 auto 模式:temporarily unavailable 括号里的原因怎么看,哪些重试没用(故障注入实测)

用第三方模型跑 Claude Code auto 模式,每个有副作用的动作都会用你的会话模型向同一个后端多发一次判定请求:系统提示词 132,470 字符,单次约 2.97 万输入 token,比主循环那一步还多。判定请求一失败,就出现「xxx is temporarily unavailable, so auto mode cannot determine the safety of Bash」。本文用故障注入代理把每种失败对应的报错原文测了一遍:500 → (server error)、429 → (rate-limited)、529 → (overloaded)、断连 → (connection failed),这几种会自动重试 5 次;超过 60 秒没回 → (timed out);**没有括号 = 后端拒收(4xx),只试 1 次,重试多少遍都一样**;后端回了但模型没给判定 → could not evaluate,连续 3 次就退回人工确认。另外实测 CLAUDE_CODE_AUTO_MODE_MODEL 不生效,判定器只能跟着会话模型换。Claude Code 2.1.285,真实后端 DeepSeek v4-pro 与小米 MiMo v2.5。

claude-codedeepseek+7
pitfalls2026年10月11日11 min
643

Claude Code 上下文太长怎么办:Prompt is too long 会自动压缩,中转站 / DeepSeek 的 maximum context length 却不会(实测)

Claude Code 靠报错文案判断「上下文太长」:后端说 prompt is too long 或 input is too long for requested model,它会自动压缩对话后重发,用户无感;DeepSeek 和 OpenAI 风格中转返回的 This model's maximum context length is …,它不认识,直接报 API Error: 400,每轮都失败。手动 /compact 有效;更好的办法是用 CLAUDE_CODE_MAX_CONTEXT_TOKENS(非 claude- 模型 ID)或 CLAUDE_CODE_AUTO_COMPACT_WINDOW(claude- 模型 ID)告诉它真实上限,让它提前压缩。Claude Code 2.1.285 + 本地 stub 实测。

claude-codedeepseek+6
pitfalls2026年10月5日8 min
726

Claude Code 一直卡住、转圈没反应怎么办:后端不回时它要等 6 分钟,重试满 10 次可能卡一个多小时(实测)

Claude Code 转圈不动、或者停在 Retrying in 0s,多半是后端没有回数据。实测 2.1.285(API key + ANTHROPIC_BASE_URL):后端不回响应头时每次等 6 分钟(360 秒)才判超时,把 API_TIMEOUT_MS 调到 60 万、90 万也不变,只能调小;默认重试 10 次,总共可能卡一个多小时。中转站如果把回复缓冲到生成完才返回,超过 6 分钟的回复永远拿不到。按 Esc 可以随时中断。全部在本地 stub 上实测。

claude-code中转站+6
pitfalls2026年10月5日10 min
649