Claude Code 上手指南：安装、配置与高效工作流实践
本文整理 Claude Code 的安装登录、项目初始化、CLAUDE.md 配置、常用 Slash Commands、权限控制、MCP 扩展和 GitHub Actions 集成，适合第一次上手的开发者按步骤实践。
Claude Code 上手指南：安装、配置与高效工作流实践
本文面向第一次接触 Claude Code 的开发者，整理安装、登录、项目初始化、常用命令、权限配置、MCP 扩展和 GitHub 工作流。内容依据 Anthropic 官方文档整理，截至 2026-05-19。
1. Claude Code 是什么
Claude Code 是 Anthropic 推出的命令行 AI 编程助手。它不是单纯的“代码补全”，更像一个能进入项目目录、理解代码结构、读取文件、修改代码、运行测试并解释结果的结对编程伙伴。
适合它的场景包括：
- 快速理解一个陌生项目的架构和关键模块；
- 根据需求实现功能、补充测试、修复报错；
- 做代码审查、重构建议、性能排查；
- 把团队规范写进项目，让 AI 按同一套约定工作；
- 通过 MCP 连接外部工具，例如浏览器、数据库、Issue 系统或自定义脚本。
2. 安装前准备
官方文档要求 Node.js 18+。系统方面，macOS、Linux 以及 Windows 都可以使用；Windows 用户建议使用 WSL、Git Bash 或官方支持的 Windows 方式运行命令行环境。
先检查 Node 版本：
node -v
npm -v
如果 Node 版本低于 18，建议先升级 Node.js，再安装 Claude Code。
3. 安装 Claude Code
标准安装命令如下：
npm install -g @anthropic-ai/claude-code
安装完成后进入你的项目目录：
cd /path/to/your-project
claude
第一次启动会进入登录流程。你可以按提示使用 Claude.ai 账号登录，也可以根据团队环境使用 Anthropic Console、Bedrock 或 Vertex AI 等方式。日常交互式使用一般直接运行 claude 即可。
如果安装后命令不可用，优先检查：
node、npm是否在 PATH 中；- 全局 npm bin 目录是否加入 PATH；
- 是否误用了需要管理员权限的安装方式；
- 运行
claude /doctor或在 Claude Code 内执行/doctor查看健康检查信息。
4. 第一次进入项目：先初始化上下文
建议第一次在项目根目录运行：
/init
这个命令会帮助生成 CLAUDE.md。它相当于项目说明书，用来告诉 Claude Code：项目怎么启动、怎么测试、目录结构是什么、代码风格是什么、哪些文件不要碰。
一个实用的 CLAUDE.md 可以这样写：
# Project Guide
- Package manager: pnpm
- Dev server: pnpm dev
- Test command: pnpm test
- Lint command: pnpm lint
- Do not read or modify .env files.
- Keep API changes backward compatible unless explicitly requested.
- Follow the existing component and service naming style.
写得越具体，Claude Code 越不容易猜错。比如“运行测试”不如直接写“使用 pnpm test”；“代码要规范”不如写清缩进、命名、目录约定和提交前检查命令。
5. 常用交互方式
进入 Claude Code 后，可以直接用自然语言描述任务：
> give me an overview of this codebase
> explain how authentication works in this project
> find the API endpoint for user login
> add unit tests for the order service
> run the test suite and fix the failing cases
一个高效工作流通常是：
- 先让 Claude Code 读项目并总结结构；
- 让它提出实现计划；
- 确认计划后再改代码；
- 修改后运行 lint、test 或 build；
- 最后让它总结改动和剩余风险。
对于大任务，不要一口气说“把系统重构一下”。更好的提问是：“先分析订单模块有哪些职责混在一起，不要修改文件，只给我拆分方案。”这样风险更低，输出也更可控。
6. 必会 Slash Commands
Claude Code 内置了不少斜杠命令，常用的有：
| 命令 | 作用 |
|---|---|
/help |
查看帮助 |
/init |
为当前项目生成或更新 CLAUDE.md |
/doctor |
检查安装和运行环境 |
/config |
查看或修改配置 |
/permissions |
管理工具权限 |
/memory |
编辑记忆文件 |
/mcp |
管理 MCP 连接 |
/agents |
管理专用子代理 |
/model |
切换模型 |
/cost |
查看 token 使用情况 |
/clear |
清空当前会话上下文 |
/compact |
压缩上下文，适合长会话继续推进 |
我最常用的是 /init、/permissions、/mcp、/compact。前两个决定项目是否好用，后两个决定复杂工作流能不能跑得长、跑得稳。
7. 权限与安全配置
Claude Code 可以读文件、改文件、运行命令，所以权限边界很重要。官方配置文件支持用户级、项目级和本地项目级设置，例如：
- 用户级：
~/.claude/settings.json - 项目共享：
.claude/settings.json - 项目本地：
.claude/settings.local.json
可以用 permissions 配置允许或拒绝的操作。例如禁止读取敏感文件：
{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
],
"allow": [
"Bash(npm run lint)",
"Bash(npm test:*)"
]
}
}
建议把敏感文件、生产凭据、私钥目录默认加入 deny。让 AI 写代码可以，别让它无意间把密钥读进上下文。
8. 用 MCP 扩展 Claude Code
MCP，全称 Model Context Protocol，可以把外部工具接进 Claude Code。比如浏览器调试、GitHub、文件系统、数据库、内部接口文档，甚至你自己的脚本服务。
常见添加方式类似：
claude mcp add my-server --scope user /path/to/server
scope 可以按使用场景选择：
- local：只在当前项目本机使用，适合个人实验；
- project：写入项目，适合团队共享；
- user：当前用户全局可用，适合常用工具。
配置好后，可以在 Claude Code 中用 /mcp 查看连接状态。部分 MCP 还会暴露自己的 slash command，格式通常类似：
/mcp__server_name__prompt_name
这让 Claude Code 不只是“会写代码”，还能实际调用工具、查状态、读上下文，适合做更完整的开发自动化。
9. GitHub Actions 集成
如果团队主要在 GitHub 上协作，可以使用 Claude Code GitHub Actions。它支持在 issue 或 PR 评论中通过 @claude 触发，让 Claude 帮忙分析、修复、创建 PR 或做代码审查。
快速安装方式是在 Claude Code 里运行：
/install-github-app
手动配置时，需要安装 Claude GitHub App，并把 ANTHROPIC_API_KEY 放到 GitHub Secrets 中。这里要特别注意：API Key 不要写进仓库，也不要贴到 issue 或 PR 评论里。
10. 我的实践建议
- 先让 Claude Code 解释项目，再让它动手；
- 大任务先开计划，小任务可以直接改；
- 每次修改后要求它运行测试或给出无法运行的原因；
- 把构建、测试、发版命令写进
CLAUDE.md； - 把
.env、私钥、生产配置加入权限 deny； - 长会话定期用
/compact，保留目标和关键约束； - 连接 MCP 前先想清楚权限，不要把所有工具一股脑暴露给所有项目；
- 最终合并前仍然要人工 review，AI 可以提速，但不能替你承担责任。
11. 小结
Claude Code 的核心价值不是“替你敲几行代码”，而是把 AI 放进真实工程上下文里：它能理解项目、执行命令、修改文件、运行测试，还能通过 CLAUDE.md、权限配置和 MCP 逐步适配你的团队流程。
如果你刚开始用，建议按这条路线走：先安装并登录，再在项目里 /init，然后从“解释项目结构”和“小范围修复”开始。等熟悉权限和工作流后，再接入 MCP、子代理和 GitHub Actions。这样上手成本低，也更安全。
参考资料
- Claude Code Setup：https://docs.anthropic.com/en/docs/claude-code/setup
- Common Workflows：https://docs.anthropic.com/en/docs/claude-code/common-workflows
- Memory / CLAUDE.md：https://docs.anthropic.com/en/docs/claude-code/memory
- Settings：https://docs.anthropic.com/en/docs/claude-code/settings
- Slash Commands：https://docs.anthropic.com/en/docs/claude-code/slash-commands
- MCP：https://docs.anthropic.com/en/docs/claude-code/mcp
- GitHub Actions：https://docs.anthropic.com/en/docs/claude-code/github-actions
Agent 垂直技术社区，欢迎活跃、内容共建。
更多推荐
10
0- 0
已为社区贡献1条内容
所有评论(0)