AI/Claude Code Doc(공식문서) 번역본

Claude Code 공식문서 리뷰 - Outside of the terminal[2] : Visual Studio Code, JetBrains IDESs, Github Actions, Gitlab CI/CD, Claude Code in Slack

안녕하세요! 갓대희입니다.

Claude Code Docs 공식 문서 >> Outside of the terminal 섹션의 내용 중 3가지를 살펴 보려고 합니다.

(Claude Code on the web, Claude Code on desktop, Chrome extension)

이 카테고리의 글은 편하게 공식 문서 위주의 내용을 눈으로 쭉 살펴 보고 넘어가는 목적을 갖고 시작 하게 되었습니다.

저도 초심으로 돌아가 기초적읜 글을 살펴보다보니, 지금와서 클로드에서 강조 하고자 하는 원칙이 어떤건지 되돌아볼 수 있는 계기가 되기도 하는 것 같아, 다른 분들도 꼭 한번 눈으로라도 이해 하고 넘어가는것이 좋다고 생각하여 공식 문서의 내용을 억지로 리뷰해보게 되었습니다.

이 글의 구성

~~Claude Code on the web~~
~~Claude Code on desktop~~
~~Chrome extension~~
Visual Studio Code
JetBrains IDESs
Github Actions
Gitlab CI/CD
Claude Code in Slack

4. Visual Studio Code

원문 : https://code.claude.com/docs/en/vs-code

VS Code에서 Claude Code 사용하기
VS Code 확장 프로그램을 통해 Claude Code를 IDE에서 직접 사용할 수 있다. 터미널 CLI 없이도 파일 편집, 코드 리뷰, 대화 기록 관리 등 Claude Code의 모든 기능을 IDE 내에서 활용할 수 있다.

개요

Claude Code는 VS Code에 직접 통합된 네이티브 그래픽 인터페이스를 제공한다. VS Code에서 Claude Code를 사용하는 권장 방법이다.

주요 기능

기능	설명
계획 검토 및 편집	Claude의 계획을 수락 전에 검토하고 편집
자동 수락	편집이 이루어지는 대로 자동 수락
@-멘션	선택 영역에서 특정 줄 범위로 파일 참조
대화 기록	이전 대화에 접근
다중 대화	별도 탭이나 창에서 여러 대화 열기
인라인 diff	코드 변경사항 인라인 비교

사전 요구사항

요구사항	설명
VS Code 버전	1.98.0 이상
Anthropic 계정	확장 프로그램 처음 열 때 로그인
CLI	필수 아님 (단, MCP 서버 설정 등 일부 기능에 필요)

초보자 팁
CLI를 먼저 설치하지 않아도 된다. VS Code 확장만으로 대부분의 기능을 사용할 수 있다.

설치

직접 설치 링크

에디터	설치 링크
VS Code	`vscode:extension/anthropic.claude-code`
Cursor	`cursor:extension/anthropic.claude-code`

Extensions 뷰에서 설치

설치 단계

Cmd+Shift+X (Mac) 또는 Ctrl+Shift+X (Windows/Linux) 누르기
"Claude Code" 검색
Install 클릭
VS Code 재시작 또는 "Developer: Reload Window" 실행

시작하기

Claude Code 열기

에디터 툴바 방법 (가장 빠름): 파일이 열려 있을 때 에디터 오른쪽 상단의 스파크 아이콘 클릭

대안 방법	단계
명령 팔레트	`Cmd+Shift+P` / `Ctrl+Shift+P` → "Claude Code" 입력
상태 바	오른쪽 하단의 ✱ Claude Code 클릭 (파일 없어도 작동)

기본 워크플로우

프롬프트 전송 → Claude에게 코드, 디버깅, 변경 요청
텍스트 선택 → Alt+K로 파일 경로와 줄 번호 @-멘션 삽입
변경 검토 → Claude가 diff 표시, 편집 권한 요청
수락/거부 → 변경 승인 또는 대안 지시

VS Code 명령어 및 단축키

주요 단축키

명령	Mac	Windows/Linux	설명
입력 포커스	`Cmd+Esc`	`Ctrl+Esc`	에디터와 Claude 간 포커스 전환
새 탭에서 열기	`Cmd+Shift+Esc`	`Ctrl+Shift+Esc`	새 대화를 탭으로 열기
새 대화	`Cmd+N`	`Ctrl+N`	새 대화 시작 (Claude 포커스 시)
@-멘션 삽입	`Alt+K`	`Alt+K`	파일 참조와 줄 번호 삽입

실전 팁
Alt+K 단축키를 자주 사용하자. 선택한 코드의 파일 경로와 줄 번호가 자동으로 삽입되어 Claude가 정확한 컨텍스트를 파악할 수 있다.

기타 명령

명령	설명
Open in Side Bar	왼쪽 사이드바에서 열기
Open in Terminal	터미널 모드로 열기
Open in New Window	별도 창에서 새 대화 열기
Show Logs	확장 프로그램 디버그 로그 보기
Logout	계정에서 로그아웃

커스터마이징

레이아웃 변경

Claude 패널을 드래그하여 원하는 위치로 이동할 수 있다:

위치	설명
Secondary sidebar	기본 오른쪽
Primary sidebar	Explorer/Search와 함께 왼쪽
Editor area	파일과 함께 탭으로

터미널 모드로 전환

설정 열기 (Cmd+, 또는 Ctrl+,)
Extensions → Claude Code로 이동
Use Terminal 체크

VS Code 확장 vs CLI

기능 비교

기능	CLI	VS Code 확장
슬래시 명령	전체	일부
MCP 서버 설정	O	X (CLI에서 설정)
체크포인트	O	지원 예정
`!` bash 단축키	O	X
탭 자동 완성	O	X

VS Code에서 CLI 실행

통합 터미널 열기: Ctrl+` (Windows/Linux) 또는 Cmd+` (Mac)
claude 실행
CLI가 자동으로 IDE와 통합되어 diff 및 진단 제공

확장과 CLI 간 전환
터미널에서 claude --resume을 실행하면 대화형 선택기로 확장 대화를 CLI에서 계속할 수 있다.

보안 고려사항

