Claude Code 安裝与設定

快速开始使用 Claude Code - 从安裝到首次執行仅需几分钟

安裝与設定

快速开始使用 Claude Code - 从安裝到首次執行仅需几分钟

系統要求

操作系統

Windows 10/11（推荐使用 WSL 2）
macOS 12 Monterey 或更高版本
大多数现代 Linux 发行版（Ubuntu 20.04+、Fedora 35+等）

硬件要求

至少 4 GB RAM
穩定的網路連接

軟體相依性

Node.js 18 或更高版本
npm 9 或更高版本
Git 2.30 或更高版本（可选但推荐）
ripgrep (rg)（可选）

按平台安裝

選擇您的操作系統以获取具体的安裝说明

Claude Code macOS Install

在 macOS 上安裝 Claude Code 非常简单

前提条件

macOS 12 Monterey 或更高版本
至少 4 GB 可用 RAM
已安裝 Xcode 命令行工具

安裝 Homebrew（如果尚未安裝）

Homebrew 是 macOS 的包管理器。在終端機中執行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

按照螢幕上的说明完成安裝。

安裝 Node.js

使用 Homebrew 安裝 Node.js：

brew install node

安裝 Claude Code

使用 npm 全局安裝 Claude Code：

npm install -g @anthropic-ai/claude-code

启动 Claude Code

导航到您的專案目录并启动 Claude Code：

首次執行时会提示您进行身份验证。

終端機最佳化

为获得最佳体验，请考虑使用：

功能丰富的終端機替代品

Zsh 組態框架

最小化、快速的提示符

身份验证選項

Anthropic Console

使用您的 Anthropic 账户凭据

造訪 console.anthropic.com
登入或建立帳戶
生成 API 金鑰
使用 claude login 並輸入您的金鑰

Claude App（Max 计划）

通过 Claude 桌面應用程式进行身份验证

確保您有 Claude Max 訂閱
從 claude.ai 下載 Claude App
在應用程式中登入

企业平台

使用企业 SSO 凭据

聯絡您的企業管理員
取得組織 ID 和網域
執行 claude login --enterprise
透過 SSO 進行身分驗證

准备开始了吗？

安裝后，尝试執行您的第一个 Claude Code 命令

$ claude "summarize this project"

入门指南探索功能命令参考官方文件

接下来做什么？

首次步骤指南

学习基础知识

从我们全面的 Claude Code 基础入门指南开始。

阅读指南

命令参考

所有可用命令

探索所有 Claude Code 命令及其使用示例。

查看命令

環境設定

進階組態

为您的特定開發環境組態 Claude Code。

設定指南

图形界面与桌面应用

超越命令行：探索 Claude Code 的图形界面、桌面应用和 IDE 集成

✨ 精选：Claudia - 由 Y Combinator 初创公司 Asterisk 打造的终极 Claude Code 图形界面

官方应用

Claude Desktop

官方

官方桌面應用程式，提供原生体验

支援的平台

macOSWindowsLinux

主要功能

原生桌面体验
MCP 伺服器支援
檔案上傳和分析
多模态交互
系統通知

下載 Claude Desktop

Claude Mobile

官方

iOS 和 Android 原生應用程式

支援的平台

iOSAndroid

主要功能

语音輸入支援
图像分析
对话同步
离线阅读
推送通知

下載 Claude Mobile

🔥 精选：Claude Code 图形界面

Claudia - Claude Code GUI

强大的 Claude Code GUI 应用和工具包 - 建立自定义智能体、管理交互式会话、執行安全的后台智能体

自定义智能体建立

会话管理

后台智能体

多平台支援

由 Asterisk（Y Combinator）開發

MIT 许可证 • 开源

在 GitHub 查看瞭解更多

建置技术

Bun + Tauri

平台

Windows、macOS、Linux

许可证

MIT 开源

其他第三方桌面应用

Claude3-DesktopClient

Tauri + Rust

基于 Tauri + Rust 的桌面客户端

功能特性

