Skip to main content

빠른 답변

Claude Code는 software development용 coding agent입니다. 단순한 chat page가 아닙니다. codebase를 읽고 files를 편집하며 commands를 실행하고 terminal, IDE, desktop app 또는 browser에서 development tasks를 도울 수 있습니다. 기본 workflow는 다음과 같습니다. Claude Code가 project context를 읽고 task를 plan하며 tools를 호출하고 files를 편집한 다음 필요할 때 checks를 실행합니다. multi-file changes, test fixes, code review, scripts 및 더 긴 engineering tasks에 맞게 설계되었습니다. model API는 inference만 처리합니다. local permissions, file access, command execution, hooks 및 MCP tools는 여전히 Claude Code와 project setup이 제어합니다.

이 내용이 필요한 경우

  • Claude Code를 처음 설치함
  • Claude Code가 local repository를 수정하게 하려 함
  • files를 읽거나 많은 tokens를 사용하는 이유를 이해하려 함
  • custom API Key와 Base URL 연결을 계획함
  • Claude Code, Claude Desktop, Cursor 및 Codex CLI 중 선택하려 함

주요 개념

권장 workflow

  1. 실제 project directory에서 Claude Code를 시작하세요.
  2. broad edits 전에 relevant files를 inspect하게 하세요.
  3. complex work에는 implementation 전에 plan을 요청하세요.
  4. 작은 set의 files를 변경하게 한 다음 가장 빠른 relevant check를 실행하세요.
  5. stable project rules는 CLAUDE.md에 두고 one-off instructions는 conversation에 유지하세요.
Claude Code를 API gateway로 연결한다면 endpoint가 Anthropic-compatible인지 확인하세요. 이 문서에서 Claude Code는 https://www.bettertoken.ai을 사용합니다. Claude Code의 Anthropic protocol configuration에서 OpenAI-compatible https://www.bettertoken.ai/v1을 사용하지 마세요.

일반적인 실수

  • Claude Code를 일반 chat page처럼 취급하고 local files를 건드릴 수 있다는 점을 잊음
  • files 또는 project instructions를 읽지 않고 전체 repository를 이해하길 기대함
  • MCP를 model API로 취급함. MCP는 tools를 추가하며 API Key, Base URL, Model ID는 inference를 구성함
  • Claude.ai login, Claude Console API, third-party API gateways를 섞음
  • review, tests 또는 command boundaries 없이 broad local execution을 허용함

BetterToken 정보

Claude Code가 custom API Key와 Base URL을 사용하면 Anthropic-compatible API gateway를 통해 model requests를 보낼 수 있습니다. BetterToken은 그 model API layer에 속하며 API Keys, balance 및 usage history 관리에 도움을 줄 수 있습니다. BetterToken은 Claude Code permissions, file access controls, hooks, MCP config 또는 project rules를 대체하지 않습니다. 이들은 Claude Code workflow의 일부로 남습니다.

관련 문서

참고 자료