Claude Code 是什么
Claude Code 不只是终端聊天框。它会在你允许的范围内搜索代码、编辑文件、运行测试、查看 Git 差异， 也能通过 MCP 连接外部系统。它既可在终端使用，也有桌面端、IDE 和 Web 等入口；本文聚焦最容易理解和复现的终端流程。
一、按当前官方方式安装
官方当前优先推荐原生安装。macOS、Linux 和 WSL 可运行：
curl -fsSL https://claude.ai/install.sh | bash
# 安装后检查
claude --version
claude doctormacOS 也可用 Homebrew；Windows 可用 WinGet：
# macOS stable channel
brew install --cask claude-code
# Windows
winget install Anthropic.ClaudeCode原生安装会在后台自动更新；包管理器安装通常需要手动升级。官方列出的基础要求包括受支持的操作系统、 4 GB 以上内存、x64 或 ARM64 处理器和网络连接。企业或受限网络还要先核对代理和域名策略。
二、首次登录与第一个会话
cd /path/to/your-project
claude首次启动会引导认证。当前官方支持 Claude Pro、Max、Team、Enterprise、Console 账户，也支持部分第三方云平台。 不要把订阅套餐和 API 计费混为一谈：使用哪种认证，取决于你的组织、账户和成本归属。
第一个提示词不要直接要求“大改项目”，先建立共同上下文：
请先只读探索这个仓库，不要修改文件。
说明：
1. 应用入口和主要目录
2. 本地启动、测试、构建命令
3. 数据流和关键依赖
4. 你还不确定的地方这一步能暴露错误假设。确认后再给一个能在短时间内验证的任务，例如修复一个有复现步骤的 Bug、补一个测试， 或为现有接口增加输入校验。
三、理解权限：提示词不是安全边界
| 机制 | 用途 | 入门建议 |
|---|---|---|
default | 首次使用工具时询问 | 新手默认选择 |
plan | 以读取、分析和计划为主，不直接改源码 | 接手陌生仓库时先用 |
acceptEdits | 自动接受工作区内编辑和部分文件命令 | 熟悉项目后再开 |
dontAsk | 未预先允许的工具直接拒绝 | 适合严格白名单 |
bypassPermissions | 跳过大多数权限提示 | 只在隔离容器或 VM 中考虑 |
用 /permissions 查看规则来源。规则按 deny → ask → allow 评估；deny 优先。 与其把“不要读取 .env”写进提示词，不如用客户端规则强制限制：
// .claude/settings.json
{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
],
"ask": ["Bash(git push *)"]
}
}四、CLAUDE.md：给项目写一份“工作说明”
项目根目录的 CLAUDE.md 或 .claude/CLAUDE.md 用来记录 Claude 每次工作都应知道的事实。 用户级 ~/.claude/CLAUDE.md 可放跨项目偏好；个人且不提交 Git 的项目说明可放 CLAUDE.local.md。
# Project instructions
## Commands
- Dev: npm run dev
- Test: npm test
- Type check: npm run typecheck
## Architecture
- src/app: routes and server components
- src/lib: domain logic; UI must not call the database directly
## Working rules
- Read the nearest test before changing behavior
- Do not edit migrations unless the task explicitly asks for it
- Before finishing, run the narrowest relevant test and type check保持简短、具体、可执行。版本号、命令和目录发生变化时同步更新；不要把密钥、Token 或个人数据写进去。
五、一个可复用的工程工作流
- 复现：提供错误信息、触发步骤、预期与实际结果。
- 探索：要求先定位入口、调用链和已有测试，不修改文件。
- 计划：让 Claude 列出要改的文件、风险和验证方式。
- 实现：一次只处理一个清晰边界，避免顺手重构无关代码。
- 验证：运行针对性测试、类型检查，再审阅
git diff。 - 交付：要求总结改动、测试结果、未解决风险，不把“命令运行过”误写成“结果已通过”。
六、用 MCP 连接外部工具
不再建议手工维护旧教程里的 ~/.claude/mcp_servers.json。当前 Claude Code 可直接用 CLI 添加服务器：
# 远程 HTTP 服务器：默认 local，仅当前项目且不共享
claude mcp add --transport http docs https://example.com/mcp
# 本地 stdio 服务器：-- 后面是启动命令
claude mcp add --transport stdio local-tools -- npx -y example-mcp-server
# 查看配置
claude mcp list
# 在会话内查看状态、完成 OAuth
/mcp--scope project 会把共享配置写到仓库根目录的 .mcp.json；--scope user 对当前用户的所有项目生效；默认 local 只对当前项目生效。 共享配置首次连接仍需审批。密钥放环境变量或 OAuth，不要提交到仓库。
七、最常见的五个问题
- 一上来就做大任务：先缩成一个有验收标准的变更，再逐步扩展。
- 把 CLAUDE.md 当权限：说明会影响模型行为，但真正的访问控制必须写 permissions。
- 跳过 diff：测试通过也可能夹带无关改动，提交前仍需人工检查。
- 把第三方 MCP 当普通依赖：MCP 可执行工具和访问数据，应审查来源、权限与网络范围。
- 用量写成固定小时数：实际消耗受模型、任务、上下文和套餐政策影响，应查看官方账户界面。