跨平台支援
原生性能
安全可靠
快速启动
系統托盘功能

在 GitHub 查看

建置说明

git clone https://github.com/pliu22/Claude3-DesktopClient
cd Claude3-DesktopClient
cargo tauri build

Tauri-Claude

Tauri + Rust

轻量级 Tauri 客户端

功能特性

轻量化设计
跨平台
原生体验
MIT 许可证
开源

在 GitHub 查看

建置说明

npm install
npm run tauri build

Claude-Desktop（Electron）

Electron + Vue.js

基于 Electron + Vue.js 的应用

功能特性

基于 Web 技术
易于自定义
跨平台支援
丰富的 UI 元件
外掛程式系統

在 GitHub 查看

建置说明

npm install
npm run build
npm run electron:build

IDE 集成

VS Code 扩展

Cline

Claude Dev

传统

原始 Claude 開發助手

• 程式碼生成
• 文件编写
• 程式碼审查
• 重构

ext install claude-dev.claude-dev

Anthropic Claude

即将推出

官方扩展（计划中）

• 官方支援
• 完整功能集
• 定期更新
• 企业功能

Coming soon...

JetBrains 外掛程式

Claude Assistant

可用

IntelliJ IDEA 集成

• 程式碼补全
• 重构
• 文件编写
• 程式碼分析

Install from JetBrains Marketplace

AI Code Helper

測試版

多 IDE 支援

• 跨 IDE 相容
• 程式碼建議
• 錯誤修复
• 性能提示

Search 'AI Code Helper' in plugins

Vim/Neovim 外掛程式

claude.nvim

社群

Neovim 的 Claude 集成外掛程式

• Lua 組態
• 异步操作
• 缓冲区集成
• 自定义命令

Plug 'claude-ai/claude.nvim'

Web 界面解决方案

瀏覽器扩展

增强基于 Web 的 Claude 体验

Claude Web Enhancer

增强 Web 功能

Claude Shortcuts

键盘快捷键支援

Claude Export

对话匯出功能

自托管解决方案

部署您自己的 Claude 界面

Docker 部署

容器化 Claude UI

自定义 Web UI

建置您自己的界面

API 集成

直接 API 实现

自托管 Docker 示例

# Deploy Claude Web UI with Docker
docker run -d \
  -p 3000:3000 \
  -e ANTHROPIC_API_KEY=your_key \
  claude-web-ui

自定义界面開發

使用 API 建置您自己的 Claude 界面

程式碼示例

// React Example
import { Anthropic } from '@anthropic-ai/sdk';

const claude = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});

function ChatInterface() {
  const [messages, setMessages] = useState([]);

  const sendMessage = async (content) => {
    const response = await claude.messages.create({
      model: 'claude-3-sonnet-20240229',
      max_tokens: 1024,
      messages: [{ role: 'user', content }]
    });

    setMessages(prev => [...prev, response]);
  };

  return (
    <div className="chat-interface">
      {/* Chat interface components */}
    </div>
  );
}

最佳实践

响应式设计适配不同螢幕尺寸
实时反馈和进度指示器
常用操作的键盘快捷键
暗色/亮色主题支援
螢幕阅读器的无障碍功能

選擇您喜欢的界面

从命令行到桌面应用，找到与 Claude Code 交互的完美方式

试用 Claudia GUI Claude Desktop 命令行

常见问题解答

关于 Claude Code 的所有資訊以及它如何改变您的開發工作流程。

網頁版 Claude Code 是一個基於瀏覽器的工作空間，無需安裝即可提供完整的 Claude Code 功能。連接您的 GitHub 帳戶，即可立即開始使用 AI 輔助編碼、隔離環境和即時進度追蹤。

核心功能

無需安裝: 直接在瀏覽器中執行 - 無需下載、無需設定、無需組態檔。
無縫 GitHub 整合: 連接您的 GitHub 帳戶以存取儲存庫、建立分支和推送變更 - 全部在瀏覽器中完成。
隔離的託管環境: 每個專案都在安全的隔離環境中執行，具有自動相依性管理和沙箱保護。
即時進度追蹤: 即時查看 Claude Code 的工作進展，包括終端機輸出、檔案變更和建置進度。