자동 편집 경고
Claude Code는 VS Code 설정 파일(settings.json, tasks.json)을 수정할 수 있으며, VS Code가 이를 자동 실행하여 권한 프롬프트를 우회할 수 있다.

위험 완화 방법

방법	설명
Restricted Mode	신뢰할 수 없는 워크스페이스에서 제한 모드 활성화
수동 승인	자동 수락 대신 수동 승인 모드 사용
변경 검토	수락 전 변경사항을 신중하게 검토

문제 해결

확장 프로그램이 설치되지 않음

VS Code 1.98.0 이상인지 확인
VS Code가 확장 설치 권한이 있는지 확인
Marketplace 웹사이트에서 설치 시도

스파크 아이콘이 보이지 않음

해결 방법	설명
파일 열기	아이콘은 열린 파일이 필요
VS Code 버전 확인	Help → About (1.98.0+ 필요)
VS Code 재시작	"Developer: Reload Window" 실행
충돌 확장 비활성화	다른 AI 확장을 일시적으로 비활성화

대안: 상태 바의 "✱ Claude Code" 클릭 또는 명령 팔레트 사용

Claude Code가 응답하지 않음

인터넷 연결 확인
새 대화 시작
CLI 시도: 터미널에서 claude 실행하여 상세 오류 확인
GitHub에서 버그 리포트

제거

Extensions 열기 (Cmd+Shift+X 또는 Ctrl+Shift+X)
"Claude Code" 검색
Uninstall 클릭

모든 데이터 제거:

rm -rf ~/.vscode/globalStorage/anthropic.claude-code

참고 자료

원본 문서 (영문) - Claude Code 공식 문서
일반 워크플로우 - 일반적인 사용 패턴
MCP 서버 설정 - Claude 기능 확장
JetBrains IDE - IntelliJ, PyCharm 등과의 통합

5. JetBrains IDESs

원문 : https://code.claude.com/docs/en/jetbrains

JetBrains IDE에서 Claude Code 사용하기
IntelliJ, PyCharm, WebStorm 등 JetBrains 제품군에서 Claude Code를 통합하여 사용하는 방법을 설명한다. 전용 플러그인을 통해 대화형 diff 뷰어, 선택 컨텍스트 공유, IDE 네이티브 기능을 활용할 수 있다.

지원 IDE

Claude Code 플러그인은 다음 JetBrains IDE에서 사용할 수 있다.

IDE	지원 여부
IntelliJ IDEA	지원
PyCharm	지원
Android Studio	지원
WebStorm	지원
PhpStorm	지원
GoLand	지원

참고: 모든 JetBrains IDE에서 동일한 플러그인을 사용한다. 사용 중인 IDE가 목록에 있다면 같은 설치 방법을 따르면 된다.

주요 기능

빠른 실행 단축키

플랫폼	단축키	설명
Mac	`Cmd+Esc`	에디터에서 Claude Code 열기
Windows/Linux	`Ctrl+Esc`	에디터에서 Claude Code 열기

파일 참조 단축키

