Claude Code 是 Anthropic 推出的一款基于命令行的 AI 编程助手,它允许开发者直接在终端中通过自然语言与 Claude 大模型交互,从而完成代码生成、重构、调试和文档编写等任务。对于许多习惯使用 VS Code 或其他图形界面 IDE 的开发者来说,首次接触命令行工具可能会感到些许陌生。本文将为您提供一份详尽的步骤清单,帮助您顺利完成 Claude Code 的安装、登录及基础配置,确保您能立即开始高效编程。
环境准备与安装验证
在尝试登录之前,首要任务是确保您的开发环境满足基本要求。Claude Code 依赖于 Node.js 运行时环境,因此请确认您的系统中已安装版本为 18 或更高版本的 Node.js。您可以通过在终端输入 node -v 来检查当前版本。如果未安装或版本过低,请先前往 Node.js 官网下载并安装最新稳定版。
接下来,进行全局安装。打开您的终端(Terminal 或 Command Prompt),执行以下 npm 命令:
npm install -g @anthropic-ai/claude-code
安装完成后,建议运行 claude --version 以验证安装是否成功。如果终端返回了具体的版本号,说明安装无误,您可以进入下一步的登录环节。这一步至关重要,因为只有在本地正确部署了客户端,才能建立与 Anthropic 服务器的安全连接。

执行登录指令获取凭证
Claude Code 采用 OAuth 认证机制,这意味着您不需要手动复制粘贴复杂的 API Key,而是通过浏览器授权来完成身份验证。在终端中直接输入 claude login 并回车。此时,程序会自动检测您的默认浏览器,并尝试打开一个指向 Anthropic 官方登录页面的新标签页。

如果您使用的是尚未登录的浏览器,页面将提示您输入 Anthropic 账号和密码;如果是已登录状态,则可能直接显示授权请求。请务必注意,整个登录过程必须在受信任的网络环境下进行。当您在网页端点击“Allow”或“Authorize”后,浏览器会重定向回终端窗口,或者终端会自动检测到认证成功并完成令牌存储。此过程会将安全凭证加密保存在本地目录中,后续无需重复登录,除非凭证过期或被手动清除。
初始配置与快速上手测试
登录成功后,您可以通过输入 claude 直接进入交互式对话模式。为了获得最佳体验,建议在首次使用前进行简单的上下文初始化。例如,您可以先让 Claude 了解当前项目的结构,输入指令如:“列出当前目录下的主要文件结构”,或者指定特定文件:“读取 src/index.js 的内容”。这样可以帮助模型更好地理解您的代码库背景。
此外,如果您需要长期调用且希望控制成本,可以在环境变量中设置 ANTHROPIC_API_KEY。虽然登录功能已经足够日常使用,但拥有独立的 API Key 可以让您在脚本自动化或集成到 CI/CD 流程时更加灵活。设置方法是在终端执行:export ANTHROPIC_API_KEY="your_api_key_here"(Linux/Mac)或在 Windows 系统的环境变量管理器中添加该键值对。
至此,您已经完成了从安装到登录的全部核心步骤。现在,您可以尝试输入一个简单的编程任务,例如“用 Python 写一个快速排序算法”,观察 Claude Code 如何在终端中实时生成代码并提供解释。这种沉浸式的命令行体验,将极大提升您的编码效率与逻辑清晰度。
本文链接:https://ai-claudecode.cn/jiaochen/claude-code-dlzmy-claude-code-dlzn/