本文档详细介绍了Claude Code的安装和配置过程，旨在帮助用户顺利搭建开发环境。首先，文章列出了Windows和macOS/Linux系统的环境要求，包括Node.js版本和Git的安装。接着，指导用户如何通过npm安装Claude Code官方原版包，并提供了验证安装成功的命令。文档的重点在于如何配置中转API，支持Kimi K2、GLM 4.5及兼容OpenAI API的服务，提供了Mac/Linux和Windows用户的具体设置方法，包括创建`settings.json`文件并填写必要的API密钥和基础URL。最后，文章推荐了几个镜像站点，并特别提醒用户在使用Opus模型时调整`CLAUDE_CODE_MAX_OUTPUT_TOKENS`参数以优化性能，以及配置修改后需要重启Claude Code。

💡 **环境准备与安装**：安装Claude Code前，需确保系统满足Windows 10 (版本1809及以上) 或macOS/Linux环境，并安装Node.js (20+) 和Git。安装过程建议全部默认，并在安装完成后通过`node -v`、`npm -v`和`claude -v`命令验证Git、Node.js及Claude Code的安装状态，确保环境配置无误。

🚀 **官方原版包安装**：通过npm命令`npm install -g @anthropic-ai/claude-code`即可安装Claude Code的官方原版包。若之前已安装，可先用`npm uninstall -g @anthropic-ai/claude-code`进行卸载，确保安装的是最新、最稳定的版本。

🔧 **中转API配置**：为支持国内用户及更多模型，Claude Code允许配置第三方API KEY。用户需在用户目录下创建`.claude/settings.json`文件，并根据操作系统（Mac/Linux或Windows）的终端环境，在`env`字段中填入`ANTHROPIC_AUTH_TOKEN`（专用分组令牌key）和`ANTHROPIC_BASE_URL`（如`https://aicodeditor.com`），以及其他可选参数如`CLAUDE_CODE_MAX_OUTPUT_TOKENS`。

⭐ **模型性能优化**：在使用Opus模型时，为获得最佳性能，建议将`CLAUDE_CODE_MAX_OUTPUT_TOKENS`参数设置为32000。此外，任何对`settings.json`文件的配置更改后，用户都需要重启Claude Code服务，以确保新的配置能够生效。

此流程100%使用官方原版安装包，确保服务体验与官方完全一致

系统要求

window: Windows 10 (版本 1809 / build 17763) 及以上mac/linux：无nodejs: 20+

安装步骤

下载git

访问 git-scm.com/downloads/w…，安装时全都下一步，不要修改路径

下载nodejs

访问 nodejs.org/zh-cn/downl…，安装时全都下一步，不要修改路径

验证安装情况

打开Git Bahs执行以下命令验证安装情况：

$ node -v$ npm -v

若提示「No suitable shell found」，是git没装好，重装git，重启终端后再试

卸载已安装的Claude Code（未安装请跳过）

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

安装官方原版包

$ npm install -g @anthropic-ai/claude-code

验证安装情况

$ claude -v

若输出版本号，则证明安装成功

配置中转API

目前 Claude Code 支持配置第三方 API KEY，国内支持 Kimi K2 和 GLM 4.5 等，如果中转 API 站点支持 OpenAI 的 completions 也是可以通过 ccr 的方式实现的，这里就不介绍了，主要介绍官方的方式。

Mac / Linux 用户

打开终端创建 vim ~/.claude/settings.json 文件，内容如下：

{  "env": {    "ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",    "ANTHROPIC_BASE_URL": "https://aicodeditor.com",    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1  },  "permissions": {    "allow": [],    "deny": []  }}

Windows 用户

打开 git bash 终端创建 vim ~/.claude/settings.json 文件，内容如下：

{  "env": {    "ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",    "ANTHROPIC_BASE_URL": "https://aicodeditor.com",    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1  },  "permissions": {    "allow": [],    "deny": []  }}

推荐镜像站

Ai Code EditorOpenRouter智谱AI月之暗面

重要提醒

使用 Opus 模型时： 请将 CLAUDE_CODE_MAX_OUTPUT_TOKENS 设置为 32000，以确保最佳性能。

重启 Claude Code： 修改配置后，请重启 Claude Code 以使配置生效。