Skip to content

安装与准备

Claude Code 是 Anthropic 官方的 AI 编程助手 CLI 工具。

⚠️ 前置条件(必须满足)

在开始安装之前,请确保您已具备以下条件:

系统要求

  • Node.js 18+ - 下载地址
  • 代理工具 - 用于访问 Anthropic API(如 Clash、v2rayN 等)

账号准备

  • Anthropic 账号 - 注册地址
  • API Key - 在控制台获取,或使用第三方 API 服务

网络环境

  • 能够访问 api.anthropic.com
  • 或配置了可用的代理服务器

重要提醒

如果您无法满足上述任何一个条件,请先解决相关问题再继续安装。

快速安装

1. 安装 Claude Code

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

2. 验证安装

bash
claude --version

3. 启动与认证

bash
claude

首次运行会引导完成 Anthropic 账号认证。

安装成功标志

如果看到版本号输出且能正常启动认证流程,说明基础安装完成。

安装完成后,请参考 常用配置 进行个性化设置。

增强工具(推荐)

CCometixLine - 状态栏增强

高性能 Claude Code 状态栏工具,Rust 编写,提供 Git 集成和用量追踪。

前置条件

  • 已安装 Claude Code
  • Git(用于 Git 集成功能)

GitHub: https://github.com/Haleclipse/CCometixLine

安装:

bash
npm install -g @cometix/ccline

主要功能:

  • Git 集成:分支显示、状态指示(clean/dirty/conflicts)、远程追踪
  • 模型显示:简化模型名称(如 "Sonnet 3.5")
  • 用量追踪:基于 transcript 分析的 Token 使用百分比
  • 交互式 TUI:配置界面,实时预览,主题选择
  • 主题系统:多种内置预设(Cometix、Minimal、Gruvbox、Nord、Powerline-dark)
  • Claude Code 增强:禁用上下文警告、启用详细模式

配置:

bash
# 打开交互式配置界面
ccline --config

配置文件位置:~/.claude/ccline/config.toml

statusLine 配置:

~/.claude/settings.json(Windows: %USERPROFILE%\.claude\settings.json)中添加以下配置启用状态栏:

json
{
  "statusLine": {
    "type": "command",
    "command": "ccline",
    "padding": 0
  }
}
字段说明
type状态栏类型,command 表示执行外部命令
command命令名或可执行文件路径,支持环境变量
padding状态栏字符边距

验证命令可用性

如果状态栏未显示,可在 PowerShell 中执行 Get-Command ccline 验证命令是否在 PATH 中。

IDE 集成(可选)

前置条件

  • 已安装并配置好 Claude Code
  • 对应的 IDE 已安装

VS Code

Anthropic 官方提供的 VS Code 扩展,直接在编辑器中使用 Claude Code。

JetBrains IDE

Anthropic 官方提供的 JetBrains 插件,支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Android Studio 等全系列 IDE。

Beta 阶段

该插件目前处于 Beta 阶段,功能可能不完善,使用过程中如遇问题请及时反馈。