macOS/Linux Claude Code 使用说明

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

返回 下载脚本 登录后创建 Claude Code Key
开始前先做这一步：先到 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）：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
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 ANTHROPIC_MODEL="claude-sonnet-4-6"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

写入后执行 source ~/.zshrc 生效（若使用 bash，替换为 source ~/.bashrc）；如果在 VS Code / JetBrains 里使用，请完全退出编辑器后再打开。

如遇 400，可加：export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"。

VSCode 插件仍提示登录怎么办？先完全退出 VSCode，再重新打开项目和终端。如果仍弹官方登录，重新执行上面的“一键写入配置”命令；脚本会写入本地 Claude Code 配置，告诉插件使用当前 Key 来源。进入 Claude Code 后可输入 /status 检查模型和 API 地址。
8

启动 Claude Code

设置完成后请先完全退出当前终端、VSCode 或其他编辑器，再重新打开使用；只新建标签页有时仍会读到旧环境变量。

# 导航到你的项目（可选）
cd your-project

# 启动 Claude Code
claude

# 进入 Claude Code 后可输入 /status 检查当前模型和 API 地址
/status