"无法连接到远程服务器"是 Windows PowerShell 的联网失败提示,意思是脚本要访问的下载域名 code.kimi.com 连不上,跟你的 Kimi 账号或模型额度没关系。常见触发点是公司网络限制、全局代理拦截、防火墙、代理没配或配错。下面把报错含义、分层排查和替代安装方式讲清楚。 Kimi Code是什么、装前要准备什么
Kimi Code CLI 是运行在终端里的 AI 编程 Agent,用 TypeScript 编写、通过 npm 分发、跑在 Node.js 上,能读改代码、执行 Shell 命令、搜文件、抓网页,并根据反馈自主调整下一步。
官方给两条安装路径,安装脚本这条路不需要预装 Node.js:
- macOS / Linux:curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
- Windows(PowerShell):irm https://code.kimi.com/kimi-code/install.ps1 | iex
- npm 全局安装:npm install -g @moonshot-ai/kimi-code,这条需要 Node.js 22.19.0 或更高版本;Homebrew 用户也可以直接装。
Windows 用户首次启动前还要装 Git for Windows,因为 Kimi Code CLI 用其中的 Git Bash 作为 Shell 环境;如果 Git Bash 装在非标准路径,把 KIMI_SHELL_PATH 设为 bash.exe 的绝对路径。脚本会下载最新版本、校验 checksum,再把可执行文件放进 PATH。
关键一点:现行安装脚本只访问 code.kimi.com 这一个下载域名,不依赖 GitHub。如果你看到的教程让你去处理 GitHub 下载失败或 uv 安装问题,那是照着已经归档的旧版本在讲,跟现在的 Kimi Code CLI 不是一回事。
为什么会报无法连接到远程服务器
这条提示是 PowerShell 的 Invoke-WebRequest / Invoke-RestMethod 建立连接失败时给出的报错,属于你本机到下载域名之间的链路问题,不是 Kimi 服务端返回的错误。报错可能出在三个断点:拉取安装脚本本身、脚本内部解析版本号与拉取安装清单、以及装完之后的登录与接口调用。
按官方帮助文档的口径,常见原因集中在这几条:
- 公司或学校网络限制:内部网络常拦外部 API 请求,需要走你自建的代理。
- 全局代理拦截:用了全局代理时,它对 API 域名的拦截或改写会让连接失败。
- 防火墙:系统或路由器的防火墙挡住了终端程序的联网。
- TLS 协商问题:PowerShell 5.1 默认不一定协商 TLS 1.2,脚本虽已显式开启,但受系统策略或中间人代理影响仍可能失败。
- DNS 解析异常:域名解析不到,同样表现为连不上远端。
- 用错安装地址:照着旧教程走已归档版本的安装路径,地址与新版本不一致。
安装连不上服务器怎么解决
- 先定位断点:关掉当前窗口重开一个终端,执行 kimi --version。能打出 版本号,说明程序已经装好,问题在登录或调用阶段;仍然报错,说明还卡在下载阶段。
- 手动测一次连通性:在 PowerShell 里跑 Test-NetConnection code.kimi.com -Port 443,看 443 端口是否连得上;也可以直接 Invoke-WebRequest -Uri https://code.kimi.com/kimi-code/latest -UseBasicParsing 手动拉一次版本号,把报错缩小到具体域名。
- 按官方三点自检:查公司/学校网络是否限制外部 API;如果开了全局代理,确认它没拦截对 API 域名(api.kimi.com、api.moonshot.cn)的请求;检查系统与路由器防火墙是否放行终端程序。
- 配置代理后重试:Kimi Code 遵循标准代理环境变量,HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 分别对应不同协议的代理,NO_PROXY 用来列绕过代理的主机;同时支持 HTTP(S) 与 SOCKS 代理。设置后重开终端再装。
- 换 npm 方式绕开脚本:先装 Node.js 22.19.0 以上,再执行 npm install -g @moonshot-ai/kimi-code。这条路走的是 npm 源,能绕开安装脚本的下载环节。
- 固定版本再试一次:安装脚本支持用 KIMI_VERSION 指定版本,跳过一次版本解析,能排除"版本号拉取失败"这一类问题。
- 装好 Git for Windows:Windows 上这一步不做,装完也可能在启动时卡在 Shell 环境上。
- 临时排除干扰:把全局代理或安全软件暂时关掉再装一次,确认是不是它们造成的连接失败。
Kimi Code安装报错速查表
下表按报错提示归类,方便直接对照处理:
| | |
|---|
| | 按上一步查网络、代理与防火墙,或改用 npm 安装 |
could not resolve latest version | | 检查代理设置;用 KIMI_VERSION 固定版本后重试 |
| | |
Windows is not supported by install.sh | 在 Windows 上误用了 macOS / Linux 脚本 | |
Alpine / musl Linux is not currently supported | | |
| | |
platform not found in manifest | | |
| | 重开终端;确认安装脚本已把 kimi 加入 PATH |
| | 安装 Git for Windows;非标准路径设 KIMI_SHELL_PATH |
Kimi Code安装与登录注意事项
- 认准新地址:现行安装脚本在 code.kimi.com 下的 /kimi-code/ 路径。旧教程里的地址对应的是已归档的 Python 版 Kimi CLI,两者不是同一个工具。
- 密钥不能靠 export:KIMI_API_KEY、ANTHROPIC_API_KEY、OPENAI_API_KEY 不会从命令行环境变量自动读取,必须写在 config.toml 的供应商段里。例外是 KIMI_MODEL_* 系列和供应商的 api_key_env 字段。
- 代理变量管所有出网流量:设置 HTTP_PROXY 等之后,模型调用、MCP 服务、网络工具、登录与更新检查都会走代理,别只当成下载用的开关。
- 数据放在本机:配置文件、会话、日志默认在 ~/.kimi-code/ 下,需要换位置用 KIMI_CODE_HOME 指定。
- Windows 别省 Git Bash:首次启动前装 Git for Windows,否则可能起不来。
- 只从官方域下载:从官方页面直接进入安装,不要通过第三方下载站或改过的脚本获取,凡要求输入账号密码或支付信息的非官方页面都不要提交信息。
- 登录两条路:装好后在交互界面输入 /login,可选 Kimi Code(OAuth 验证码流程)或平台 API 密钥两种方式。
Kimi Code安装常见问题
Q:报"无法连接到远程服务器"是 Kimi 服务器挂了么?
A:一般不是。这是你本机到下载域名的链路问题,先按网络、代理、防火墙三条排查。
Q:装 Kimi Code 必须先装 Node.js 吗?
A:官方安装脚本这条路不需要;只有走 npm 安装才要求 Node.js 22.19.0 或更高版本。
Q:验证是否装成功了?
A:重开一个终端执行 kimi --version,能打出 版本号就算装好了。
Q:公司网络装不了怎么办?
A:官方帮助文档的常规做法是配一个自建代理,并把代理地址填进配置;直接连不通时改用 npm 方式往往能绕开下载环节。
Q:怎么区分是下载阶段还是登录阶段出的问题?
A:能跑出 kimi --version 说明程序已就位,后续报错就是登录或调用 API 的问题;反之仍在下载阶段。
Q:Windows 上装完启动提示找不到 shell?
A:先装 Git for Windows;如果 Git Bash 装在非标准目录,把 KIMI_SHELL_PATH 设为 bash.exe 的绝对路径。
Q:Alpine 这类系统能用吗?
A:官方脚本目前只发 glibc 二进制,Alpine / musl 系统请改用 Node.js + npm 安装。
Q:安装报错会不会影响账号?
A:不会。下载阶段的报错只跟本机网络有关,账号与额度不受影响,装好后重新登录即可。
Q:装错了或想升级怎么处理?
A:升级直接跑 kimi upgrade;卸载时脚本安装的用户删除 kimi 可执行文件,npm 安装的用户执行 npm uninstall -g @moonshot-ai/kimi-code。
网络环境与代理策略会随你的办公网络和官方支持范围变化,装之前先确认一下本机能正常访问下载域名即可。想持续跟进 Kimi Code安装无法连接到远程服务器 这类接入与排错问题的更新,可以关注本站的 AI 工具栏目,有变化我们会同步。