Claude Code 概览

Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

无论你是在终端中使用 CLI，还是在 VS Code、JetBrains 等 IDE 中，Claude Code 都能提供无缝的 AI 协作体验。

快速入门

按照以下步骤快速启动你的第一个 Claude Code 任务：

1. 身份验证

在终端运行以下命令登录你的 Anthropic 账户：

claude login复制

2. 进入项目目录

切换到你想要处理的代码库根目录：

cd /path/to/your/project复制

3. 启动 Claude

直接输入 claude 进入交互式会话：

claude复制

4. 提出你的第一个需求

在提示符后输入你的任务需求，例如：

"帮我分析这个项目的目录结构，并解释核心逻辑。"复制

安装指南

选择你的环境来开始使用。大多数界面需要 Claude 订阅 或 Anthropic 控制台 账户。

1. 终端 CLI (推荐)

macOS, Linux, WSL 用户可以使用以下命令一键安装：

curl -fsSL https://claude.ai/install.sh | bash复制

Windows PowerShell 用户：

irm https://claude.ai/install.ps1 | iex复制

2. VS Code 扩展

在扩展视图中搜索 "Claude Code" (Mac: Cmd+Shift+X, Win/Linux: Ctrl+Shift+X)。安装后，通过命令面板 (Ctrl+Shift+P) 启动。

3. JetBrains 插件

从 JetBrains Marketplace 安装 Claude Code 插件，然后重启你的 IDE。支持 IntelliJ IDEA, PyCharm, WebStorm 等。

你可以做什么

以下是你可以使用 Claude Code 的一些方式：

• 代码理解 深入理解整个项目架构，回答复杂的代码逻辑问题。
• 自动化 编写脚本、执行重复性开发任务、重构大型代码库。
• 调试 分析错误堆栈，跨文件追踪 Bug 并提供修复建议。
• 提交 自动生成详细的 Commit Message 和 Pull Request 描述。

API 速查表

Claude Code 常用 CLI 命令汇总：

常用工作流与最佳实践

GitHub 集成

通过 GitHub Actions 或 GitLab CI/CD 自动化 PR 审查和问题分类。在每个 PR 上获得自动代码审查建议。

移动端协作

在本地启动任务，在移动设备上的 Claude iOS 应用中继续查看网络或会话进度。

浏览器调试

使用 Chrome 插件直接在实时网络应用中调试错误，并将上下文直接发送给 Claude。

设置与存储

使用 CLAUDE.md 文件为 Claude 提供持久的存储说明和内存，记录项目的特定规则和偏好。

# CLAUDE.md
## 项目规范
- 使用 TypeScript
- 强制使用 2 空格缩进
- 优先使用函数式组件复制

故障排除

遇到问题？以下是一些常见问题的解决方法：

• 身份验证失败：确保你的 API Key 有效，且已开启 Claude Code 访问权限。尝试运行 claude logout 后重新 claude login。
• 权限问题：如果遇到 "Permission Denied"，请确保你在当前目录有写权限，或尝试以管理员身份运行。
• 连接超时：检查你的网络连接，或尝试配置代理。Claude Code 支持标准的 HTTPS_PROXY 环境变量。