02-1 개발 도구 설치와 확인
1 / 1
2회 · 첫째 차시第 2 次课 · 第 1 课时

개발 도구 설치와 확인安装并确认开发工具

설치 순서를 외우는 시간이 아닙니다. 각 도구가 왜 필요한지 알고, 직접 실행할 수 있는 상태를 만듭니다.这不是背安装顺序的时间。理解每个工具的用途,并让它们能够实际运行。
이전 차시 · 1-2. 수업 열기
다음 차시 · 2-2. 숫자와 변수로 계산하기
上一课时 · 1-2. 开课
下一课时 · 2-2. 用数字与变量进行计算
2. 준비물2. 准备物02-1

이번 차시는 세 가지 도구를 순서대로 준비한다本课时按顺序准备三样工具

코딩은 특별한 한 프로그램 안에서만 하는 일이 아닙니다. 먼저 컴퓨터에 할 일을 설명할 언어를 준비하고, 코드 작성을 도울 AI 도구를 설치합니다. 마지막에는 파일과 코드를 편하게 볼 글쓰기 도구를 준비합니다.编程并不只发生在某一个特殊程序里。先准备向电脑说明任务的语言,再安装帮助编写代码的 AI 工具。最后准备便于查看文件与代码的书写工具。

Python · 프로그래밍 언어编程语言

1주차에 배운 것처럼, 컴퓨터에 어떤 일을 시킬지 코드로 설명하는 언어입니다. 이번 차시는 Python으로 적은 코드가 실행될 수 있도록 준비합니다.正如第一周所学,它是用代码向电脑说明要做什么的语言。本课时要让用 Python 写的代码能够运行。

OpenCode · 에이전트智能体

자연어 요청을 받아 AI 모델·파일·도구를 연결하고, 코드 작성이나 설명 같은 작업을 진행합니다.接收自然语言请求,连接 AI 模型、文件与工具,并推进编写或说明代码等工作。

VS Code · 편리한 글쓰기 도구便利的书写工具

코드는 글이므로 메모장에도 쓸 수 있고, VS Code만이 유일한 방법도 아닙니다. 다만 여러 파일과 코드, 실행 결과를 한 화면에서 보기 편해 이 수업의 작업 공간으로 사용합니다.代码也是文字,记事本也能写,VS Code 也不是唯一的方法。但它便于在一个画面中查看多个文件、代码与运行结果,因此本课程把它作为工作空间。

2. 준비물 · 셋의 관계2. 准备物 · 三者的关系02-1

세 도구가 서로 어떻게 이어지는가三样工具彼此如何连接

VS Code 작업 공간工作空间
학생学生 요청하고 결과를 읽음提出请求并阅读结果
OpenCode AI·파일·도구를 연결하는 에이전트连接 AI、文件与工具的智能体
Python 컴퓨터가 실행할 코드의 언어电脑执行代码所用的语言
AI 모델AI 模型요청을 받아 실제 답을 만듦接收请求并生成实际回答

에이전트는 사용자의 요청을 받아 AI·파일·도구를 연결하고 작업을 진행하는 프로그램입니다. OpenCode 자체가 AI 모델인 것은 아닙니다.智能体是接收用户请求,连接 AI、文件与工具并推进工作的程序。OpenCode 本身并不是 AI 模型。

준비 순서와 실제 작업 모습准备顺序与实际工作方式

이번 차시는 Python → OpenCode → VS Code 순서로 준비합니다. 준비가 끝난 뒤에는 VS Code에서 파일을 보면서 OpenCode와 대화하고, Python으로 작성된 코드를 실행해 결과를 확인합니다.本课时按 Python → OpenCode → VS Code 的顺序准备。准备完成后,会在 VS Code 中查看文件、与 OpenCode 对话,并执行 Python 代码来确认结果。

2. OpenCode · Node.js 준비2. OpenCode · 准备 Node.js02-1

Node.js가 없을 때만 설치한다仅在没有 Node.js 时安装

Node.js 자체를 배우는 시간이 아닙니다. 지금은 OpenCode를 설치할 때 사용할 npm을 준비하기 위해 설치합니다.这不是学习 Node.js 的时间。现在安装它,是为了准备安装 OpenCode 时要使用的 npm。

Node.js 공식 다운로드 페이지에서 Windows x64 설치 프로그램을 선택한 화면
공식 주소: nodejs.org/en/download · LTS · Windows · x64 · .msi ↗官方网站:nodejs.org/en/download · LTS · Windows · x64 · .msi ↗
Node.js가 없을 때만 설치하기仅在没有 Node.js 时安装
  1. 위 공식 주소에서 LTS · Windows · x64 · Windows Installer(.msi)를 내려받아 실행한다.从上方官网下载安装 LTS · Windows · x64 · Windows Installer(.msi) 并运行。
  2. 기본 선택을 유지하며 Next → Install → Finish 순서로 설치한다.保持默认选项,按 Next → Install → Finish 顺序安装。
  3. PowerShell 창을 완전히 닫고 새로 연다. Node.js와 npm의 버전을 다시 확인한다.完全关闭 PowerShell 窗口并重新打开。再次确认 Node.js 与 npm 的版本。
