# API key கணக்குகள்

> ccam add --api, Anthropic API அல்லது gateway-க்கு API key கணக்கைச் சேர்க்கும்; key தொடக்கத்தில் variable அல்லது கட்டளையிலிருந்து படிக்கப்படும், சேமிப்பதில்லை.

Source: https://ccam.dev/ta/features/api/ · Updated 2026-10-20

ஒரு API key கணக்கு, Claude subscription உள்நுழைவுக்குப் பதிலாக API key மூலம் Claude Code-ஐத் தொடங்குகிறது: Anthropic-இன் API, அல்லது அதே Messages வடிவத்தைப் பேசும் endpoint, உதாரணமாக LiteLLM அல்லது OpenRouter gateway. ccam key-ஐச் சேமிப்பதில்லை. கணக்கு தொடங்கும் ஒவ்வொரு முறையும், ஒரு environment variable-இலிருந்தோ password manager போன்ற கட்டளையிலிருந்தோ அதைப் படித்து, அந்த Claude Code process-க்கு மட்டுமே கொடுக்கிறது.

## பயன்பாடு

```sh
ccam add api --api --key-from env:ANTHROPIC_KEY_WORK
ccam add gw --api --base-url https://llm.example.com --auth bearer \
  --model claude-sonnet-5-5 --key-from 'command:pass show llm/gateway-key'
ccam add mac --api --key-from 'command:security find-generic-password -s anthropic-api -w'
ccam gw -p "summarise the open issues"
ccam list
```

```console
$ ccam list
   #  Name      Shortcut  Email                    Shared               Last used
*  1  personal  -         me@example.com           mcp settings md ext  2h ago
   2  gw        -         (API: llm.example.com)   mcp settings md ext  -
```

API key கணக்கு மற்ற எந்தக் கணக்கையும் போலவே அமைப்புகள், `CLAUDE.md`, extensions, MCP சர்வர்களைப் பகிர்கிறது, குறுக்குவழிகள், `ccam folder`, `ccam ext` ஆகியவற்றுடன் வேலை செய்கிறது.

## Options

| Option | என்ன செய்யும் | இயல்புநிலை |
| --- | --- | --- |
| `--api` | உள்நுழைவதற்குப் பதிலாக API key கணக்கைச் சேர்க்கும் | off |
| `--key-from env:NAME` | environment variable `NAME`-இலிருந்து key-ஐப் படிக்கும் | |
| `--key-from command:COMMAND` | `COMMAND`-ஐ இயக்கி (`sh -c` மூலம், அல்லது Windows-இல் `cmd /C` மூலம்) அது அச்சிடும் முதல் வரியைப் பயன்படுத்தும் | |
| `--base-url <url>` | endpoint (`ANTHROPIC_BASE_URL`) | Anthropic-இன் API |
| `--auth api-key\|bearer` | key-ஐ `ANTHROPIC_API_KEY` (`x-api-key`) ஆக அல்லது `ANTHROPIC_AUTH_TOKEN` (`Authorization: Bearer`, gateways பொதுவாக இதைக் கேட்கும்) ஆக அனுப்பும் | `api-key` |
| `--model <model>` | model (`ANTHROPIC_MODEL`) | Claude Code-இன் இயல்புநிலை |

அமைப்புகள் `config.toml`-இல் சேமிக்கப்படுகின்றன:

```toml
[[profile]]
name = 'gw'
slot = 2

[profile.api]
base_url = 'https://llm.example.com'
key_from = 'command:pass show llm/gateway-key'
auth = 'bearer'
model = 'claude-sonnet-5-5'
```

## இது எப்படி வேலை செய்கிறது

கணக்கின் ஒவ்வொரு தொடக்கத்திலும், வழக்கமான சரிபார்ப்புகளுக்குப் பிறகு, Claude Code தொடங்கும் முன்:

1. ccam key-ஐப் படிக்கிறது: `env:` environment-இலிருந்து, `command:` கட்டளையை 30 வினாடி வரம்புடன் இயக்கி. கட்டளை terminal-இல் password கேட்கலாம்; அதன் error output-உம் terminal-க்குச் செல்லும். காலியான key தொடக்கத்தை நிறுத்தும், key எங்கே எதிர்பார்க்கப்பட்டது என்று செய்தி சொல்லும்.
2. Claude Code எப்படி உள்நுழைகிறது அல்லது எந்த provider-ஐப் பயன்படுத்துகிறது என்பதைத் தீர்மானிக்கும், மரபுரிமையாகப் பெற்ற ஒவ்வொரு variable-ஐயும் அது நீக்குகிறது: `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_MODEL`, `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`. உங்கள் shell-இல் வேறொன்றுக்காக அமைத்த key இந்தக் கணக்கை அடைய முடியாது, subscription உள்நுழைவு அதன் key-ஐ மீற முடியாது.
3. கொடுக்கப்பட்டால் `ANTHROPIC_BASE_URL`, `ANTHROPIC_MODEL` ஆகியவற்றை அமைக்கிறது, key-ஐ `ANTHROPIC_API_KEY` அல்லது `ANTHROPIC_AUTH_TOKEN` ஆக அமைக்கிறது.

subscription உள்நுழைவு உள்ள கணக்குகள் முன்பு போலவே மரபுரிமையாகப் பெற்ற environment-ஐ வைத்திருக்கின்றன. interactive அமர்வில், environment-இல் கண்டுபிடிக்கும் key-ஐப் பயன்படுத்தலாமா என்று Claude Code ஒருமுறை கேட்கலாம்.

## பாதுகாப்பும் விளிம்பு நிலைகளும்

- key ஒருபோதும் `config.toml`, cache அல்லது log-இல் எழுதப்படுவதில்லை, `ccam --dry-run gw` அதைப் படிப்பதில்லை: dry run ஒரு `command:` மூலத்தை இயக்காது.
- `ccam add --api` ஒரு `env:` மூலத்தை உடனே சரிபார்த்து, variable காலியாக இருந்தால் எச்சரிக்கிறது; ஒரு `command:` மூலம் முதன்முதலில் தொடக்கத்தில் இயங்குகிறது.
- API key கணக்குக்கு உள்நுழைவு இல்லாததால், `ccam login`, `ccam logout` அதை மறுக்கின்றன. `ccam doctor` அதன் endpoint-ஐயும் key மூலத்தையும் காட்டி, ஒரு `env:` variable காலியாக இருக்கும்போது எச்சரிக்கிறது.
- `ccam usage` அதற்கு `API` எனக் காட்டுகிறது. API key-க்கு ஒப்பிட 5 மணி நேர அல்லது வாராந்திர வரம்பு இல்லாததால், `ccam next --auto`, `--fallback`, `ccam pick` ஆகியவை subscription கணக்குகளிலிருந்து மட்டுமே தேர்ந்தெடுக்கின்றன.
- `env` block அல்லது `apiKeyHelper` உள்ள பகிரப்பட்ட `settings.json`, API key கணக்குகள் உட்படக் குழுவின் ஒவ்வொரு கணக்குக்கும் பொருந்தும். provider அமைப்புகளைப் பகிரப்பட்ட அமைப்புகளுக்கு வெளியே வையுங்கள்.

## தொடர்புடையவை

- [கணக்குகளை நிர்வகித்தல்](https://ccam.dev/ta/features/accounts.md)
- [Claude Code-ஐத் தொடங்குதல்](https://ccam.dev/ta/features/launch.md)
- [கட்டளைக் குறிப்பு](https://ccam.dev/ta/docs/commands.md)