我安装 Claude Code 时，本以为自己得到的是一个可以直接在终端里使用的完整 AI 智能体。安装过程本身很简单。真正让我意外的是安装之后：Claude Code 可以读取文件、编辑代码、执行命令——但它依然不能搜索网页、生成素材、存储输出结果，或发布任何内容。
这正是大多数 Claude Code 安装指南会忽略的缺口。Claude Code 给你的是智能体的 shell。它没有给你的，是完成真实工作所需的完整 capability layer。AnyCap 正是在这里发挥作用——它不是一个 MCP 服务器，而是一个更强的 agent CLI 和 capability runtime，为 Claude Code 补上搜索、媒体生成、存储和发布能力。
这篇指南会介绍我如何在 Mac、Linux 和 WSL 上安装 Claude Code、验证配置是否正常，并进一步借助 AnyCap 把它变成一个真正能在现实工作中发挥作用的智能体。
前置条件
在安装之前，请先确认你具备以下条件：
- 操作系统：macOS 13+（Ventura）、Ubuntu 20.04+ / Debian 10+，或搭配 WSL 的 Windows 10（1809+）
- 内存：至少 4 GB；如果代码库较大，建议 8 GB
- 网络连接：所有 AI 处理都运行在 Anthropic 的云基础设施上——没有网络，就没有 Claude Code
- Anthropic 账号：Claude Pro（20 美元/月）、Max（100–200 美元/月）、Teams、Enterprise，或 Console（API）账号。免费的 Claude.ai 套餐不包含 Claude Code。你可以参考我们的 Claude Code 价格对比 来选择合适的套餐。
- 终端：Bash、Zsh 或 PowerShell
- Node.js 18+：只有在使用 npm 安装方式时才需要
不需要 GPU。你的机器只运行一个轻量级 CLI 客户端；所有 AI 计算都在服务器端完成。
第 1 步：安装 Node.js（仅限 npm 方式）
如果你打算使用原生安装器——这也是 Anthropic 目前推荐的方式——可以完全跳过这一步。原生安装器没有任何依赖。
如果你准备用 npm，请先检查 Node 版本：
node --version
如果输出显示 v18.0.0 或更高版本，就可以进入第 2 步。否则，建议通过 nvm（Node Version Manager）安装，以避免权限问题：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
关闭并重新打开终端，然后执行：
nvm install 22
nvm use 22
node --version # 应显示 v22.x.x
Node.js 22 是当前的 LTS 版本，与 Claude Code 配合良好。
第 2 步：安装 Claude Code
共有三种安装方式，选一种即可。
方案 A：原生安装器（推荐）
零依赖。后台自动更新。这也是 Anthropic 主要测试和支持的方式。
macOS 和 Linux：
curl -fsSL https://claude.ai/install.sh | bash
Windows（PowerShell，以管理员身份运行）：
irm https://claude.ai/install.ps1 | iex
安装器会把 claude 二进制放入你的 PATH 中，并配置自动更新。从头到尾不到一分钟。
方案 B：Homebrew（macOS / Linux）
brew install --cask claude-code
有一点要注意：通过 Homebrew 安装的版本不会自动更新。你需要定期运行 brew upgrade claude-code。
方案 C：npm
npm install -g @anthropic-ai/claude-code
不要使用 sudo。 如果你遇到 EACCES 权限错误，正确的解决办法是使用 nvm，而不是把 npm 以 root 身份运行。root 拥有的 npm 目录会引发一连串权限问题。
验证
确认安装是否成功：
claude --version
如果要做完整的环境诊断：
claude doctor
第 3 步：认证
claude
首次启动时，Claude Code 会打开浏览器进行 OAuth 认证。登录你的 Anthropic 账号，授权 CLI，连接就建立好了。
认证方式
浏览器 OAuth（默认）： 最适合个人设备。适用于 Pro、Max、Teams 和 Enterprise 账号。授权后，会在本地保存会话令牌。
API Key（CI/CD 和无头环境）： 适用于没有浏览器的服务器、容器或流水线：
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
你可以在 console.anthropic.com 生成密钥。API 使用量会按照 Anthropic 的标准费率按 token 计费。若想了解订阅与 API 计费的完整区别，可参考我们的 Claude Code 价格指南。
该选哪种计费方式？ 对日常使用来说，订阅方案（Pro/Max）更简单，并且 Claude Code 已包含在月度套餐中。API 计费则更适合负载波动较大或需要自动化的场景，因为它提供更细粒度的控制。
第 4 步：开启你的第一次 Claude Code 会话
进入任意项目目录：
cd ~/my-project
claude
Claude Code 会读取你的项目结构，并进入交互式 REPL。先从低风险任务开始：
> Explain the architecture of this project
它会扫描你的文件，识别技术栈，并给出结构总结。然后再试一个真正会带来实际改动的任务：
> Add input validation to the user registration form
Claude Code 会定位相关文件，提出修改建议，并等待你的确认。你可以先在 diff 视图中检查每一项改动，再决定是否接受——它不会不加判断地直接覆盖文件。
如果你想在不进入交互模式的情况下执行一次性任务，可以使用 -p 参数：
claude -p "Write unit tests for the auth module"
执行任务、输出结果、然后退出。非常适合脚本化场景和 CI/CD 流水线。
第 5 步：配置 Claude Code
模型选择
Claude Code 默认使用当前可用的最新模型。需要时你也可以手动指定：
claude config set model claude-opus-4-7
或者只对单次会话生效：
claude --model claude-sonnet-4-6
权限
Claude Code 在写入文件或执行命令前会请求确认。如果你在某个项目中信任它：
claude config set permissions.auto-accept-edits true
这样做有助于提高速度，但对生产代码来说并不总是明智。
项目级设置
在项目根目录创建 .claude/settings.json：
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-6",
"environment": {
"NODE_ENV": "development"
}
}
CLAUDE.md
影响最大的配置依然是 CLAUDE.md。它会为 Claude 持续提供构建命令、项目约定和架构决策方面的上下文。你可以在 Claude Code 内运行 /init 生成一个初始版本，然后继续完善。
各平台说明
macOS
curl -fsSL https://claude.ai/install.sh | bash
Linux
使用同样的原生安装器。对于较老的发行版，可以结合 nvm 使用 npm。
Windows
PowerShell：
irm https://claude.ai/install.ps1 | iex
WSL：
wsl --install
然后在 WSL 中执行：
curl -fsSL https://claude.ai/install.sh | bash
Docker
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
CI/CD
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review this PR for bugs" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
不止是安装：补上缺失的 capability layer
这才是安装故事真正开始变得重要的地方。
此时，Claude Code 已经安装完成、认证成功，并且可以运行。但它仍然只是 shell 层。
开箱即用时，它并不具备以下能力：
- 实时网页搜索
- 图像生成
- 视频生成
- 云存储与文件分享
- 网页发布
这就是为什么很多“Claude Code 安装指南”最终还是只给用户留下一个半成品智能体。编码 shell 能工作，但更完整的 capability layer 仍然缺失。
更清晰的理解方式
- Claude model = 推理能力
- Claude Code = shell 与工作流循环
- AnyCap CLI = capability runtime 与执行界面
- AnyCap skill = 指令层，教 Claude Code 如何更好地使用这套 runtime
这才是关键区别。产品价值不在于“又多了一个工具”，而在于 AnyCap 补上了 Claude Code 原生并不提供的 capability layer。
安装 AnyCap CLI
curl -fsSL https://anycap.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
完成一次认证
anycap login
为 Claude Code 添加 skill
npx -y skills add anycap-ai/anycap -a claude-code
现在，Claude Code 就可以通过更强的 agent CLI 来完成以下工作：
| Capability | 示例 |
|---|---|
| 网页搜索 | 研究实时 API、竞品页面、价格信息 |
| 图像生成 | 生成 Hero 视觉图、示意图、Mockup |
| 视频生成 | 制作演示视频和动态素材 |
| 云存储 | 上传文件并分享链接 |
| 发布 | 将输出内容发布到网页 |
到了这一步，Claude Code 才开始真正像一个能处理现实任务的智能体，而不只是一个原生于终端的编码 shell。
那 MCP 呢？
MCP 依然很重要。特别是在内部系统、专有 API、数据库以及更窄、更定制化的集成场景中。
但 MCP 是协议层。
更广义的 capability layer 是另一个层面的问题。这也是为什么把 AnyCap 仅仅看作“一个 MCP 服务器”，会错过更有价值的架构视角。
故障排查
| 问题 | 解决方案 |
|---|---|
command not found: claude |
打开一个新的终端，或重新运行安装器 |
| Node.js 版本过旧 | nvm install 22 && nvm use 22 |
| npm 出现 EACCES 错误 | 使用 nvm，不要用 sudo |
| 浏览器认证无法打开 | 使用 ANTHROPIC_API_KEY |
| 安装时网络有问题 | 检查代理和 npm registry 设置 |
| Claude Code 感觉很慢 | 检查 Anthropic 状态页和网络延迟 |
在手动排查之前，先运行 claude doctor。它可以快速发现大多数环境问题。
下一步
安装好 Claude Code 之后，建议立刻做这三件事：
- 生成
CLAUDE.md，让它拥有项目记忆 - 补上 capability runtime，让它不只会做代码相关工作
- 跑一遍真实工作流，选择一个需要调研、媒体、存储或发布的任务
差异就是从这里开始显现的。
Claude Code 是 shell。
AnyCap 则是赋予它缺失执行层的那一部分。