Claude Code 多系统安装配置

Claude Code 配置指南

Claude Code 配置指南

Linux/macOS
Windows
1

打开终端

使用 Cmd+Space 搜索 “Terminal” 或在 应用程序 → 实用工具 中找到终端

2

复制并执行环境检查脚本

此脚本将检查您的系统环境,确保满足安装要求

$ curl -fsSL https://gitee.com/CoderRouter/scripts/raw/master/install_claude.sh | sed 's/\r$//' | sh
3

卸载已安装的Claude Code(可选)

如果您之前未安装过Claude Code,请跳过此步骤

$ npm uninstall -g @anthropic-ai/claude-code
4

安装官方原版包 推荐

安装Anthropic官方发布的Claude Code包,确保功能完整性和安全性

$ npm install -g @anthropic-ai/claude-code
# 安装可能需要几分钟时间,请耐心等待…
5

配置API密钥

从控制台获取您的专属API密钥,用于Claude Code的身份验证

重要提示

API密钥是您访问服务的凭证,请妥善保管,不要分享给他人

6

配置环境变量

选择以下两种方式之一配置环境:

方式一:使用自动配置脚本(推荐)

执行以下命令自动配置环境变量,替换命令中的 “你的API_KEY”:

$ curl -fsSL https://gitee.com/CoderRouter/scripts/raw/master/setup_claude_env.sh | sed 's/\r$//' | bash -s -- "你的API_KEY"

方式二:手动编辑配置文件

打开或创建 ~/.claude/settings.json,添加以下配置(替换 API_KEY 和 BASE_URL):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.code-relay.com/",
    "ANTHROPIC_AUTH_TOKEN": "你的API_KEY"
  }
}
7

验证安装结果

重启终端后运行以下命令,确认Claude Code已成功安装

$ claude -v
# 输出: claude-code@1.x.x
安装完成!

如果看到版本号,说明Claude Code已成功安装。现在您可以在任何项目中使用 claude 命令了。

8

Codex配置指南 可选

如果您需要使用OpenAI Codex,可以通过以下命令进行安装

Codex配置说明

此配置为可选项,仅在需要使用OpenAI Codex功能时安装。其他配置步骤与Claude Code保持一致。

$ npm i -g @openai/codex
# 安装OpenAI Codex全局包

验证Codex安装

安装完成后,运行以下命令验证Codex是否正确安装

$ codex
# 如果安装成功,将显示Codex命令帮助信息
1

下载Git(在桌面进行)

访问Git官网下载并安装,安装时全部选择下一步,不要修改路径

下载地址

请访问 https://git-scm.com/downloads/win 下载适合您系统的Git安装包

2

下载Node.js(在桌面进行)

访问Node.js官网下载并安装,安装时全部选择下一步,不要修改路径

下载地址

请访问 https://nodejs.org/zh-cn/download 下载LTS版本(推荐)

3

验证安装情况(在Windows PowerShell中)

打开Windows PowerShell(蓝色图标),执行以下命令验证安装情况

在开始菜单搜索 “PowerShell” 或按 Win+X 选择 “Windows PowerShell”

验证Node.js版本:

PS> node -v

验证npm版本:

PS> npm -v

若提示「No suitable shell found」,是git没装好。请将 CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\git\bin\bash.exe 设置到系统环境变量中,重启终端再试。依旧无效,重装git,重启终端后再试

4

卸载已安装的Claude Code(可选,在Windows PowerShell中)

如果您之前未安装过Claude Code,请跳过此步骤

PS> npm uninstall -g @anthropic-ai/claude-code
5

安装官方原版包 推荐(在Windows PowerShell中)

安装Anthropic官方发布的Claude Code包,确保功能完整性和安全性

PS> npm install -g @anthropic-ai/claude-code
# 安装可能需要几分钟时间,请耐心等待…
6

设置Windows系统环境变量(在控制面板中)

需要设置以下三个环境变量,请先获取您的API密钥

需要设置的环境变量:
Claude Code配置:
变量名:ANTHROPIC_BASE_URL
变量值:https://api.code-relay.com/
变量名:ANTHROPIC_API_KEY
变量值:你的密钥
变量名:ANTHROPIC_AUTH_TOKEN
变量值:你的密钥
OpenAI Codex配置(可选):
变量名:OPENAI_BASE_URL
变量值:https://api.code-relay.com/v1
变量名:OPENAI_API_KEY
变量值:你的密钥
设置方法:

1. 右键”此电脑” → “属性” → “高级系统设置” → “环境变量”
2. 在”系统变量”区域点击”新建”
3. 分别添加上述三个变量
4. 点击”确定”保存所有更改

7

验证安装结果(在Windows PowerShell中)

重启Windows PowerShell后运行以下命令,确认Claude Code已成功安装

PS> claude -v
# 输出: claude-code@1.x.x
安装完成!

如果看到版本号,说明Claude Code已成功安装。现在您可以在任何项目中使用 claude 命令了。

8

Codex配置指南 可选(在Windows PowerShell中)

如果您需要使用OpenAI Codex,可以通过以下命令进行安装

Codex配置说明

此配置为可选项,仅在需要使用OpenAI Codex功能时安装。环境变量已在步骤6中包含。

PS> npm i -g @openai/codex
# 安装OpenAI Codex全局包

验证Codex安装

安装完成后,运行以下命令验证Codex是否正确安装

PS> codex
# 如果安装成功,将显示Codex命令帮助信息
© 版权声明
THE END
喜欢就支持一下吧
点赞10 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容