灿海星图指南--Claude Code，135K星终端Agent，5种安装方式一次讲完
我第一次用Claude Code是在SSH连着服务器的时候——只想试试"让它理解一下这个项目在干嘛"。它读了README、package.json、目录结构，然后给我列了项目架构、入口文件、核心模块。没问我一句。
本文是一篇实操指南，预计15分钟了解全貌。已核实内容与官方GitHub README一致。
这是什么
Claude Code是Anthropic的终端AI编程Agent，135K星。终端里用自然语言描述要做什么——它读代码库、执行任务、解释代码、处理git工作流。不需要打开IDE。
不能生成PPT、不能画图、不能做语音对话。 它就是写代码的。
适用： 习惯用终端的开发者。想要一个能理解整个项目的AI助手，而不是只补全当前行的。
手机能用吗
Claude Code只有CLI——没有IDE插件、没有Web版、没有手机App。但SSH到开发机→运行claude即可。Termius/JuiceSSH等手机SSH客户端可以做到。
五种安装方式
方式一：官方脚本（推荐）
# Mac/Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
方式二：Homebrew
brew install --cask claude-code
方式三：WinGet
winget install Anthropic.ClaudeCode
方式四：npm（已废弃，仍可用）
npm install -g @anthropic-ai/claude-code
方式五：接入灿海星图
export ANTHROPIC_BASE_URL="你的灿海星图地址"
export ANTHROPIC_API_KEY="你的Key"
Claude Code支持任何OpenAI兼容的API端点。通过灿海星图接入，可以用DeepSeek-V4-Pro等模型替代原生Claude。
核心功能
代码库理解。 自动索引项目，读README、package.json、目录结构。不用解释项目是干什么的。
自然语言执行任务。 "给这个函数加单元测试""重构这个模块，改成async/await""解释这个MR的逻辑"。终端里直接输入。
Git工作流。 自动提交、自动写commit message、自动创建PR。
插件系统。 支持自定义命令和MCP协议，可以接外部工具。
踩坑实录
| 现象 | 原因 | 解决 |
|---|---|---|
| Windows下首次运行报错 | 缺少Git Bash环境 | 安装Git for Windows，重启终端后再运行 |
| 大项目索引慢，命令无响应 | 10万行以上代码库首次索引需数分钟 | 等索引完成再下命令，日常使用秒开 |
| 免费额度用尽，请求被拒 | Anthropic免费token有上限 | 通过灿海星图API接入，按用量计费更可控 |
常见疑问
Q1：Windows下没有WSL能用吗？
能，但需要先装Git Bash。官方推荐用PowerShell直接跑安装脚本。WSL体验更好但不是必须的。
Q2：通过灿海星图接入后功能和原生有区别吗？
核心的代码理解、任务执行、Git工作流都一样。差别在模型——走灿海星图可以选DeepSeek-V4-Pro等替代模型，成本可控但代码质量不一定达到原版Claude水平。MCP插件、自定义命令等扩展功能都正常。
Q3：大项目首次索引多久？
10万行代码大概3-5分钟，50万行可能10-15分钟。索引只在首次和项目结构大改时触发，日常使用秒开。
本文数据来源于GitHub仓库（anthropic/claude-code）及作者实测。