플랫폼	단축키	결과
Mac	`Cmd+Option+K`	파일 참조 삽입 (예: @File#L1-99)
Windows/Linux	`Alt+Ctrl+K`	파일 참조 삽입 (예: @File#L1-99)

통합 기능

기능	설명
Diff 뷰어	코드 변경사항이 터미널 대신 IDE diff 뷰어에 표시된다
선택 컨텍스트	현재 IDE 선택/탭이 Claude Code와 자동 공유된다
진단 공유	IDE 린트, 구문, 기타 진단 오류가 Claude와 자동 공유된다

실전 팁: IDE의 진단 기능(빨간 밑줄, 경고)이 자동으로 Claude에게 공유되므로, 오류가 있는 파일을 열어두면 Claude가 더 정확하게 문제를 파악할 수 있다.

설치

마켓플레이스에서 설치

JetBrains 마켓플레이스에서 Claude Code 플러그인을 찾아 설치
IDE를 완전히 재시작 (여러 번 재시작이 필요할 수 있음)
Claude Code CLI가 이미 설치되어 있는지 확인

설치 흐름

1. Claude Code CLI 설치 (npm install -g @anthropic-ai/claude-code)
        ↓
2. JetBrains 플러그인 설치 (마켓플레이스)
        ↓
3. IDE 재시작
        ↓
4. 통합 터미널에서 claude 실행

사용법

IDE에서 사용

IDE의 통합 터미널에서 claude를 실행하면 모든 통합 기능이 활성화된다.

외부 터미널에서 사용

/ide 명령으로 Claude Code를 JetBrains IDE에 연결할 수 있다.

claude
> /ide

중요: Claude Code를 IDE 프로젝트 루트와 같은 디렉토리에서 시작해야 같은 파일에 접근할 수 있다.

설정

Claude Code 설정

claude 실행
/config 명령 입력
diff 도구를 auto로 설정하여 IDE 자동 감지

플러그인 설정

Settings → Tools → Claude Code [Beta]로 이동하여 다음 설정을 조정할 수 있다.

일반 설정

설정	설명
Claude command	커스텀 명령 지정 (예: claude, /usr/local/bin/claude, npx @anthropic/claude)
Suppress notification	Claude 명령을 찾을 수 없을 때 알림 건너뛰기
Enable Option+Enter	macOS에서 Option+Enter로 새 줄 삽입. Option 키 캡처 문제 시 비활성화
Enable automatic updates	플러그인 자동 업데이트 확인 및 설치 (재시작 시 적용)

WSL 설정

WSL 사용자는 Claude 명령을 다음과 같이 설정한다.

wsl -d Ubuntu -- bash -lic "claude"

참고: Ubuntu를 실제 WSL 배포판 이름으로 변경한다.

ESC 키 설정

ESC가 Claude Code 작업을 중단하지 않는 경우 다음과 같이 설정한다.

Settings → Tools → Terminal로 이동
다음 중 하나를 수행:
- "Move focus to the editor with Escape" 체크 해제
- "Configure terminal keybindings"에서 "Switch focus to Editor" 단축키 삭제
변경사항 적용

특수 설정

원격 개발

항목	설명
설치 위치	Settings → Plugin (Host)를 통해 원격 호스트에 설치
주의	로컬 클라이언트 머신이 아닌 원격 호스트에 설치해야 함

WSL 추가 설정

WSL 사용자는 다음 추가 설정이 필요할 수 있다.

적절한 터미널 설정
네트워킹 모드 조정
방화벽 설정 업데이트

문제 해결

플러그인이 작동하지 않음

확인 사항	해결 방법
디렉토리	프로젝트 루트 디렉토리에서 Claude Code 실행
플러그인 상태	IDE 설정에서 플러그인 활성화 확인
IDE 재시작	IDE 완전히 재시작 (여러 번 필요할 수 있음)
원격 개발	원격 호스트에 플러그인 설치 확인

IDE가 감지되지 않음

확인 사항	해결 방법
플러그인	설치 및 활성화 확인
재시작	IDE 완전히 재시작
터미널	통합 터미널에서 Claude Code 실행 확인
WSL	WSL 문제 해결 가이드 참조

명령을 찾을 수 없음

Claude 아이콘 클릭 시 "command not found"가 표시되면 다음을 확인한다.

Claude Code 설치 확인:
```
npm list -g @anthropic-ai/claude-code
```
플러그인 설정에서 Claude 명령 경로 설정
WSL 사용자: WSL 명령 형식 사용

보안 고려사항

경고: Claude Code가 자동 편집 권한이 활성화된 JetBrains IDE에서 실행될 때, 자동 실행될 수 있는 IDE 설정 파일을 수정할 수 있으며, bash 실행에 대한 Claude Code의 권한 프롬프트를 우회할 수 있다.

권장 사항

권장 사항	설명
수동 승인 모드	편집에 대해 수동 승인 모드 사용
신뢰할 수 있는 프롬프트	신뢰할 수 있는 프롬프트에서만 Claude 사용
파일 접근 인식	Claude Code가 수정할 수 있는 파일 파악

VS Code vs JetBrains 비교

기능	VS Code	JetBrains
플러그인/확장	확장 프로그램	플러그인
파일 참조 단축키	Alt+K	Cmd/Ctrl+Alt+K
열기 단축키	Cmd/Ctrl+Esc	Cmd/Ctrl+Esc
Diff 뷰어	지원	지원
진단 공유	지원	지원
MCP 설정	확장에서 불가	플러그인에서 불가

참고 자료

6. Github Actions

원문 : https://code.claude.com/docs/en/github-actions

GitHub Actions와 Claude Code 통합

핵심 기능: PR/이슈에서 @claude 멘션으로 AI 자동화
지원 기능: 코드 분석, PR 생성, 기능 구현, 버그 수정
지원 플랫폼: Claude API, AWS Bedrock, Google Vertex AI
설정 방식: GitHub App 설치 + 워크플로우 파일

개요

Claude Code GitHub Actions는 GitHub 워크플로우에 AI 기반 자동화를 제공한다. PR이나 이슈에서 간단히 @claude를 멘션하면 Claude가 프로젝트 표준을 따르면서 코드를 분석하고, PR을 생성하며, 기능을 구현하고, 버그를 수정한다.

참고
Claude Opus 4.5를 사용할 수 있다. 기본값은 Sonnet이며, Opus 4.5를 사용하려면 모델 파라미터를 claude-opus-4-5-20251101로 설정한다.

주요 기능

기능	설명
즉시 PR 생성	필요한 내용을 설명하면 Claude가 완전한 PR 생성
자동화된 코드 구현	단일 명령으로 이슈를 작동하는 코드로 변환
표준 준수	CLAUDE.md 가이드라인과 기존 코드 패턴 존중
간단한 설정	몇 분 내에 시작 가능
기본 보안	코드가 GitHub 러너에서만 실행

설정 방법

빠른 설정 (권장)

Claude Code 터미널에서 다음 명령을 실행한다:

/install-github-app

이 명령은 다음을 안내한다:

GitHub 앱 설정
필수 시크릿 추가

요구사항:

저장소 관리자여야 함
GitHub 앱은 Contents, Issues, Pull requests에 대한 읽기 및 쓰기 권한 요청
직접 Claude API 사용자만 가능 (AWS Bedrock 또는 Google Vertex AI 아님)

ex)

- 권한 설정 후 CLI 에서 계속 진행

선택 항목

- @Claude Code 이슈(Issues)와 PR 댓글에서 @claude 태그를 사용

- Claude Code Review 새로운 PR에 대해 자동 코드 리뷰 수행

선택 항목

- Create a long-lived token with your Claude subscription Claude 구독을 사용해 장기 사용 토큰(long-lived token) 생성

- Enter a new API key 새로운 API 키 입력

- 신규 PR 생성

ex) 내용 번역

## 🤖 Claude Code GitHub App 설치

이 PR은 우리 저장소(repository)에 Claude Code 연동을 활성화하는 GitHub Actions 워크플로우를 추가합니다.

### Claude Code란?

