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):
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