{"name":"apiKeyHelper","slug":"apikeyhelper","family":"setting","title":"Settings keys","noun":"settings key","description":"Generate the [API credential](\/docs\/en\/authentication.md#credential-management) with your own command","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":126,"mined_builds":150,"first_cited":{"version":"2.1.227","released_at":"2026-08-10 20:56:57","spans":4}},"aliases":[],"entries":[{"version":"2.1.304","anchor":"settings-helpers-apikeyhelper-etc-are-not-run-in-pinned-o","heading":"Credential helper commands no longer run in some kinds of Claude Code process","line":"apiKeyHelper, awsAuthRefresh and three other helper settings are skipped in processes pinned to the stored login and in tool-server daemons","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.296","anchor":"cloud-session-availability-message-names-the-credential-in-u","heading":"Cloud sessions message names the key or token whose organization was checked","line":"When cloud sessions are blocked by organization policy, the message now says which API key or token Claude Code checked the policy for","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.288","anchor":"bare-mode-login-now-refuses-with-explanation","heading":"\/login in bare mode explains why it won't sign you in","line":"In bare mode, `\/login` now prints an explanation instead of a sign-in that would have no effect","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"auto-mode-setup-checks-login-before-scanning-with-new-erro","heading":"\/auto-mode-setup checks you are signed in before it scans your environment","line":"`\/auto-mode-setup` now checks your login first and tells you to run `\/login` if it has expired or you are not signed in","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.284","anchor":"detailed-error-when-managed-login-policy-conflicts-with-an-a","heading":"Clearer error when a managed login policy clashes with your API key or token","line":"When managed settings require a specific sign-in but another credential is set, the error names that credential, where it came from, and how to fix it","released_at":"2026-09-28 17:11:59","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"settings-merge-gains-a-credential-helper-filter-that-is-iner","heading":"Settings merge gains a credential-helper filter that is inert in this build","line":"A filter that could strip credential helper settings from settings files is built in but does nothing yet","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"apikeyhelper-case-removed-from-dead-switch-in-op","heading":"apiKeyHelper case removed from dead switch in Op","line":"A dead code path's switch statement dropped an unused apiKeyHelper case","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.274","anchor":"apikeyhelper-failure-now-surfaced-in-statussettings-display","heading":"apiKeyHelper failure now surfaced in status\/settings display","line":"Settings\/status now shows a 'Failing' row with last-run time when your apiKeyHelper command errors","released_at":"2026-09-16 22:36:09","reason":"named in this entry, found in this entry's text"},{"version":"2.1.273","anchor":"auth-type-detection-now-reports-whether-the-api-key-came-fro","heading":"Auth-type detection now reports whether the API key came from an apiKeyHelper","line":"Auth-type detection now reports separately whether the active API key came from an `apiKeyHelper` command","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text, named in this entry"},{"version":"2.1.265","anchor":"gateway-auth-backend-api-key-check-now-short-circuits-to-m","heading":"Gateway auth backend: API key check now short-circuits to 'missing' before touching helper\/env key","line":"Gateway auth now immediately reports an API key as missing instead of checking apiKeyHelper or environment variables first","released_at":"2026-09-08 19:05:16","reason":"found in this entry's text, named in this entry"}],"entries_total":27,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"claude-code","path":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"agent-sdk\/session-storage","title":"Persist sessions to external storage","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"authentication","title":"Authentication","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-apps-gateway","title":"Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry","documented":false},{"source":"claude-code","path":"claude-apps-gateway-config","title":"Claude apps gateway configuration","documented":false},{"source":"claude-code","path":"claude-apps-gateway-deploy","title":"Claude apps gateway deployment and operations","documented":false}],"docs_total":14,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/apikeyhelper","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}