[Claude Code](https://claude.com/claude-code)는 다음과 같은 작업을 도와주는 AI 코딩 에이전트입니다:
- 버그 수정 및 개선
- 문서 업데이트
- 신규 기능 구현
- 코드 리뷰 및 개선 제안
- 테스트 코드 작성
- 그 외 다양한 작업

### 동작 방식

이 PR이 머지(merge)되면, PR이나 이슈 댓글에서 `@claude`를 멘션하여 Claude와 상호작용할 수 있습니다.  
워크플로우가 트리거되면, Claude는 해당 댓글과 주변 컨텍스트를 분석하고 GitHub Action 내에서 요청을 수행합니다.

### 중요 안내 사항

- **이 워크플로우는 이 PR이 머지되기 전까지는 동작하지 않습니다**
- **머지가 완료되기 전까지는 `@claude` 멘션이 작동하지 않습니다**
- PR 또는 이슈 댓글에서 Claude가 멘션될 때마다 워크플로우가 자동 실행됩니다
- Claude는 파일, diff, 이전 댓글을 포함한 전체 PR/이슈 컨텍스트에 접근할 수 있습니다

### 보안(Security)

- Anthropic API 키는 GitHub Actions secret으로 안전하게 저장됩니다
- 저장소에 write 권한이 있는 사용자만 워크플로우를 실행할 수 있습니다
- 모든 Claude 실행 내역은 GitHub Actions 실행 기록(run history)에 저장됩니다
- Claude의 기본 도구 권한은 파일 읽기/쓰기 및 댓글, 브랜치, 커밋 생성 등 저장소 상호작용으로 제한됩니다
- 아래와 같이 워크플로우 파일에 허용 도구를 추가하여 더 많은 권한을 부여할 수 있습니다:

```
자세한 내용은 [Claude Code action 저장소](https://github.com/anthropics/claude-code-action)에서 확인할 수 있습니다.
이 PR을 머지한 후, 아무 PR이나 이슈 댓글에서 `@claude`를 멘션해서 바로 시작해보세요!

```

- 이후 @claude 를 태그하여 이슈 댓글에서 사용 가능하다.

수동 설정

설정 흐름

1. GitHub App 설치 (https://github.com/apps/claude)
    ↓
2. API 키 시크릿 추가 (ANTHROPIC_API_KEY)
    ↓
3. 워크플로우 파일 복사 (.github/workflows/)
    ↓
4. PR/이슈에서 @claude 멘션하여 사용

1단계: Claude GitHub App 설치

방문: https://github.com/apps/claude
필요한 권한: Contents, Issues, Pull requests (읽기 및 쓰기)

2단계: 저장소 시크릿에 ANTHROPIC_API_KEY 추가

Settings → Secrets and variables → Actions
ANTHROPIC_API_KEY라는 새 시크릿 생성

3단계: 워크플로우 파일 복사

소스: examples/claude.yml
대상: .github/workflows/

Beta에서 v1.0으로 업그레이드

필수 변경사항

이전 Beta 입력	새로운 v1.0 입력
`mode`	(제거됨 - 자동 감지)
`direct_prompt`	`prompt`
`custom_instructions`	`claude_args: --system-prompt`
`max_turns`	`claude_args: --max-turns`
`model`	`claude_args: --model`

변경 전후 예시

Beta 버전:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "보안 이슈에 대해 이 PR을 검토해"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "코딩 표준을 따라"
    max_turns: "10"
    model: "claude-sonnet-4-5-20250929"

GA 버전 (v1.0):

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "보안 이슈에 대해 이 PR을 검토해"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --system-prompt "코딩 표준을 따라"
      --max-turns 10
      --model claude-sonnet-4-5-20250929

워크플로우 예제

기본 워크플로우

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # 댓글에서 @claude 멘션에 응답

코드 리뷰 워크플로우

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"

커스텀 자동화 (프롬프트 사용)

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "어제의 커밋과 열린 이슈 요약 생성"
          claude_args: "--model claude-opus-4-5-20251101"

댓글에서 일반적인 사용 사례

@claude 이슈 설명을 기반으로 이 기능을 구현해
@claude 이 엔드포인트에 대해 사용자 인증을 어떻게 구현해야 해?
@claude 사용자 대시보드 컴포넌트의 TypeError를 수정해

실전 팁
구체적인 요청일수록 Claude의 응답이 정확하다. "코드를 개선해" 대신 "이 함수의 성능을 최적화하고 타입 안전성을 추가해"처럼 구체적으로 요청하자.

액션 파라미터

파라미터	설명	필수
`prompt`	Claude에 대한 지침 (텍스트 또는 슬래시 명령)	아니오*
`claude_args`	Claude Code에 전달되는 CLI 인자	아니오
`anthropic_api_key`	Claude API 키	예**
`github_token`	API 접근을 위한 GitHub 토큰	아니오
`trigger_phrase`	커스텀 트리거 문구 (기본: "@claude")	아니오
`use_bedrock`	Claude API 대신 AWS Bedrock 사용	아니오
`use_vertex`	Claude API 대신 Google Vertex AI 사용	아니오

* 이슈/PR 댓글에서 생략 시 프롬프트 선택적; Claude가 트리거 문구에 응답
** 직접 Claude API에 필수, Bedrock/Vertex에는 불필요

CLI 인자 전달

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929 --mcp-config /path/to/config.json"

일반적인 인자

인자	설명
`--max-turns`	최대 대화 턴 수 (기본: 10)
`--model`	사용할 모델
`--mcp-config`	MCP 설정 경로
`--allowed-tools`	허용된 도구 쉼표 구분 목록
`--debug`	디버그 출력 활성화

AWS Bedrock 통합

사전 요구사항

Claude 모델 권한이 있는 Amazon Bedrock 활성화
AWS에서 GitHub OIDC Identity Provider 구성
Bedrock 권한이 있는 IAM 역할

워크플로우 예제

name: Claude PR Action

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    env:
      AWS_REGION: us-west-2
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Configure AWS Credentials (OIDC)
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
          aws-region: us-west-2

      - uses: anthropics/claude-code-action@v1
        with:
          github_token: ${{ steps.app-token.outputs.token }}
          use_bedrock: "true"
          claude_args: '--model us.anthropic.claude-sonnet-4-5-20250929-v1:0 --max-turns 10'

필수 시크릿

시크릿	설명
`AWS_ROLE_TO_ASSUME`	Bedrock 접근을 위한 IAM 역할 ARN
`APP_ID`	GitHub App ID
`APP_PRIVATE_KEY`	GitHub App의 프라이빗 키 (.pem)

Google Vertex AI 통합

사전 요구사항

Google Cloud 프로젝트에서 Vertex AI API 활성화
GitHub용 Workload Identity Federation 구성
Vertex AI 권한이 있는 서비스 계정

워크플로우 예제

name: Claude PR Action

permissions:
  contents: write
  pull-requests: write
  issues: write
  id-token: write

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude-pr:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Generate GitHub App token
        id: app-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.APP_ID }}
          private-key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Authenticate to Google Cloud
        id: auth
        uses: google-github-actions/auth@v2
        with:
          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
          service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

      - uses: anthropics/claude-code-action@v1
        with:
          github_token: ${{ steps.app-token.outputs.token }}
          trigger_phrase: "@claude"
          use_vertex: "true"
          claude_args: '--model claude-sonnet-4@20250514 --max-turns 10'
        env:
          ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
          CLOUD_ML_REGION: us-east5
          VERTEX_REGION_CLAUDE_3_7_SONNET: us-east5

필수 시크릿