2. OpenCode · Node.js 준비2. OpenCode · 准备 Node.js02-1

Node.js가 없을 때만 설치한다仅在没有 Node.js 时安装(이어서)(续)

설치 파일을 끝까지 실행했다면 제대로 설치되었는지 확인합니다. PowerShell 창을 새로 열고 아래 두 줄을 입력합니다.安装程序运行完后,确认是否装好了。新打开一个 PowerShell 窗口,输入下面两行。

PowerShell · 새 창에서 다시 확인在新窗口中再次确认
node --version
npm --version
참고 · LTS란?参考 · 什么是 LTS?

Long Term Support, 즉 ‘장기 지원’의 약자입니다. 새 기능을 가장 빨리 받는 버전보다 오랫동안 오류와 보안 문제를 수정해 주는 안정적인 버전입니다. 이 수업에서는 LTS를 선택합니다.Long Term Support 的缩写,意思是“长期支持”。相比最快获得新功能的版本,它会长期修复错误和安全问题,更稳定。本课程选择 LTS。

2. OpenCode · 설치2. OpenCode · 安装02-1

AI와 대화할 OpenCode를 설치한다安装用于和 AI 对话的 OpenCode 실습实践

OpenCode는 코드를 직접 모두 입력하는 대신, 원하는 작업을 자연어로 설명하고 결과를 함께 확인하게 해 주는 도구입니다.OpenCode 让我们用自然语言说明想做的工作,并一起检查结果,而不是亲手输入所有代码。

PowerShell
npm install -g opencode-ai

설치가 끝나면 PowerShell 창을 완전히 닫고 새로 엽니다. 새 창에서 세 프로그램을 다시 확인합니다.安装完成后,完全关闭 PowerShell 窗口并重新打开。在新窗口中再次确认三个程序。

PowerShell · 설치 후 최종 확인安装后的最终确认
node --version
npm --version
opencode --version

npm은 Node.js와 함께 설치된 도구입니다. 이번 차시는 이름과 역할만 알고, 사용법을 따로 외우지 않습니다. opencode --version에서 버전 번호가 보이면 VS Code 단계로 갑니다. CommandNotFoundException이 보이면 다음 쪽으로 갑니다.npm 是随 Node.js 一起安装的工具。本课时只需知道名称和作用,不必另外背使用方法。如果 opencode --version 显示版本号,就进入 VS Code 步骤。如果出现 CommandNotFoundException,请进入下一页。

2. OpenCode · 다른 오류 구분2. OpenCode · 区分其他错误02-1

오류 문장이 다르면 해결 명령도 다르다错误信息不同,解决命令也不同

CommandNotFoundException을 해결하는 PATH 명령과 아래의 스크립트 실행 정책 명령은 서로 다릅니다. 아래와 같은 차단 문장이 실제로 나온 학생만 실행합니다.用于解决 CommandNotFoundException 的 PATH 命令,与下面的脚本执行策略命令不同。只有实际出现下面拦截信息的学生才执行。

오류가 실제로 나타날 때만 실행한다仅在实际出现错误时执行

npm.ps1 cannot be loaded because running scripts is disabled와 같은 차단 메시지가 나오면 아래 명령을 한 번 입력합니다.若出现 npm.ps1 cannot be loaded because running scripts is disabled 等拦截信息,只需输入一次下面的命令。

PowerShell · 스크립트 실행이 차단된 경우에만仅在脚本被阻止时
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
차단을 풀고 다시 확인하기解除阻止后再次确认
  1. 확인 질문이 나오면 Y를 입력하고 Enter를 누른다.出现确认问题时输入 Y 并按 Enter。
  2. PowerShell을 완전히 닫았다가 새로 연다.完全关闭 PowerShell 后重新打开。
  3. 앞쪽의 OpenCode 설치 명령과 버전 확인을 다시 진행한다.重新执行前一页的 OpenCode 安装命令并确认版本。
여기서 더 낮추지 않는다不要继续降低安全设置

같은 차단 메시지가 계속 나오면 보안 설정을 더 바꾸지 말고 화면을 그대로 교사에게 보여 줍니다.如果仍出现同样的阻止信息,不要继续更改安全设置,请把当前画面直接给老师看。

3. VS Code · 화면3. VS Code · 画面02-1

화면의 네 부분부터 찾는다先找到画面的四个部分

처음부터 모든 메뉴를 외울 필요는 없습니다. 이번 수업에서 계속 사용할 네 부분만 찾습니다.不需要一开始就记住所有菜单。先找到本课程会持续使用的四个部分。

1. 탐색기资源管理器폴더와 파일을 찾는다.查找文件夹与文件。
2. 편집기编辑器파일의 글과 코드를 읽는다.阅读文件中的文字和代码。
3. 터미널终端명령을 입력하고 결과를 본다.输入命令并查看结果。
4. 확장扩展VS Code에 필요한 기능을 더한다.为 VS Code 添加所需功能。
이번 차시에 실제로 사용할 곳本课时实际使用的位置

