macOS/Linux Claude Code 安装指南

在 macOS 或 Linux 系统上安装官方 Claude Code CLI,并配置为使用积木AI代码助手。

系统要求

系统
macOS 10.15+ 或 Linux
依赖
Node.js 20+ + npm
Node.js 安装(如果没有安装)
macOS:前往 nodejs.org/zh-cn/download 下载
Linux(Debian/Ubuntu):curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -,然后 sudo apt-get install -y nodejs

安装步骤

1

打开终端

macOS 可用 Cmd+Space 搜索 Terminal,或使用 VS Code / JetBrains 的内置终端打开;Linux 打开你常用的终端即可。

2

复制并执行环境检查脚本

curl -fsSL https://code.jimuxyz.com/env_deploy/claude-install.sh | bash

只执行这一行;确保命令以 curl 开头,不要和上一行拼在一起。

3

卸载已安装的 Claude Code(可选,未安装请跳过)

# 下面是通用操作
npm uninstall -g @anthropic-ai/claude-code

# 下面是macOS专属(Linux忽略),通用操作在macOS执行成功,以下步骤macOS也可忽略
brew uninstall codex
4

安装官方原版包

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

验证安装

claude -v
6

登录后创建并复制 Claude Code API Key

登录后到「API Key」页面创建一个新的 Claude Code Key(复制你的Claude_API_KEY)。

7

复制并执行环境变量配置脚本(推荐)

curl -fsSL https://code.jimuxyz.com/env_deploy/claude-deploy.sh | bash -s -- "你的Claude_API_KEY"

你的Claude_API_KEY 替换为真实 Claude Code Key;不要把 Key 单独作为命令输入。

脚本会把环境变量写入 ~/.zshrc~/.bashrc

或者

如果你不想用脚本,可手动写入以下内容:

export ANTHROPIC_BASE_URL="https://code.jimuxyz.com/p"
export ANTHROPIC_API_KEY="你的Claude_API_KEY"
export ANTHROPIC_AUTH_TOKEN="你的Claude_API_KEY"
export API_TIMEOUT_MS="300000"

写入后执行 source ~/.zshrc 生效(若使用 bash,替换为 source ~/.bashrc)。

如遇 400,可加:export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"

8

启动 Claude Code

设置完成后需要先关闭终端,然后重新打开一个新的终端使用,或者在插件中使用。

# 导航到你的项目(可选)
cd your-project

# 启动 Claude Code
claude