시크릿	설명
`GCP_WORKLOAD_IDENTITY_PROVIDER`	Workload identity provider 리소스 이름
`GCP_SERVICE_ACCOUNT`	서비스 계정 이메일
`APP_ID`	GitHub App ID
`APP_PRIVATE_KEY`	GitHub App의 프라이빗 키

모범 사례

CLAUDE.md 설정

저장소 루트에 CLAUDE.md 파일을 생성하여 정의:

코드 스타일 가이드라인
리뷰 기준
프로젝트별 규칙
선호하는 패턴

Claude는 PR 생성 및 요청 응답 시 이 가이드라인을 따른다.

보안 고려사항

경고
API 키를 저장소에 직접 커밋하지 마세요.

항상 GitHub Secrets 사용:

API 키를 저장소 시크릿으로 추가: ANTHROPIC_API_KEY
워크플로우에서 참조: ${{ secrets.ANTHROPIC_API_KEY }}
액션 권한을 필요한 것만으로 제한
병합 전 Claude의 제안 검토

성능 최적화

최적화	설명
이슈 템플릿	컨텍스트를 제공하는 템플릿 사용
CLAUDE.md	간결하고 집중된 내용 유지
타임아웃	워크플로우에 적절한 타임아웃 설정

비용 관리

GitHub Actions 비용:

Claude Code는 GitHub 호스팅 러너에서 실행되어 Actions 분을 소비
GitHub 결제 문서 참조

API 비용:

각 Claude 상호작용은 프롬프트/응답 길이에 따라 토큰 소비
토큰 사용량은 작업 복잡성과 코드베이스 크기에 따라 다름
Claude 가격 페이지 참조

비용 최적화 팁:

팁	설명
특정 명령 사용	불필요한 API 호출 감소
max-turns 설정	claude_args에서 적절한 값 설정
타임아웃 설정	워크플로우 수준 타임아웃으로 런어웨이 작업 방지
동시성 제어	GitHub 동시성 컨트롤로 병렬 실행 제한

문제 해결

Claude가 @claude 명령에 응답하지 않음

확인 사항	해결 방법
GitHub App	올바르게 설치되었는지 확인
워크플로우	활성화되어 있는지 확인
API 키	저장소 시크릿에 설정되어 있는지 확인
멘션 형식	/claude가 아닌 @claude 사용 확인

CI가 Claude의 커밋에서 실행되지 않음

확인 사항	해결 방법
사용자 유형	GitHub App 또는 커스텀 앱 사용 (Actions 사용자 아님)
트리거	워크플로우 트리거에 필요한 이벤트 포함 확인
권한	앱 권한에 CI 트리거 포함 확인

인증 오류

확인 사항	해결 방법
API 키	충분한 권한으로 유효한지 확인
Bedrock/Vertex	자격 증명 설정 확인
시크릿 이름	워크플로우에서 올바르게 명명되었는지 확인

7. Gitlab CI/CD

원문 : https://code.claude.com/docs/en/gitlab-ci-cd

GitLab CI/CD와 Claude Code 통합

핵심 기능: MR/이슈에서 @claude 멘션으로 AI 자동화
지원 기능: MR 생성, 코드 구현, 버그 수정
지원 플랫폼: Claude API, AWS Bedrock, Google Vertex AI
상태: 베타 (GitLab 유지보수)

개요

Claude Code for GitLab CI/CD는 현재 베타 상태이며, GitLab 파이프라인 내에서 AI 기반 자동화를 가능하게 한다. GitLab에서 유지보수하고 Claude Code CLI 및 SDK를 기반으로 프로그래밍 방식 사용을 위해 구축되었다.

주요 기능

기능	설명
즉시 MR 생성	요구사항을 설명하면 Claude가 변경사항이 포함된 완전한 MR 제안
자동화된 구현	단일 명령으로 이슈를 작동하는 코드로 변환
프로젝트 인식	CLAUDE.md 가이드라인과 기존 코드 패턴 준수
간단한 설정	.gitlab-ci.yml에 하나의 작업과 마스크된 CI/CD 변수만 추가
엔터프라이즈 지원	Claude API, AWS Bedrock, Google Vertex AI 지원
기본 보안	브랜치 보호 및 승인과 함께 GitLab 러너에서 실행

작동 방식

작동 흐름

1. 이벤트 기반 오케스트레이션
   → GitLab이 트리거 감지 (예: 이슈/MR에서 @claude 멘션)
   → 컨텍스트 수집
   → Claude Code 실행

2. 제공자 추상화
   → Claude API (SaaS) 선택
   → AWS Bedrock (IAM 기반) 선택
   → Google Vertex AI (GCP 네이티브) 선택

3. 샌드박스 실행
   → 변경사항이 MR을 통해 흐름
   → 병합 전 검토

빠른 설정

1단계: 마스크된 CI/CD 변수 추가

Settings → CI/CD → Variables로 이동
ANTHROPIC_API_KEY 추가 (마스크됨, 필요시 보호됨)

2단계: .gitlab-ci.yml에 Claude 작업 추가

stages:
  - ai

claude:
  stage: ai
  image: node:24-alpine3.21
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  variables:
    GIT_STRATEGY: fetch
  before_script:
    - apk update
    - apk add --no-cache git curl bash
    - npm install -g @anthropic-ai/claude-code
  script:
    - /bin/gitlab-mcp-server || true
    - echo "$AI_FLOW_INPUT for $AI_FLOW_CONTEXT on $AI_FLOW_EVENT"
    - >
      claude
      -p "${AI_FLOW_INPUT:-'Review this MR and implement the requested changes'}"
      --permission-mode acceptEdits
      --allowedTools "Bash(*) Read(*) Edit(*) Write(*) mcp__gitlab"
      --debug

수동 설정 (프로덕션 권장)

1단계: 제공자 접근 구성

제공자	구성 방법
Claude API	`ANTHROPIC_API_KEY` 저장
AWS Bedrock	GitLab OIDC 및 IAM 역할 구성
Google Vertex AI	Workload Identity Federation 구성

2단계: 프로젝트 자격 증명 추가

기본적으로 CI_JOB_TOKEN 사용
또는 api 범위가 있는 Project Access Token 생성
PAT 사용 시 GITLAB_ACCESS_TOKEN으로 저장

3단계: .gitlab-ci.yml에 Claude 작업 추가

