abc小站

2026-08-31

Claude Code:打开终端,把仓库交出去

不是补全下一行。是进仓库、读文件、跑命令、改完再测。Anthropic 把这套东西叫 Claude Code,装在终端里。

官方定义很短:读代码库、改文件、跑命令,接到你现有的开发工具上。入口不只终端。还有 VS Code 和 Cursor 插件、JetBrains 插件、桌面应用、浏览器里的 claude.ai/code。底下是同一套引擎。仓库根目录的 CLAUDE.md、MCP、设置,换入口还在。

先装,再进目录

macOS、Linux、WSL,官方推荐原生安装:

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

Windows 走 PowerShell:irm https://claude.ai/install.ps1 | iex。Homebrew 是 brew install --cask claude-code,不自动升级,要自己 brew upgrade claude-code。原生安装会在后台更新。装完用 claude --version 看一眼,后面会跟 (Claude Code)

进项目目录,敲 claude。第一次要登录。Pro / Max / Team / Enterprise 都行,也可以用 Claude Console 的预付费额度。已经设了 ANTHROPIC_API_KEY 的,会跳过登录,改成让你确认这把钥匙。以后换账号,会话里打 /login

进去先问「这个项目干什么」「入口在哪」「用了哪些技术」。它自己搜文件,不用你先贴上下文。文档给的第一件真活也很直:

claude "write tests for the auth module, run them, and fix any failures"

只跑一句就退出,加 -p。接着上次:claude -c。会话里 /help 列命令,/clear 清空。

它怎么干活

官方把回合拆成三段:收集上下文、动手、核对结果。修一个 bug,这三段会转好几圈。你随时能插话。按 Esc 立刻停;直接打一行纠正,它做完当前这一步再改方向。

工具分五类:读改文件、按模式搜索、跑 shell / git / 测试、上网查文档、以及装了代码智能插件之后看类型错误。你说「把失败的测试修好」,它可能先跑测试、读报错、找源文件、改、再跑一遍。每一步的输出喂给下一步。这就是它所谓的 agentic loop。

开场它能碰到:当前目录和子目录、你终端里能跑的命令、当前分支和未提交改动、根目录的 CLAUDE.md、以及它自己记下的偏好。这和只看见当前文件的补全插件不是一类东西。

会话存在本机 ~/.claude/projects/ 的 JSONL 里。改文件前会给受影响的文件做快照。按两次 Esc 能回到上一态。快照只管文件,不管数据库、接口、部署。那些要靠权限模式挡。

两件要先设的东西

第一件:CLAUDE.md。放在项目根。每次开场它会读。写编码习惯、架构决定、该用哪套库、评审清单。上下文满了会自动压缩,早先说的细则容易丢。要长期生效的规则,写进这个文件。会话里跑 /init 会带着你建一份。/doctor 检查安装和配置。

第二件:权限。交互式终端里,Pro / Max / Team 默认 Auto:分类器在后台拦风险操作,多数改文件、跑命令不再逐条问你。其他套餐默认 Manual。随时 Shift+Tab 切换。还有 Accept edits 和 Plan。Plan 只探路、出方案,不动源码。信任的命令可以写进 .claude/settings.json,例如测试或 git status

Git 也是说话。commit my changes with a descriptive message 它会暂存、写说明。也可以让它开分支、处理合并冲突。CI 里可以用 GitHub Actions 或 GitLab 做评审和分捡 issue。

模型用 /model 换。文档的口径是:日常写代码用 Sonnet;架构判断用 Opus。别一上来把整仓重构甩给它。任务写具体,复杂事先拆步,先让它把代码摸清再动手。权限先用 Manual 跑两天,再决定要不要 Auto。

材料来自 Anthropic 文档:OverviewQuickstartHow Claude Code works,以及产品页 claude.com/product/claude-code。安装命令、权限模式、CLAUDE.md 行为以文档为准。本文不写价格。