이번 차시에는 확장에서 두 가지 도구를 설치하고, 터미널을 여는 방법을 익힙니다. 탐색기와 편집기는 다음 차시부터 실제 파일을 받을 때 사용합니다.本课时会在扩展中安装两个工具,并学习打开终端的方法。资源管理器与编辑器从下一课收到实际文件后再使用。

4. OpenCode · 실행과 연결4. OpenCode · 运行与连接02-1

VS Code 안에서 OpenCode와 AI 모델을 연결한다在 VS Code 中连接 OpenCode 与 AI 模型 실습实践

OpenCode 프로그램만 설치해서는 아직 AI와 대화할 수 없습니다. OpenCode는 대화 창구이고, 실제로 답을 만드는 AI 모델 제공자를 한 번 연결해야 합니다.只安装 OpenCode 程序还不能与 AI 对话。OpenCode 是对话窗口,还需要连接一个真正生成回答的 AI 模型提供方。

VS Code에서 OpenCode 실행하기在 VS Code 中运行 OpenCode
  1. 위 메뉴에서 터미널 → 새 터미널을 누른다.从上方菜单选择终端 → 新建终端。
  2. 열린 터미널에 opencode를 입력해 OpenCode 화면을 연다.在打开的终端中输入 opencode,打开 OpenCode 画面。
  3. OpenCode 안에서 /connect를 입력하고 OpenCode Zen (Recommended)을 선택한다.在 OpenCode 中输入 /connect,选择 OpenCode Zen (Recommended)。
VS Code · Terminal
opencode
OpenCode
/connect
4. OpenCode · 실행과 연결4. OpenCode · 运行与连接02-1

VS Code 안에서 OpenCode와 AI 모델을 연결한다在 VS Code 中连接 OpenCode 与 AI 模型(이어서)(续)

/connect를 입력하면 아래 그림 같은 화면이 나옵니다. 그림 속 순서대로 수업용 AI 제공자를 고릅니다.输入 /connect 后,会出现下图那样的画面。按图中的顺序选择课堂用的 AI 提供方。

VS Code 터미널의 OpenCode에서 connect 명령을 입력하고 수업용 제공자를 선택하는 실제 화면
실제 VS Code 화면에서 수업용 AI 제공자 연결 시작하기在真实 VS Code 画面中开始连接课程使用的 AI 提供方
5. 첫 대화5. 第一次对话02-1

첫 대화로 연결을 확인한다用第一次对话确认连接 실습实践

모델 연결이 끝나면 짧은 첫 요청을 보내고 OpenCode가 응답하는지 확인합니다.模型连接完成后发送简短的第一次请求,确认 OpenCode 能否回答。

첫 요청第一次请求
이 수업에서 OpenCode가 도울 수 있는 일을 세 가지만 알려 줘.
告诉我在这门课上 OpenCode 能帮忙做的三件事。
내 요청我的请求도울 수 있는 일 세 가지만 질문只询问三项可提供的帮助
↓
OpenCode연결된 AI 모델의 답을 보여 줌显示已连接 AI 模型的回答
↓
사람의 확인人的确认응답이 왔는지 확인确认是否收到回答
첫 요청에서 확인할 것第一次请求要确认的内容

OpenCode가 응답하는지, 답이 세 가지 항목으로 나뉘었는지 확인합니다. 첫 요청은 연결 상태와 요청한 형식을 확인하는 짧은 대화입니다.确认 OpenCode 是否回答,以及回答是否分为三个项目。第一次请求用于确认连接状态与请求格式。

6. 정리6. 小结02-1

설치보다 중요한 것은 역할과 상태다比安装更重要的是作用与状态

준비 완료 확인确认准备完成
  • python --version에서 Python의 버전 번호가 보인다.python --version 显示 Python 的版本号。
  • node --version과 npm --version에서 숫자가 보인다.node --version 与 npm --version 显示版本号。
  • opencode --version에서 숫자가 보인다.opencode --version 显示版本号。
  • VS Code에서 Microsoft의 Korean Language Pack과 Python 확장이 설치되어 있다.VS Code 中已安装 Microsoft 的 Korean Language Pack 与 Python 扩展。
  • OpenCode에 수업용 제공자와 교사가 지정한 모델을 연결했다.已在 OpenCode 中连接课程提供方并选择老师指定的模型。
  • VS Code 터미널에서 OpenCode의 첫 응답을 확인했다.已在 VS Code 终端确认 OpenCode 的第一次回答。
이번 차시에서 기억할 문장本课时要记住的一句话

CLI는 무서운 검은 화면이 아니라, 컴퓨터와 AI에게 짧은 문장으로 요청하고 응답을 읽는 창이다.CLI 不是可怕的黑色画面,而是用短句向电脑和 AI 提出请求并阅读回应的窗口。

다음 차시下一课时

환경 점검이 끝났습니다. 다음에는 준비된 Python 파일을 읽고 실행하면서 숫자·글자·변수·계산이 어떻게 정보가 되는지 살펴봅니다.环境检查完成。下一课将读取并运行准备好的 Python 文件,观察数字、文字、变量与计算如何表达信息。