4단계 (선택): 멘션 기반 트리거 활성화

"Comments (notes)"에 대한 웹훅 추가
댓글에 @claude가 포함될 때 AI_FLOW_INPUT 같은 변수로 파이프라인 트리거

사용 예시

이슈를 MR로 변환

@claude 이슈 설명을 기반으로 이 기능을 구현해

Claude가 이슈와 코드베이스를 분석하고, 변경사항을 작성하고, 검토를 위해 MR을 연다.

구현 도움 받기

@claude 이 API 호출 결과를 캐시하는 구체적인 방법을 제안해

빠른 버그 수정

@claude 사용자 대시보드 컴포넌트의 TypeError를 수정해

실전 팁
@claude에게 요청할 때는 가능한 구체적으로 작성하자. "이 기능을 개선해" 대신 "이 함수에 에러 핸들링을 추가하고 단위 테스트를 작성해"처럼 명확하게 요청하면 더 좋은 결과를 얻을 수 있다.

AWS Bedrock 구성

사전 요구사항

Claude 모델 접근이 가능한 Amazon Bedrock 활성화
AWS IAM에서 GitLab OIDC 구성
Bedrock 권한이 있는 IAM 역할

필수 CI/CD 변수

변수	설명
`AWS_ROLE_TO_ASSUME`	Bedrock 접근을 위한 역할 ARN
`AWS_REGION`	Bedrock 리전 (예: us-west-2)

작업 구성

claude-bedrock:
  stage: ai
  image: node:24-alpine3.21
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
  before_script:
    - apk add --no-cache bash curl jq git python3 py3-pip
    - pip install --no-cache-dir awscli
    - npm install -g @anthropic-ai/claude-code
    - export AWS_WEB_IDENTITY_TOKEN_FILE="${CI_JOB_JWT_FILE:-/tmp/oidc_token}"
    - if [ -n "${CI_JOB_JWT_V2}" ]; then printf "%s" "$CI_JOB_JWT_V2" > "$AWS_WEB_IDENTITY_TOKEN_FILE"; fi
    - >
      aws sts assume-role-with-web-identity
      --role-arn "$AWS_ROLE_TO_ASSUME"
      --role-session-name "gitlab-claude-$(date +%s)"
      --web-identity-token "file://$AWS_WEB_IDENTITY_TOKEN_FILE"
      --duration-seconds 3600 > /tmp/aws_creds.json
    - export AWS_ACCESS_KEY_ID="$(jq -r .Credentials.AccessKeyId /tmp/aws_creds.json)"
    - export AWS_SECRET_ACCESS_KEY="$(jq -r .Credentials.SecretAccessKey /tmp/aws_creds.json)"
    - export AWS_SESSION_TOKEN="$(jq -r .Credentials.SessionToken /tmp/aws_creds.json)"
  script:
    - /bin/gitlab-mcp-server || true
    - >
      claude
      -p "${AI_FLOW_INPUT:-'Implement the requested changes and open an MR'}"
      --permission-mode acceptEdits
      --allowedTools "Bash(*) Read(*) Edit(*) Write(*) mcp__gitlab"
      --debug
  variables:
    AWS_REGION: "us-west-2"

Google Vertex AI 구성

사전 요구사항

Vertex AI API 활성화
GitLab OIDC용 Workload Identity Federation 구성
Vertex AI 권한이 있는 서비스 계정

필수 CI/CD 변수

변수	설명
`GCP_WORKLOAD_IDENTITY_PROVIDER`	전체 제공자 리소스 이름
`GCP_SERVICE_ACCOUNT`	서비스 계정 이메일
`CLOUD_ML_REGION`	Vertex 리전 (예: us-east5)

작업 구성

claude-vertex:
  stage: ai
  image: gcr.io/google.com/cloudsdktool/google-cloud-cli:slim
  rules:
    - if: '$CI_PIPELINE_SOURCE == "web"'
  before_script:
    - apt-get update && apt-get install -y git nodejs npm && apt-get clean
    - npm install -g @anthropic-ai/claude-code
    - gcloud auth login --cred-file=<(cat <<EOF
      {
        "type": "external_account",
        "audience": "${GCP_WORKLOAD_IDENTITY_PROVIDER}",
        "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
        "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/${GCP_SERVICE_ACCOUNT}:generateAccessToken",
        "token_url": "https://sts.googleapis.com/v1/token"
      }
      EOF
      )
  script:
    - /bin/gitlab-mcp-server || true
    - >
      CLOUD_ML_REGION="${CLOUD_ML_REGION:-us-east5}"
      claude
      -p "${AI_FLOW_INPUT:-'Review and update code as requested'}"
      --permission-mode acceptEdits
      --allowedTools "Bash(*) Read(*) Edit(*) Write(*) mcp__gitlab"
      --debug
  variables:
    CLOUD_ML_REGION: "us-east5"

모범 사례

CLAUDE.md 구성

저장소 루트에 CLAUDE.md 파일을 생성하여 정의:

코딩 표준
리뷰 기준
프로젝트별 규칙

Claude는 이 파일을 읽고 규칙을 따른다.

보안 고려사항

사항	권장사항
API 키 커밋 금지	GitLab CI/CD 변수 사용 (마스크됨)
OIDC 사용	가능한 경우 제공자별 OIDC 사용 (장기 키 없음)
권한 제한	작업 권한 및 네트워크 이그레스 제한
MR 검토	Claude의 MR을 다른 기여자처럼 검토

성능 최적화

최적화	설명
CLAUDE.md	집중적이고 간결하게 유지
명확한 설명	반복 줄이기 위해 명확한 이슈/MR 설명 제공
타임아웃	합리적인 작업 타임아웃 구성
캐시	러너에서 npm 및 패키지 설치 캐시

CI 비용 인식

비용 유형	설명
GitLab Runner 시간	컴퓨팅 분 소비
API 비용	토큰 사용량은 작업 복잡성과 코드베이스 크기에 따라 다름

비용 최적화:

특정 명령 사용
적절한 max_turns 설정
동시성 제한

문제 해결

Claude가 @claude 명령에 응답하지 않음

