macOS/Linux Claude Code 使用说明
在 macOS 或 Linux 系统上安装官方 Claude Code CLI,并配置为使用积木AI代码助手。
开始前先做这一步:先到 Key 管理 创建 Claude Code Key。文档里所有 你的Claude_API_KEY 都必须替换成你自己的真实 Key,否则无法使用。
先选一种方式
如果你只是想尽快装好并开始使用,优先用“下载脚本”;如果你更习惯自己在终端执行命令,就用“复制脚本”;只有需要逐步排障时,再看完整说明。
curl -fsSL https://code.jimuxyz.com/env_deploy/claude-install.sh | bash
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
curl -fsSL https://code.jimuxyz.com/env_deploy/claude-deploy.sh | bash -s -- "你的Claude_API_KEY"
系统要求
系统
macOS 10.15+ 或 Linux
依赖
Node.js 18+ + 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 --registry=https://registry.npmmirror.com
5
验证安装
claude -v
6
登录后创建并复制 Claude Code Key
登录后到「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