工作原理

連接 GitHub: 授權 Claude Code 存取您的 GitHub 儲存庫，具有細粒度權限控制。
選擇儲存庫: 選擇現有儲存庫或啟動新專案。Claude Code 會自動設定開發環境。
開始編碼: 用自然語言向 Claude 下達指令。觀察它分析程式碼、進行變更和執行測試。
推送到 GitHub: 審查變更、建立分支並將提交直接推送到 GitHub - 全部在瀏覽器介面中完成。

為什麼使用網頁版？

從任何帶有瀏覽器的裝置存取您的專案 - 無需本機設定
與團隊成員共享即時工作階段，進行結對程式設計和程式碼審查
跨不同專案同時執行多個並行作業
企業級沙箱保護確保您的程式碼和憑證安全
環境在所有地方都相同 - 不再有「在我的機器上可以執行」的問題

網頁版 vs 命令列版

兩個版本提供相同的 AI 功能，但工作流程不同：

網頁版

基於瀏覽器，隨處存取
視覺化介面與即時進度
內建 GitHub 整合
託管環境（無需本機設定）
最適合：快速任務、協作、多專案工作

命令列版

本機安裝，離線工作
基於終端機的工作流程
直接存取檔案系統
使用您自己的開發環境
最適合：深度工作、現有本機專案、進階自訂

開始使用

造訪 claude.ai/code 並連接您的 GitHub 帳戶，即可在幾秒鐘內開始使用 AI 輔助編碼。

適用於 Claude Pro、Team 和 Enterprise 方案。

Claude Skills 將工作流程和最佳實踐打包成可復用的技能模組，Claude 會在需要時自動載入；而 MCP（模型上下文協定）則將 Claude 與外部資料和工具安全連接。

Claude Skills = 一個資料夾（ZIP 安裝），包含工作流程文件、範例、可選指令碼和參考檔案。Claude 會自動識別並啟用相關任務的技能。適用於 Pro/Max/Team/Enterprise，需要開啟 Code Execution/Claude Code 或 API 對應能力。

將可復用流程如「AP 風格報告」、「品牌規範簡報」或「Excel 公式批次清理」等固化為模組，減少重複提示，輸出更穩定一致。

MCP（模型上下文協定） = 一個開放協定，MCP 伺服器暴露資料或工具（本機檔案、資料庫、搜尋、內部 API），由 MCP 用戶端（如 Claude/Claude Code/你的應用程式）連接呼叫。

標準化模型呼叫外部系統的方式，減少自訂整合程式碼。

Skills vs MCP 對比

Dimension	Claude Skills	MCP
本質	流程/知識包（如何把事做好）	連接/整合層（如何拿資料、呼叫工具）
典型內容	規範、範例、檢查清單、輕量指令碼、資源檔案	搜尋、資料庫、SaaS、內部 API、命令列工具等
觸發方式	Claude 按上下文自動載入合適技能	應用程式透過 MCP 連接並呼叫工具
適用人群	業務/內容/營運/法務/行銷等非工程角色也能編寫與復用	工程/平台團隊搭建統一工具與權限治理
價值側重	提升一致性、品質與速度（減少「提示工程」反覆）	提供可復用、可治理的整合能力
組態/門檻	低：寫 Markdown + 放資源，必要時加輕指令碼	中：需要部署/接入 MCP 伺服器與權限
最佳實踐	為每個高頻場景做一個 Skills 資料庫（品牌、法務、表格等）	把公司資料與工具都接成 MCP「總線」
關係	可以呼叫 MCP 暴露的工具來完成流程	為 Skills 提供外部動作與資料

使用場景：

使用 Skills：當你要把固定流程做對做齊（如品牌文案、法務條款、Excel 清洗範本、部落格發布 SOP）。Skills 把「怎麼做」的知識沉澱下來，讓輸出可復用、可稽核。

