--- title: "CLI 다운로드" slug: "guide-clichange" tags: ["CLI", "Linux", "Windows"] updated: 2026-06-25T09:10:26Z published: 2026-06-25T09:10:26Z canonical: "cli-fin.ncloud-docs.com/guide-clichange" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # CLI 다운로드 Ncloud CLI를 설치하는 방법을 설명합니다. ## 설치 ### CLI 다운로드 운영체제(Windows, Linux)에 해당하는 CLI 파일을 다운로드해 주십시오. CLI는 항상 최신 버전 상태로 유지해야 정상적인 동작이 가능합니다. | 버전 | 게시 날짜 | 파일 | | --- | --- | --- | | 1.1.30 | 2026-06-25 | [CLI_1.1.30_20260625.zip](https://www.fin-ncloud.com/api/support/download/files/cli/FIN_CLI_1.1.30_20260625.zip) (281 MB)| * 변경 사항: ncloud-api-cli-[version]-SNAPSHOT-jar-with-dependencies 파일 ### 파일 구성 다운로드한 CLI 파일은 Windows 환경용과 Linux 환경용이 있습니다. 두 파일의 구조는 같으며, 환경에 따라 실행 방법이 다릅니다. * jre8: Ncloud CLI는 Java를 이용해서 개발되어 JRE(Java Runtime Environment)가 필요합니다. CLI 폴더에는 JRE 8이 포함되어 있으므로 CLI를 운영하는 환경에서 이미 JRE나 JDK가 설치되어 있을 경우 참고해 주십시오. (Java 1.8 이상에서 구동) * lib: CLI 관련 .jar 파일이 있는 폴더입니다. * ncloud: CLI jar 파일을 실행하기 위한 스크립트 파일입니다. Windows, Linux 환경에 따라 파일 확장자가 상이합니다. :::(Warning) (주의) * CLI 1.0.17 이하 버전에서는 JDK 1.7을 사용했으나 CLI 1.0.18 이후 버전에서는 JDK 1.8을 사용하고 있습니다. 따라서 JDK 1.9 이상 버전에서 구동 시에는 문제가 발생할 수 있습니다. * 내부 JDK 사용 시 스크립트도 변경이 필요합니다. ::: ### 설치 확인 다운로드한 폴더 경로로 이동한 후 `ncloud` 명령어를 실행하여 CLI가 정상적으로 설치되었는지 확인합니다. * Windows ``` cd C:\Users\{username}\Downloads\CLI_1.1.28_20260122\cli_windows ncloud ``` * Linux ``` cd ~/Downloads/CLI_1.1.28_20260122/cli_linux ./ncloud ``` 다음과 같은 메시지가 출력되면 CLI가 정상적으로 설치된 것입니다. ``` ncloud [subcommand] help ncloud: error: The command does not exist. For help, input 'help' command. ``` :::(Info) (참고) 위 메시지는 명령어를 지정하지 않아 출력되는 안내 메시지이며, CLI 설치 오류가 아닙니다. ::: #### 기존 JRE, JDK 연결 포함된 JRE 파일이 아니라 기존 로컬 환경에 이미 설치되어 있는 JRE, JDK를 이용할 경우, ncloud 스크립트 파일에서 `./jre8/bin/java`를 `java`로 변경합니다. 기존 로컬 환경에 JRE 또는 JDK가 설치되어 있어야 합니다. * 수정 전 ```bash #!/bin/bash HOME='./lib' /jre8/bin/java -jar ${HOME}/ncloud-api-cli-1.0.2-SNAPSHOT-jar-with-dependencies.jar $@ ``` * 수정 후 ```bash #!/bin/bash HOME='./lib' java -jar ${HOME}/ncloud-api-cli-1.0.2-SNAPSHOT-jar-with-dependencies.jar $@ ```