한투 자동매매프로그램 – VS Code 개발환경설정

VS Code에서 한국투자증권 자동매매 프로그램 개발을 위한 환경 설정을 단계별로 설명하겠습니다.

1. VS Code 설치 및 기본 설정

1-1. VS Code 다운로드 및 설치

공식 사이트에서 VS Code 다운로드 및 설치
- VS Code 다운로드
설치 과정에서 기본 옵션 유지 후 완료

1-2. Python 및 관련 확장 프로그램 설치

VS Code 실행 후, Extensions (확장) 탭 열기 (Ctrl + Shift + X)
Python 확장 프로그램 검색 후 설치
Jupyter 확장 프로그램도 함께 설치 (데이터 분석 시 활용)

2. Python 개발 환경 설정

2-1. Python 설치

Python 공식 사이트에서 최신 버전 다운로드 및 설치
설치 시 Add Python to PATH 옵션 활성화 후 설치 진행
설치 확인 (터미널 또는 명령 프롬프트에서 실행)
```
python --version
```

2-2. 가상 환경 설정 (권장)

프로젝트 폴더 생성 후 VS Code에서 열기 (File → Open Folder)
VS Code의 터미널 (Ctrl + ~) 열기 후 아래 명령어 실행
```
python -m venv venv
```

가상 환경 활성화:

Windows:
```
venv\Scripts\activate
```
Mac/Linux:
```
source venv/bin/activate
```

3. VS Code 프로젝트 설정

3-1. 프로젝트 폴더 생성

자동매매프로젝트 폴더를 생성하고 VS Code에서 열기

폴더 구조 예시:

자동매매프로젝트/
├── venv/               # 가상 환경 폴더
├── main.py             # 메인 코드
├── config.json         # API 키 저장
├── requirements.txt    # 패키지 리스트
├── logs/               # 로그 파일 저장 폴더
├── strategies/         # 전략 코드 폴더
├── tests/              # 테스트 코드 폴더

3-2. Python 인터프리터 선택

Ctrl + Shift + P (명령 팔레트) 열기
Python: Select Interpreter 선택
venv 폴더 안의 Python 인터프리터 선택

3-3. `settings.json` 수정

VS Code에서 Ctrl + Shift + P → Preferences: Open Settings (JSON) 입력

아래 설정 추가:

{
  "python.defaultInterpreterPath": "venv/bin/python",
  "editor.formatOnSave": true,
  "python.analysis.typeCheckingMode": "basic",
  "terminal.integrated.env.windows": {
      "PYTHONPATH": "${workspaceFolder}"
  }
}

4. 필수 패키지 설치

4-1. `requirements.txt` 생성

requirements.txt 파일을 생성하고 아래 내용 추가:
```
requests
pandas
datetime
websocket-client
```
아래 명령어로 설치:
```
pip install -r requirements.txt
```

5. API 키 및 설정 파일 구성

5-1. `config.json` 파일 생성

API 키를 저장할 config.json 파일 생성:

{
  "APP_KEY": "YOUR_APP_KEY",
  "APP_SECRET": "YOUR_APP_SECRET",
  "BASE_URL": "https://openapi.koreainvestment.com"
}

API 키 보안을 위해 .gitignore 파일에 config.json 추가

6. API 연동 테스트

6-1. API 인증 토큰 테스트

main.py 파일 생성 후 아래 코드 작성:

import requests
import json

# API 설정 로드
with open("config.json", "r") as f:
    config = json.load(f)

APP_KEY = config["APP_KEY"]
APP_SECRET = config["APP_SECRET"]
BASE_URL = config["BASE_URL"]

# 토큰 요청
url = f"{BASE_URL}/oauth2/tokenP"
headers = {"content-type": "application/json"}
body = {
    "grant_type": "client_credentials",
    "appkey": APP_KEY,
    "appsecret": APP_SECRET
}

response = requests.post(url, json=body, headers=headers)
print(response.json())

main.py 실행:
```
python main.py
```
정상적으로 토큰이 반환되면 API 연동 성공

7. GitHub 연동 (선택)

7-1. Git 초기화

git init
git add .
git commit -m "Initial commit"

7-2. GitHub 원격 저장소 연결

git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
git branch -M main
git push -u origin main

8. 디버깅 및 실행 자동화

8-1. VS Code 디버깅 설정

Run → Add Configuration 클릭

.vscode/launch.json 파일에 아래 설정 추가:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
        }
    ]
}

디버깅 시작: F5 키

8-2. 실행 자동화

tasks.json 파일 생성 (.vscode 폴더 내부)

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run main.py",
            "type": "shell",
            "command": "python main.py",
            "problemMatcher": []
        }
    ]
}

실행 방법: Ctrl + Shift + B

9. 프로그램 배포 및 서버 실행 (추후)

AWS, Windows 서버에서 자동 실행 설정
cron 또는 Windows Task Scheduler 활용

최종 요약

VS Code 설치 및 Python 환경 설정
프로젝트 폴더 구성 및 가상 환경 설정
Python 인터프리터 선택 및 설정 (settings.json)
필수 패키지 설치 (requirements.txt)
API 키 관리 (config.json) 및 보안 강화
API 연동 테스트 (main.py)
GitHub 연동 및 코드 관리
VS Code 디버깅 및 자동 실행 설정
배포 및 서버 실행 준비

이제 VS Code에서 한국투자증권 자동매매 프로그램을 개발할 준비가 완료되었습니다! 추가 질문이 있으면 알려주세요.