使用 MCP：當 Claude 需要存取外部系統（Git 儲存庫、內部搜尋、資料庫、Playwright 自動化、Cloudflare API 等）。MCP 把工具接進來，再在 Skill 裡教 Claude 如何正確呼叫這些工具。

團隊落地順序：

平台/DevOps 先把常用系統接成 MCP 目錄（權限/稽核統一）。
業務線沉澱 Skills（流程與規範）。
在 Claude/Claude Code 統一分發與版本管理（企業/團隊版支援）。

簡單類比：

Skills = 作業指導書 + 範例 + 小工具（流程與標準化）。
MCP = 轉接器總線（把一堆外部系統接給 Claude）。
一起用：先接（MCP），再教（Skills），Claude 才能又會又能。

Claude Code 是一款革命性的 AI 驱动编程工具，作为您的智能结对编程助手，由 Claude Opus 4.1 和 Claude Sonnet 4.5 驱动。专为致力于軟體開發的现代组织设计，使您能够比以往更快、更智能地编写程式碼。

与传统程式碼助手不同，Claude Code 理解您的整个程式碼库上下文，可以跨多个檔案进行复杂編輯，并以卓越的准确性遵循您的自然语言指令。

Sonnet 4.5 是驱动 Claude Code 2.0 的最新 AI 模型，代表了自主编程能力的重大突破：

扩展自主性：可以连续工作约 30 小时（从约 7 小时增加），能够完成复杂的多日任务
增强代理推理：在长期執行的開發任务中，具有卓越的计划、执行和自我纠正能力
更好的程式碼理解：在编码基准測試和复杂重构操作中表现更强
改进的计算机使用：与開發工具和環境的交互更可靠
长时间可靠性：即使在扩展编码会话中也能保持质量和一致性

Sonnet 4.5 与 Claude Code 2.0 一起发布，实现了可回滚检查点和 IDE 原生功能，使自主開發更安全、更实用。瞭解更多关于/blog/claude-code-2-0。

Claude Code 2.0 引入了原生 VS Code 扩展，将 AI 协助直接带入您的編輯器。以下是入门方法：

安裝扩展：在 VS Code 市场中搜尋「Claude Code」或访问VS Code Extension Marketplace
身份验证：使用您的 Claude 账户登入（需要 Max 订阅才能访问測試版）
開啟侧边栏：单击 VS Code 活动栏中的 Claude 图标以開啟助手面板
开始编码：用自然语言描述您想要建置或更改的内容
审查更改：Claude 将直接在您的編輯器中顯示建議更改的内联差异
接受或回滚：使用接受按钮或按 Esc Esc 撤消更改

VS Code 中的关键功能：

实时内联差异顯示将发生的确切更改
侧边栏聊天，与 Claude 持续协作
每次更改前自動检查点，安全实验
与您现有的 VS Code 工作流程无缝集成
无需在終端機和編輯器之间切换

查看我们的/blog/claude-code-2-0获取详细说明和最佳实践。

Claude Code 通过在整个開發过程中提供智能协助来改变您的開發工作流程：

程式碼理解：Claude Code 可以分析和理解您的整个程式碼库，包括相依性关系、架构和模式。
高效编码：通过理解您的專案上下文的智能建議和自動补全，更快地编写程式碼。
偵錯支援：获得說明识别和修复錯誤，具有对您程式碼的上下文理解。
重构协助：通过智能改进建議安全地重构程式碼。
文件生成：自動为您的程式碼建立高质量文件。
学习和技能发展：直接在您的编码環境中学习新的编程概念、框架和最佳实践。

Claude Code 提供一套全面的强大功能，旨在增强您開發体验的各个方面：