확인 사항	해결 방법
파이프라인 트리거	트리거되고 있는지 확인
CI/CD 변수	존재하고 마스크 해제되어 있는지 확인
멘션 형식	/claude가 아닌 @claude 포함 확인
멘션 트리거	구성되어 있는지 확인

작업이 댓글을 작성하거나 MR을 열 수 없음

확인 사항	해결 방법
CI_JOB_TOKEN 권한	충분한 권한이 있는지 확인
PAT	필요시 api 범위가 있는 Project Access Token 사용
mcp__gitlab 도구	--allowedTools에서 활성화 확인
MR 컨텍스트	작업이 충분한 컨텍스트로 MR 컨텍스트에서 실행 확인

인증 오류

제공자	확인 사항
Claude API	ANTHROPIC_API_KEY가 유효하고 만료되지 않았는지 확인
Bedrock/Vertex	OIDC/WIF 구성, 역할 가장, 리전 및 모델 가용성 확인

고급 구성

일반적인 파라미터 및 변수

파라미터	설명
`prompt` / `prompt_file`	인라인 또는 파일 기반 지침
`max_turns`	반복 제한
`timeout_minutes`	실행 시간 제한
`ANTHROPIC_API_KEY`	Claude API에 필수
`AWS_REGION`	Bedrock용
`CLOUD_ML_REGION`	Vertex AI용

지원되는 모든 옵션은 claude --help 실행.

Claude 동작 커스터마이징

CLAUDE.md: 코딩 표준, 보안 요구사항, 규칙 정의
커스텀 프롬프트: 작업의 prompt/prompt_file을 통해 작업별 지침 전달

GitHub Actions vs GitLab CI/CD 비교

기능	GitHub Actions	GitLab CI/CD
트리거	@claude 멘션	@claude 멘션
PR/MR 생성	지원	지원
제공자 지원	Claude API, Bedrock, Vertex	Claude API, Bedrock, Vertex
상태	GA (v1.0)	베타
유지보수	Anthropic	GitLab

참고
Claude Code GitLab CI/CD는 베타 상태다. 기능과 기능성이 발전할 수 있다. 지원은 GitLab 이슈를 참조하자.

8. Claude Code in Slack

원문 : https://code.claude.com/docs/en/slack

Claude Code와 Slack 연동
Claude Code in Slack은 Claude Code의 기능을 Slack 워크스페이스에서 직접 사용할 수 있게 해준다. 코딩 작업과 함께 @Claude를 멘션하면, Claude가 자동으로 의도를 감지하고 웹에서 Claude Code 세션을 생성하여 팀 대화를 떠나지 않고도 개발 작업을 위임할 수 있다.

사용 사례

사례	설명
버그 조사 및 수정	Slack 채널에 버그가 보고되면 즉시 Claude에게 조사 및 수정 요청
빠른 코드 리뷰 및 수정	팀 피드백을 기반으로 작은 기능 구현이나 리팩토링 요청
협업 디버깅	팀 토론의 맥락을 활용하여 Claude가 디버깅 접근 방식 결정
병렬 작업 실행	Slack에서 코딩 작업을 시작하고 다른 일을 진행, 완료 시 알림 수신

사전 요구사항

전제 조건:

Claude 플랜: Pro, Max, Team, 또는 Enterprise (Claude Code 접근 포함 프리미엄 시트)
웹 Claude Code 접근: Claude Code on the web 활성화 필요
GitHub 계정: Claude Code 웹에 연결되고 최소 1개 저장소 인증됨
Slack 인증: Claude 앱을 통해 Slack 계정과 Claude 계정 연결

주의: 무료 플랜에서는 Slack 연동이 불가능하다. Pro, Max, Team, 또는 Enterprise 플랜이 필요하다.

설정 방법

1단계: Slack에 Claude 앱 설치

워크스페이스 관리자가 Slack App Marketplace에서 Claude 앱을 설치해야 한다.

Slack App Marketplace 방문
"Add to Slack" 클릭하여 설치 시작

참고: 워크스페이스 관리자 권한이 필요하다. 개인 사용자는 관리자에게 설치를 요청해야 한다.

2단계: Claude 계정 연결

앱 설치 후, 개인 Claude 계정을 인증한다.

Slack의 Apps 섹션에서 "Claude" 클릭하여 Claude 앱 열기
App Home 탭으로 이동
"Connect" 클릭하여 Slack 계정과 Claude 계정 연결
브라우저에서 인증 플로우 완료

3단계: 웹에서 Claude Code 설정

웹의 Claude Code가 올바르게 설정되어 있는지 확인한다.

claude.ai/code 방문하고 Slack에 연결한 동일 계정으로 로그인
GitHub 계정이 연결되어 있지 않다면 연결
Claude가 작업할 저장소 최소 1개 인증

4단계: 라우팅 모드 선택

계정 연결 후, Slack에서 Claude가 메시지를 처리하는 방식을 설정한다. Slack의 Claude App Home에서 Routing Mode 설정을 찾는다.

모드	동작
Code only	모든 @멘션을 Claude Code 세션으로 라우팅. 개발 작업에만 Claude를 사용하는 팀에 적합
Code + Chat	각 메시지를 분석하여 Claude Code(코딩 작업)와 Claude Chat(작성, 분석, 일반 질문) 사이에서 지능적으로 라우팅

팁: Code + Chat 모드에서 Claude가 Chat으로 라우팅했지만 코딩 세션을 원했다면, "Retry as Code"를 클릭하여 Claude Code 세션으로 재시도할 수 있다.

작동 방식

자동 감지

Slack 채널이나 스레드에서 @Claude를 멘션하면, Claude가 자동으로 메시지를 분석하여 코딩 작업인지 판단한다. 코딩 의도가 감지되면, 일반 채팅 어시스턴트 대신 웹의 Claude Code로 요청을 라우팅한다.

중요: Claude Code in Slack은 채널(공개 또는 비공개)에서만 작동한다. DM(다이렉트 메시지)에서는 작동하지 않는다.

컨텍스트 수집

┌─────────────────────────────────────────────────────────────┐
│                    Slack 채널/스레드                          │
├─────────────────────────────────────────────────────────────┤
│ 사용자1: 로그인 버그 발견했어요                                │
│ 사용자2: auth.js 파일 문제인 것 같은데                        │
│ 사용자3: @Claude 이 버그 수정해줘                             │
│                          ↓                                   │
│         Claude가 스레드 전체 컨텍스트 수집                     │
│                          ↓                                   │
│              Claude Code 세션 생성                           │
└─────────────────────────────────────────────────────────────┘

