Claude Code 是 Anthropic 出品的终端原生编码 Agent。它读你的项目、改文件、跑命令、搞 git——全程自然语言。本文写作时最新稳定版 v2.1.209（2026-07-14）。本文覆盖 Ubuntu 22.04/24.04 安装、推荐日常用法、以及生产环境最常见的配置套路。
## Ubuntu 22.04 / 24.04 安装
有两条安装路径。多数人用 npm：
“`bash
sudo apt update && sudo apt install -y nodejs npm
sudo npm install -g @anthropic-ai/claude-code
“`
Anthropic 自己也提供一条不依赖 Node 的原生安装路径：
“`bash
curl -fsSL https://claude.ai/install.sh | bash
“`
两种都会把 `claude` 二进制放进 `PATH`。验证：
“`bash
claude –version
claude doctor
“`
`claude doctor` 会检查 API key、网络、跟 npm 上的最新版对比。
**设置 API key**（Anthropic 推荐用 Console 生成的长期 key，不用账单页的）：
“`bash
export ANTHROPIC_API_KEY=”sk-ant-…”
“`
公司代理后面：
“`bash
export HTTPS_PROXY=http://proxy.example.com:8080
export ANTHROPIC_AUTH_TOKEN=”$ANTHROPIC_API_KEY”
“`
## 头三条要会的命令
## 头三条要会的命令
装完，`cd` 进任意项目，跑 Claude Code：
“`bash
cd ~/work/my-app
claude
“`
进交互式 REPL。头三条要学的命令：
– `/init` —— 在项目根生成 `CLAUDE.md` 描述约定、构建 / 测试命令、agent 应该总遵守的规则。每次会话后编辑一下，时间长了这个文件就成了你这个项目的 agent 提示词权威。
– `/review` —— 对当前工作树跑代码审查，原地打建议。提交前用它。
– `/mcp` —— 管 MCP（Model Context Protocol）服务器。只装真用得到的；每个都会让你每回合 prompt cache 多花钱。
退出用 `/exit` 或 `Ctrl+D`。
## 复利最大的 plan-first 工作流
Claude Code 在 2025-2026 年最大的特性是默认 **plan-first**。你提一个非平凡的改动请求，它会先回一份编号清单（要动哪些文件、要跑哪些命令、有什么风险），**碰文件之前**先停在 plan 阶段。你的工作是**读 plan，不是读代码**。
一个有用的纪律：
1. 用一句话说明目标。
2. 读 plan。拒绝范围蔓延（比如「我要的是重构，不是重写」）。
3. 敲回车确认。
4. 跑你自己的真实测试套件——Claude Code 默认不保证通过，**你**是最后一道。
跨多文件、改架构的活儿，先让 Claude Code 写 plan 再一步步跑实现。啰嗦的 trace 就是审计记录。
## 真正起作用的配置
三个文件决定了 90% 日常体验：
– **`~/.claude/settings.json`** —— 全局用户偏好（默认模型、MCP、allowedTools、ticket 信息）
– **`
– **`.claude/commands/`** —— 你自己写的斜杠命令（`/pr`、`/release`、`/incident-postmortem`），写一次反复用
一个面向 Ubuntu 服务项目的 CLAUDE.md 例子：
“`markdown
## Conventions
– Python 3.12+, uv-managed (`uv sync`, `uv run pytest`)
– 公开函数必须带 type hints
– 严禁提交密钥；pre-commit 钩子会扫
## Build & test
– `make build` 出产线二进制
– `make test` 单测 + 集成（含 docker-compose 起数据库）
– `make lint` 格式化 + 类型检查
## Don’t
– 没问之前别升依赖
– 别 push 到 main；用 feature branch + PR
“`
## Claude Code 不替代什么
它**不是** Devin 那种 cloud engineer——它陪你坐在终端里。它不会自己打开编辑器；编辑器内的是 Cursor、Windsurf、Cline 的活儿。它也默认不本地化——API 是 Anthropic 的硬需求，不过想 BYOK 换其他模型可以通过 OpenRouter 这类开源兼容代理。
## 这 20 刀值在哪
如果你大部分时间泡在终端里、所在代码库 Claude 能读（实用上限 ~200K tokens）、并且愿意读 plan 而不是盲签 diff——Claude Code 是当下 AI 工具里杠杆最高的一个订阅。
评论