智能程式碼理解：对您的程式碼库进行深度语义分析，提供上下文感知建議
实时协作：与您的 AI 助手无缝结对编程体验
全栈開發支援：跨所有语言和框架的协助
语义程式碼搜尋：通过用自然语言描述功能来尋找相关程式碼
实时程式碼編輯：在编写程式碼时获得智能建議
專案级重构：通过全面更改安全地改进您的程式碼库
資料庫设计：获得设计和最佳化資料庫模式的說明
API 開發：协助建立和记录 API
Git 集成：与版本控制工作流程无缝集成
MCP 协议支援：進階多代理协作功能

开始使用 Claude Code 很简单。请按照以下步骤操作：

连接您的仓库：将 Claude Code 連結到您的 Git 仓库或本地開發環境
描述您的任务：使用自然语言告诉 Claude Code 您需要說明的内容
审查与协作：与 Claude 合作，它提供智能建議和程式碼編輯

Claude Code 与您现有的開發工作流程和工具无缝集成。查看我们的/install获取针对您特定環境的详细说明。

是的，Claude Code 以安全为基础原则建置。我们实施企业级安全措施来保护您的程式碼和知识产权：

本地处理選項：程式碼可以在不离开您的環境的情况下在本地处理
端到端加密：所有传输中的数据都使用行业标准协议加密
数据隔离：您的程式碼在隔离環境中处理
不使用您的程式碼进行训练：我们从不使用您的专有程式碼来训练我们的模型
SOC 2 合规：我们的基础设施遵循严格的安全标准
访问控制：团队環境的细粒度權限設定

我们的安全集成确保您的程式碼库在受益于 AI 协助的同时保持受保护。

绝对可以！Claude Code 在实时处理和问题解决方面表现出色。它可以：

在您键入时分析程式碼问题并建議改进
通过理解完整上下文說明偵錯复杂问题
为性能瓶颈建議最佳化
为编码挑战提供即时协助
根据您的规格說明实现新功能
生成測試用例以验证您的解决方案

Claude Code 的实时能力使其成为应对困难编程挑战和加速開發过程的宝贵合作伙伴。

Claude Code 支援全面的编程语言和技术范围，包括：

编程语言：

JavaScript/TypeScript
Python
Java
C/C++
C#
Go
Rust
Ruby
PHP
Swift
Kotlin

Web 技术：

React
Angular
Vue
Next.js
HTML/CSS
Tailwind CSS
SASS/LESS

后端和資料庫：

Node.js
Django
Flask
Spring
SQL（各种方言）
MongoDB
GraphQL

Claude Code 的语言支援不断扩展，它还可以說明处理各种格式的組態檔案、建置脚本和文件。

Claude Code 在几个关键方面与其他 AI 编程助手区别开来：

整体程式碼库理解：与大多数只能看到程式碼片段的助手不同，Claude Code 可以理解您整个專案的上下文。
進階推理：由 Claude Opus 4.1 和 Claude Sonnet 4.5 驱动，我们的助手对复杂编码任务具有卓越的推理能力。
多檔案編輯：可以跨多个檔案进行协调更改以实现功能或修复。
类人协作：更像人类结对程式员，具有自然对话和解释。
学习您的风格：随着时间的推移适应您的编码风格和偏好。
MCP 协议：支援多代理协作协议，实现更复杂的工作流程。

虽然其他 AI 编码工具提供有用的建議，但 Claude Code 作为真正的协作者运作，理解您的專案目标，并可以說明从头到尾实现复杂功能。查看我们的/comparison瞭解更多。

是的，Claude Code 是所有技能水平程式员的优秀学习伴侣：

在您工作时提供程式碼概念的上下文解释
可以生成示例程式碼以演示编程模式
提供学习新框架或语言的交互式教學
建議最佳实践和对您程式碼的改进
可以将复杂的文件简化为实际示例
回答有关如何实现特定功能的问题

Claude Code 通过在您的实际编码環境中提供实时指导，弥合了理论与实践之间的差距，使在專案中立即应用新概念变得更容易。探索我们的/guides获取结构化学习路径。

需要更多說明？

找不到您要找的内容？查看我们的文件或联系我们。

查看文件案例研究