컨텍스트 소스	동작
스레드에서	스레드의 모든 메시지에서 컨텍스트를 수집하여 전체 대화 이해
채널에서	채널에서 직접 멘션되면 관련 컨텍스트를 위해 최근 채널 메시지 확인

보안 주의: @Claude가 Slack에서 호출되면, Claude는 요청을 더 잘 이해하기 위해 대화 컨텍스트에 접근한다. Claude는 컨텍스트의 다른 메시지 지시를 따를 수 있으므로, 신뢰할 수 있는 Slack 대화에서만 Claude를 사용해야 한다.

세션 플로우

1. 시작 → @Claude 멘션과 함께 코딩 요청
          ↓
2. 감지 → Claude가 메시지 분석 및 코딩 의도 감지
          ↓
3. 세션 생성 → claude.ai/code에 새 Claude Code 세션 생성
          ↓
4. 진행 업데이트 → 작업 진행에 따라 Slack 스레드에 상태 업데이트 게시
          ↓
5. 완료 → 완료 시 요약과 액션 버튼과 함께 @멘션
          ↓
6. 리뷰 → "View Session"으로 전체 트랜스크립트 확인
          또는 "Create PR"로 풀 리퀘스트 생성

ex) 스레드에서 @claude를 통해 소스 리뷰하는 예시

사용자 인터페이스 요소

메시지 액션

버튼	기능
View Session	브라우저에서 전체 Claude Code 세션 열기. 수행된 모든 작업 확인, 세션 계속, 추가 요청 가능
Create PR	세션의 변경 사항에서 직접 풀 리퀘스트 생성
Retry as Code	Claude가 초기에 채팅으로 응답했지만 코딩 세션을 원했다면 이 버튼으로 재시도
Change Repo	Claude가 잘못 선택한 경우 다른 저장소 선택

접근 권한 및 권한

사용자 수준 접근

접근 유형	요구사항
Claude Code 세션	각 사용자가 자신의 Claude 계정으로 세션 실행
사용량 및 요청 한도	세션은 개별 사용자의 플랜 한도에서 차감
저장소 접근	사용자는 자신이 직접 연결한 저장소에만 접근 가능
세션 기록	세션은 claude.ai/code의 Claude Code 기록에 표시

모범 사례

효과적인 요청 작성

원칙	설명
구체적으로	관련된 파일명, 함수명, 에러 메시지 포함
컨텍스트 제공	대화에서 명확하지 않다면 저장소나 프로젝트 언급
성공 정의	"완료"의 의미 설명—테스트 작성? 문서 업데이트? PR 생성?
스레드 사용	버그나 기능 논의 시 스레드에서 답글하여 Claude가 전체 컨텍스트 수집 가능

실전 팁: 좋은 요청 예시

나쁜 예: "버그 고쳐줘"

좋은 예: "@Claude auth.js의 login 함수에서 'undefined is not a function' 에러가 발생해. 사용자가 빈 이메일로 로그인 시도할 때 나타나는데, 유효성 검사 로직 추가하고 테스트도 작성해줘"

Slack vs 웹 사용 시점

상황	권장
Slack 토론에 이미 컨텍스트가 있음	Slack 사용
비동기적으로 작업 시작	Slack 사용
팀원에게 가시성 필요	Slack 사용
파일 업로드 필요	웹 직접 사용
개발 중 실시간 상호작용 필요	웹 직접 사용
더 길고 복잡한 작업	웹 직접 사용

문제 해결

세션이 시작되지 않음

Claude App Home에서 Claude 계정이 연결되어 있는지 확인
웹에서 Claude Code 접근이 활성화되어 있는지 확인
Claude Code에 최소 1개의 GitHub 저장소가 연결되어 있는지 확인

저장소가 표시되지 않음

claude.ai/code에서 웹의 Claude Code에 저장소 연결
해당 저장소에 대한 GitHub 권한 확인
GitHub 계정을 연결 해제했다가 다시 연결 시도

잘못된 저장소가 선택됨

"Change Repo" 버튼을 클릭하여 다른 저장소 선택
더 정확한 선택을 위해 요청에 저장소 이름 포함

현재 제한사항

제한	설명
GitHub만 지원	현재 GitHub의 저장소만 지원
한 번에 하나의 PR	각 세션에서 하나의 풀 리퀘스트만 생성 가능
요청 한도 적용	세션은 개인 Claude 플랜의 요청 한도 사용
웹 접근 필수	웹에서 Claude Code 접근 권한 필요

요약

항목	내용
기능	Slack에서 직접 Claude Code 세션 실행
필수 조건	Pro/Max/Team/Enterprise 플랜, GitHub 연결
사용 방법	채널에서 @Claude 멘션 + 코딩 작업 설명
라우팅 모드	Code only, Code + Chat
제한	GitHub만 지원, 채널만 지원 (DM 불가)

참고 자료

웹에서 Claude Code 사용하기 - 웹 인터페이스 가이드
Claude for Slack - Slack 연동 공식 문서
Slack App Marketplace - Claude 앱 설치
Claude 도움말 센터 - 일반 지원

저작자표시 비영리 변경금지 (새창열림)

'AI > Claude Code Doc(공식문서) 번역본' 카테고리의 다른 글

Claude Code 공식문서 리뷰-Build with Claude Code[3] : Discover and install prebuilt plugins through marketplaces(마켓플레이스를 통해 미리 제작된 플러그인을 찾아 설치하세요.) (2)	2025.12.28
Claude Code 공식문서 리뷰-Build with Claude Code[2] : Create plugins (0)	2025.12.28
Claude Code 공식문서 리뷰-Build with Claude Code[1] : Subagents (1)	2025.12.28
Claude Code 공식문서 리뷰 - Outside of the terminal[1] : Claude Code on the web, Claude Code on desktop, Chrome extension (0)	2025.12.26
Claude Code 공식문서 리뷰 - Claude Code 개요, Cladue Code 빠르게 시작하기, 일반적인 워크 플로우 (2)	2025.12.26

Contents