快速摘要：在终端中启动 Claude Code 非常简单：通过官方网站的一行命令进行安装，使用您的 Anthropic 账户进行身份验证，然后输入“claude”即可启动交互式会话。CLI 工具支持 macOS、Linux 和 Windows，使开发人员能够直接在终端环境中通过自然语言命令构建功能、修复 bug 和自动化任务。
Claude Code 代表了开发人员与 AI 助手交互方式的转变。这款基于终端的工具无需在浏览器标签页和文本编辑器之间复制代码，而是直接嵌入开发工作流程中，能够理解整个代码库并通过对话式命令执行复杂任务。
对于大多数开发人员来说，设置过程不到五分钟。但有效启动 Claude Code 的意义不仅仅是安装。
本指南涵盖了从初始安装到启动高效会话的全部内容，并附有适用于实际项目的实用示例。
Claude Code 实际功能
根据官方文档，Claude Code 是一款智能编码工具，可以读取代码库、编辑文件、运行命令并与开发工具集成。终端界面是大多数开发人员的主要交互点。
该工具可处理常规开发任务：构建功能、修复 bug、自动化工作流程和解释复杂的代码段。它具有项目文件、git 历史记录和正在运行进程的完整上下文。
与基于浏览器的 AI 助手不同，Claude Code 直接在 shell 环境中执行命令。当要求修复构建错误时，它不仅会提出解决方案，还会实际运行修复程序、测试结果并提交更改。
终端与其他平台
Claude Code 支持多个平台：终端 CLI、桌面应用程序、Web 界面、VS Code 和 JetBrains 的 IDE 扩展，以及用于调试实时应用程序的 Chrome 扩展。终端版本提供了最直接的控制。
终端会话支持键盘快捷键、后台任务执行以及与现有 shell 配置的集成。常驻命令行的开发人员会发现这是最快的界面。
| 平台 | 最适合 | 关键优势 |
|---|---|---|
| 终端 CLI | 熟悉命令行的开发人员 | 最快的交互，完整的 shell 集成 |
| 桌面应用 | 偏好可视化且需要持久会话 | GUI 界面，更易于导航 |
| VS Code 扩展 | 很少离开 IDE 的开发人员 | 无缝的编辑器集成 |
| Web 界面 | 无需安装即可快速访问 | 可在任何带有浏览器的设备上使用 |
安装要求
在安装 Claude Code 之前，请验证系统是否满足基本要求。该工具可在 macOS、Linux 和 Windows（包括 WSL2）上运行。
需要一个有效的 Anthropic 账户。如果您还没有账户，请在安装前访问官方 Anthropic 网站创建。
终端应具有互联网连接，并有权限下载和执行脚本。某些公司网络会限制脚本执行，如果安装失败，请与 IT 部门联系。
支持的操作系统
此声明无需删除 — 未在官方素材中找到。安装可通过终端或任何终端模拟器（如 iTerm2）进行。
Linux 发行版需要现代 shell（bash 或 zsh）。大多数最新的 Ubuntu、Debian、Fedora 和 Arch 安装无需修改即可运行。
Windows 用户应首先安装 Windows Subsystem for Linux (WSL2)。支持原生 Windows，但 WSL2 提供了与开发工具更好的兼容性。
通过 Get AI Perks 降低 AI 工具成本，开始使用
开始使用 Claude Code 通常也意味着尝试其他 AI 工具。Get AI Perks 帮助创始人寻找 AI 和云产品方面的创业公司信用额度和软件折扣。该平台汇集了 200 多项优惠，包括 Claude、Anthropic、OpenAI、Gemini、ElevenLabs 等的优惠，以及每项优惠的条件。
想查看可用的 AI 工具优惠吗？
访问 Get AI Perks 以：
- 浏览 Claude 和其他 AI 工具的优惠
- 查看哪些优惠适合您的公司
- 遵循指南领取可用信用额度
👉 访问 Get AI Perks 比较可用的 AI 软件优惠。
分步安装过程
官方安装方法使用单个命令，该命令会自动检测操作系统并安装相应版本。
适用于 macOS 和 Linux
打开终端窗口并运行此命令：
| curl -fsSL claude.ai/install.sh | bash |
安装脚本将下载 Claude Code 二进制文件，将其放置在系统路径位置，并配置 shell 集成。该过程通常在 30 秒内完成。
如果安装成功，终端将显示确认消息。通过键入以下命令测试安装：
| claude –version |
此命令应返回当前版本号。如果出现“command not found”错误，则需要调整 PATH 配置。
适用于带 WSL2 的 Windows
首先，请确保已安装并配置好 WSL2。打开 WSL2 终端（推荐使用 Ubuntu）并运行与 Linux 相同的安装命令：
| curl -fsSL install.claude.ai | sh |
Windows 特定的网络问题有时会在 WSL2 中出现。根据故障排除文档，可能需要调整防火墙规则以允许 WSL2 和 Windows 进程之间的通信。
安装问题故障排除
最常见的安装问题是 PATH 配置。如果在安装后终端显示“command not found”，则表示 Claude 二进制文件不在 shell 的可执行路径中。
使用以下命令检查安装位置：
| which claude |
如果此命令没有返回任何内容，请手动将安装目录添加到 PATH。对于 bash 用户，请将此行添加到 ~/.bashrc：
| export PATH=”$HOME/.local/bin:$PATH” |
对于 zsh 用户，请将相同的行添加到 ~/.zshrc。重新启动终端或运行 source ~/.bashrc 以立即应用更改。
与网络相关的安装失败通常显示为“TLS connect error”或下载中断。这表明存在防火墙限制或证书已过期。更新系统证书或联系网络管理员（如果在公司网络上工作）。
身份验证和首次启动
成功安装后，身份验证会将本地 CLI 连接到 Anthropic 账户。通过运行以下命令开始身份验证过程：
| claude |
首次启动会自动触发身份验证。将打开一个浏览器窗口，显示登录页面。使用您的 Anthropic 账户凭据登录。
浏览器身份验证完成后，终端会话将激活。欢迎消息会确认连接并显示基本用法说明。
会话管理
每次在终端中运行 claude 时，都会启动一个新的会话。会话会一直存在，直到用户通过 Ctrl+D 或输入 exit 明确结束。
身份验证令牌会本地存储，因此后续启动无需再次登录浏览器。令牌在 Anthropic 网站上的账户设置中被手动吊销之前一直有效。
启动交互模式
交互模式是开发人员使用 Claude Code 的主要方式。通过输入不带额外参数的 claude 来启动它。
终端将切换到交互式提示符，您可以在其中使用自然语言命令来指导 AI。此模式会维护对话上下文，记住之前的请求，并可以执行多步工作流程。
重要的交互式命令
几个内置命令可以控制会话行为。
在 Claude Code 提示符下输入：
- /model — 在不同的 Claude 模型（Opus、Sonnet）之间切换
- /status — 查看当前模型、会话 ID 和配置
- /btw — 在不更改任务上下文的情况下提出辅助问题
- ? — 显示键盘快捷键和帮助信息
键盘快捷键可提高工作效率。按 Ctrl+L 可清除终端屏幕而不结束会话。使用 Ctrl+C 可取消正在进行的生成。Ctrl+F 可终止所有后台任务（按两次确认）。
底部的状态行显示活动的后台进程、当前模型和令牌使用情况。此信息有助于监控复杂任务期间的资源消耗。
后台任务执行
Claude Code 可以在后台运行长时间运行的操作，同时仍然响应新的命令。后台任务会显示进度指示器并异步完成。
当多个操作同时运行时，任务列表会跟踪每个操作。按 Ctrl+F 查看和管理后台进程。
运行一次性命令
并非所有任务都需要交互式会话。对于快速操作，Claude Code 可以直接接受命令作为参数：
| claude “explain the authentication logic in src/auth.js” |
此命令将启动 Claude Code，处理请求，显示输出，然后立即退出。不会启动交互式会话。
一次性命令非常适合脚本编写和自动化。它们可以集成到 git hooks、CI/CD 管道或需要 AI 辅助特定子任务的 shell 脚本中。
仅查询模式
-p 标志可运行仅查询模式，该模式在不进行文件更改的情况下回答问题：
| claude -p “what dependencies does this project use?” |
此模式会读取项目文件，但不会进行任何创建、编辑或删除。它仅提供信息，因此可以安全地进行探索而不会产生意外修改的风险。
模型选择和配置
Claude Code 支持多种具有不同功能和速度特性的 AI 模型。根据官方文档，支持的模型包括 Sonnet 4.6、Opus 4.6、Opus 4.5、Haiku 4.5 和 Sonnet 4.5。
在交互式会话中，使用 /model 命令更改活动模型。交互式菜单会列出可用选项，并简要描述每个模型的优势。
若要永久设置模型偏好，请在启动 Claude Code 前设置环境变量：
| export ANTHROPIC_MODEL=”claude-opus-4-6″ claude |
此配置将在会话之间保持不变，直到变量被更改或取消设置。
快速模式配置
快速模式优先考虑响应速度而不是全面分析。它适用于不需要完全上下文分析的快速迭代和简单任务。
通过设置配置或使用针对速度优化的模型变体来启用快速模式。请查阅官方文档了解当前的快速模式选项，因为它们会随着新模型版本的发布而演进。
处理项目
Claude Code 通过分析当前目录和子目录中的文件来理解项目结构。开始前，请导航到项目目录：
| cd /path/to/your/project claude |
该工具会自动读取项目文件，理解代码库结构，并识别常见模式，如包管理器、框架配置和构建工具。
排除敏感文件
某些文件不应被 AI 工具分析或修改——例如凭据、API 密钥、大型二进制文件或生成的内容。在项目根目录中创建一个 .claudeignore 文件来排除特定路径：
| .env .env.local node_modules/ dist/ build/ *.log |
这与 .gitignore 语法的效果类似。在分析和执行期间，Claude Code 都无法看到被排除的文件。
终端配置技巧
Claude Code 在某些终端配置下运行效果更好。大多数问题都源于不兼容的 shell 设置或缺少功能。
Shell 集成
软化：某些现代终端支持可选的 shell 集成功能，例如通过 OSC 133 序列进行提示检测，但这些不是必需的。
为获得最佳兼容性，请使用最新版本的流行终端模拟器：macOS 上的 iTerm2，Linux 上的 Alacritty、Kitty 或 WezTerm。Windows Terminal 与 WSL2 配合使用效果很好。
键盘快捷键自定义
默认键盘快捷键可能与现有的终端或 shell 绑定冲突。通过位于 ~/.claude/settings.json 的设置配置文件进行自定义。
设置文件使用 JSON 格式，并支持将任何内置命令重新映射到不同的组合键。编辑后，请重新启动 Claude Code 使更改生效。
首次会话的常用工作流程
坦白说：首次 Claude Code 会话通常涉及实验。以下是一些演示核心功能的实际入门点。
探索代码库
首先，让 Claude Code 解释项目结构：
“Give me an overview of this codebase. What are the main components and how do they interact?”
此请求不会修改任何内容——它只是进行分析和解释。响应有助于验证 Claude Code 是否正确理解了项目组织。
进行简单更改
尝试进行低风险修改，以查看文件编辑功能：
“Add a comment at the top of README.md explaining what this project does”
Claude Code 会读取文件，生成适当的内容，并进行编辑。使用 git diff 检查更改，以确切了解发生了什么。
修复现有问题
如果项目存在已知 bug 或 TODO 项目，请让 Claude Code 来处理：
“Fix the login validation bug described in issue #42”
该工具会读取相关的源文件，识别问题，实现修复，甚至可以运行测试来验证解决方案是否有效。
权限和安全
Claude Code 在执行潜在风险操作前会请求权限。权限系统按影响级别对命令进行分类。
文件读取无需权限提示——读取代码始终是安全的。文件写入、删除和 shell 命令执行需要首次发生时的明确批准。
权限选择可以为当前会话或永久保存。永久权限存储在配置文件中，并适用于所有未来的会话。
沙盒配置
根据官方设置文档，沙盒会限制 Claude Code 进行更改的位置。配置沙盒路径前缀可将文件系统访问限制在特定目录。
此安全层可防止意外修改系统文件或项目范围之外的目录。处理敏感代码库的团队应在部署前配置沙盒。
| 权限类型 | 默认行为 | 推荐用于 |
|---|---|---|
| 文件读取 | 始终允许 | 所有用例 |
| 文件写入/编辑 | 首次提示 | 活动开发 |
| 文件删除 | 每次提示 | 仅限经验用户 |
| Shell 命令 | 带有预览的提示 | 自动化工作流程 |
| 网络访问 | 首次提示 | API 集成工作 |
常见问题
安装后 Claude Code 可以离线工作吗？
不可以。Claude Code 的所有操作都需要互联网连接，因为 AI 模型在 Anthropic 的服务器上运行。终端客户端将请求发送到 API 并接收响应。没有连接，该工具将无法工作。
运行 Claude Code 的成本是多少？
定价取决于 Anthropic 账户计划和使用量。请查阅官方 Anthropic 网站了解当前定价详情，因为计划和费率会随时间变化。令牌消耗量因代码库大小和请求复杂度而异。
Claude Code 能访问当前目录之外的文件吗？
默认情况下可以。Claude Code 可以访问用户帐户允许读取的任何文件。但是，沙盒配置会将访问限制在指定目录。对于安全敏感的环境，请在首次使用前配置沙盒设置。
如果 Claude Code 出错怎么办？
所有文件更改都可以通过标准的 git diff 命令查看。在提交任何 Claude Code 的修改之前，请仔细检查更改。由于一切都在 git 仓库中进行（推荐），因此使用 git 命令可以轻松地撤消错误。
可以同时运行多个 Claude Code 会话吗？
可以。每个终端窗口都可以运行一个独立的 Claude Code 会话。会话之间不会相互干扰，尽管来自不同会话同时编辑同一文件可能会导致冲突。
如何停止正在运行的 Claude Code 任务？
按 Ctrl+C 取消当前操作。对于后台任务，按 Ctrl+F 打开任务管理器，然后确认取消。取消后会话仍保持活动状态——只有特定任务会停止。
Claude Code 能记住之前的对话吗？
在单个会话中可以。Claude Code 会维护对话上下文，并记住之前的请求和更改。启动新会话（关闭并重新打开）将清除此上下文。对于持久的项目知识，请使用官方指南中记录的指令和记忆功能。
安装后的后续步骤
Claude Code 成功运行后，请探索其扩展功能。官方文档涵盖了自定义子代理、插件开发和计划任务自动化等高级主题。
Skills（技能）提供了一种通过项目特定的命令和工作流程来扩展 Claude Code 的方式。在 .claude/skills/ 目录中创建技能可以添加为特定开发需求量身定制的自定义功能。
Model Context Protocol (MCP) 集成允许 Claude Code 与外部工具和服务进行交互。这为通过相同的对话界面进行数据库查询、API 测试和基础设施管理打开了可能性。
Remote Control（远程控制）功能支持跨设备继续会话。可以在桌面计算机上开始工作，然后在笔记本电脑或移动设备上继续相同的会话。请查阅平台集成文档了解设置说明。
遇到问题时寻求帮助
官方故障排除文档解决了大多数常见问题。出现问题时，请先查看文档，然后再深入研究系统配置。
Reddit 等平台上的社区讨论提供了来自其他开发人员的真实解决方案。许多用户会在这些论坛上分享他们的配置调整和工作流程优化。
对于安装或身份验证问题，请在 Anthropic 网站上验证账户状态。即使本地设置正确，过期的订阅或账户限制也会阻止成功连接。
特定于终端的问题通常与 shell 配置或兼容性有关。使用默认终端配置（无自定义 shell 设置）进行测试有助于隔离问题是否源于本地修改。
结论
一旦安装完成，在终端中启动 Claude Code 只需几分钟。自然语言命令和直接代码库集成相结合，创造了一种开发工作流程，能够处理从简单的查询到复杂的多文件重构。
终端界面使开发人员能够留在他们首选的环境中，而无需切换到浏览器标签页或独立应用程序。后台任务执行意味着耗时的操作不会阻塞其他工作。
与任何开发工具一样，熟练程度来自于实践。从简单的只读查询开始，以了解 Claude Code 如何解释项目结构。随着信心的建立，逐渐过渡到文件编辑和自动化工作流程。权限系统可在学习阶段防止不可逆的错误。
准备好彻底改变您的编码工作流程了吗？立即安装 Claude Code，在您的终端中体验 AI 辅助开发。
